Plugin para Implementação de ACL no CakePHP 3

Com a compra do GitHub pela (MS) fiz uma cópia deste repositório no GitLab.

Atenção

Testado com a versão 3.6.13 do CakePHP.

Usuário - senha

• super - super (pode tudo)
• admin - admin (pode tudo mas somente nas tabelas groups, users e permissions)
• manager - manager (pode tudo mas somente nas tabelas de negócio, no caso customers)
• user - user (não pode quase nada, apenas efetuar login e visualizar a index de customers, nada mais)

Idealmente instale em um ambiente de testes para ter maior controle, pois o demos apenas permite selects nas tabelas.

Continuação do cake-control-br

Este projeto basicamente continua de onde parou o cake-control-br. Este começa com a novidade de uma área para demo.

URL deste projeto - https://github.com/ribafs/cake-acl-br/

Este plugin inclue o plugin BootstrapUI e o (Twitter) Bootstrap e também inclui os templates do bake do plugin twbs-cake-plugin aos autores dos quais gostaria de agradecer.

Principais recursos

• Template do bake traduzido para pt_BR
• Menu de topo com o element topmenu
• Busca com paginação
• Senhas criptografadas com Bcrypt
• Controle de Acesso tipo ACL com administração web
• Dois Layouts: admin e default com o Bootstrap
• Utilitários do BootstrapUI plugin

Instalação e uso

https://github.com/ribafs/cake-acl-br

Criar app:

Instalar o CakePHP, por exemplo

composer create-project --prefer-dist cakephp/app acl1

cd /var/www/html/acl1   

Instalar Plugin

cd /var/www/html/acl1
composer require ribafs/cake-acl-br

Configurar banco

Baixe o plugin, crie o banco e importe o script existente na pasta docs do plugin baixado. Depois edite config/app.php para configurar o banco. Configure o app.php para não mostrar as mensagens de deprecated:

'Error' => [

    'errorLevel' => E_ALL & ~E_USER_DEPRECATED,

Aproveite e configure também o controller default em config/routes.php para Users e login.

Habilitar o plugin

bin/cake plugin load CakeAclBr --bootstrap

Download do plugin

https://github.com/ribafs/cake-acl-br/archive/master.zip

Descompactar e abrir o diretório docs, então copiar:

bootstrap_cli.php para a acl1/config (Com isso o Bake gerarará Users com login e logout)

AppController.php para acl1/src/Controller

cd acl1
bin/cake bake all groups -t CakeAclBr
bin/cake bake all users -t CakeAclBr
bin/cake bake all permissions -t CakeAclBr
bin/cake bake all customers -t CakeAclBr

Concedendo permissões

• Comece fazendo login com user e user
• Veja que ele loga mas não tem acesso nem emsmo ao index de customers
• Faça logout
• Faça login com super ou admin
• Dando permissão para o usuário user acessar o controller Customer e action index
• Faça logout
• Faça login como user e veja que agora ele acessa a index do customers. Observe que não aparece o ícone para excluir os registros.
• Tente acessar qualquer outro action: edit, delete ou mesmo view. Observe também que vários outros recursos não aparecem para o 'user', busca, links, etc

Controller default

Em AppController.php você pode definir o controller default para usuários não administradores. Caso não use a tabela customers troque logo no início do AppController por uma de suas tabelas na linha abaixo:

protected $noAdmins = 'Customers';

Algumas imagens/capturas

Login

Logado como super. Veja que o menu mostra todos os recursos

Logado como admin. Veja que apenas groups, users e permissions

Logado como manager. Apenas customers

Logado como user. Apenas o index de customers e isso foi porque foi concedida esta permissão

Busca

Veja a customização do CSS do bootstrap

Veja que em customers o user mostra o username ao invés de id, pois foi customizado o método displayField()

Csutomização dos campos controller e actiion mudando de caixa de texto para combo

Para usar a versão atual (3.6.1) do CakePHP

Após instalar o CakePHP 3.5.13 e instalar e habilitar o plugin cake-acl-br, instale o migrations

composer require --update-with-dependencies "cakephp/cakephp:3.6.*"

Atualize o DebugKit

composer require cakephp/debug_kit

Pronto, agora está com o CakePHP atualizado e o plugin cake-acl-br

Sugestões, colaborações e forks serão muto bem vindos:

• Erros: português
• PHP
• CakePHP
• ControlComponent.php
• Ou algo que queira me avisar...

License

The MIT License (MIT)