2017 © Pedro Pel√°ez
 

library acl

Access Control List (ACL) Solution for Laravel 5.1/Laravel 5.2

image

resultsystems/acl

Access Control List (ACL) Solution for Laravel 5.1/Laravel 5.2

  • Friday, April 27, 2018
  • by emtudo
  • Repository
  • 4 Watchers
  • 11 Stars
  • 185 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 2 Forks
  • 0 Open issues
  • 8 Versions
  • 2 % Grown

The README.md

H√° formas melhores e mais simples de fazer o mesmo, pacote abandonado!

ResultSystems ACL

ACL √© um package ACL para Laravel 5 que utiliza filial, grupos e permiss√Ķes. Este projeto tem como objetivo prover o controle de acesso da sua aplica√ß√£o. Foi desenvolvido pensando em multi-empresa/filiais., (*1)

Instalação

ACL pode ser instalado através do composer. Para que o package seja adicionado automaticamente ao seu arquivo composer.json execute o seguinte comando:, (*2)

composer require resultsystems/acl

ou se preferir, adicione o seguinte trecho manualmente:, (*3)

{
    "require": {
        "resultsystems/acl": "~0.3"
    }
}
composer update

2. Provider

Para usar o ACL em sua aplicação Laravel, é necessário registrar o package no seu arquivo config/app.php. Adicione o seguinte código no fim da seção providers, (*4)

// inicio do arquivo foi omitido
    'providers' => [
        //Outras entradas omitidas
        ResultSystems\Acl\AclServiceProvider::class, //Laravel 5.1 em diante
    ],
// fim do arquivo foi omitido

3. User Class

Na sua classe de usu√°rio, adicione a trait ResultSystems\Acl\Traits\PermissionTrait para disponibilizar os m√©todos para checagem de permiss√Ķes:, (*5)

4. Publicando o arquivo de configuração e as migrations

Para publicar o arquivo de configuração padrão e as migrations que acompanham o package, execute o seguinte comando:, (*6)

php artisan vendor:publish --provider="ResultSystems\Acl\AclServiceProvider"

Execute as migrations, para que sejam criadas as tabelas no banco de dados:, (*7)

php artisan migrate, (*8)

5. Middleware do ACL

Caso você tenha a necessidade de realizar o controle de acesso diretamente nas rotas, o ACL possui um middleware (nativos) que abordam os casos mais comuns. Para utilizá-los é necessário registrá-los no seu arquivo app/Http/Kernel.php., (*9)

Laravel 5.1

protected $routeMiddleware = [
    'auth'            => 'App\Http\Middleware\Authenticate',
    'auth.basic'      => 'Illuminate\Auth\Middleware\AuthenticateWithBasicAuth',
    'guest'           => 'App\Http\Middleware\RedirectIfAuthenticated',

    // Controle de acesso usando permiss√Ķes
    'needsPermission' => \ResultSystems\Acl\Middlewares\NeedsPermissionMiddleware::class,
];

Laravel 5.2


protected $routeMiddleware = [ 'web' => [ \App\Http\Middleware\EncryptCookies::class, \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class, \Illuminate\Session\Middleware\StartSession::class, \Illuminate\View\Middleware\ShareErrorsFromSession::class, \App\Http\Middleware\VerifyCsrfToken::class, // Controle de acesso usando permiss√Ķes para WEB 'needsPermission' => \ResultSystems\Acl\Middlewares\NeedsPermissionMiddleware::class, ], 'api' => [ 'throttle:60,1', // Controle de acesso usando permiss√Ķes para API 'needsPermission' => \ResultSystems\Acl\Middlewares\NeedsPermissionMiddleware::class, ], ];

Usando o ACL

Configure o arquivo config/acl.php, (*10)

A utilização desses middlewares é explicada na próxima seção., (*11)

Como usar nas rotas

Route::post('/users', ['middleware' => ['auth', 'needsPermission'],
    'permission'               => ['user.read', 'user.create'],
    'any'                      => false, //usu√°rio precisar√° ter as duas permiss√Ķes
    /**
     * Caso a configuração em `config/acl.php`
     * middleware->autoload for true,
     * você poderá omitir a informação da owner_id
     */
     'owner_id'                => 'middleware', /*
    function () {
        dd('Tenho permiss√£o');
    }]);
Route::post('/users', ['middleware' => ['auth', 'needsPermission'],
    'permission'               => ['user.read', 'user.create'],
    'any'                      => false, //usu√°rio precisar√° ter as duas permiss√Ķes
    'owner_id'                => 1, // Empresa/filial *
    function () {
        dd('Tenho permiss√£o');
    }]);
Route::get('/users', [
    'middleware' => ['auth', 'needsPermission:user.read|user.create,true,5'],

    function () {
        dd('Tenho permiss√£o');
    }]);

    //needsPermission=middleware
    //user.read=permiss√£o user.read
    //user.create=permiss√£o user.create
    //any=true Usu√°rio pode ter qualquer das permiss√Ķes informadas
    //5=Filial/Empresa

Usando com a middleware com busca autom√°tica

Route::post('/users', ['middleware' => ['auth', 'needsPermission'],
    'permission'               => ['user.read', 'user.create'],
    'any'                      => false, //usu√°rio precisar√° ter as duas permiss√Ķes
    'owner_id'                => 'middleware', //*
    function () {
        dd('Tenho permiss√£o');
    }]);
  • Se n√£o for passado um :id ou 'middleware' e nem estiver configurado para pegar o owner_id via middlware ser√° buscado apenas permiss√Ķes com owner_id nulo

Usar em qualquer lugar com o Auth

Você pode usar em qualquer lugar que o usuário esteja autenticado, usando o Auth., (*12)

Exemplos:, (*13)

if (Auth::user()->hasPermission('user.create')) {
    echo 'tenho permiss√£o';
}

if (Auth::user()->hasPermissions(['user.create', 'user.update'])) {
    echo 'tenho pelo menos uma das permiss√Ķes';
}

if (Auth::user()->hasPermissions(['user.create', 'user.update'], false)) {
    echo 'tenho ambas as permiss√Ķes';
}

if (Auth::user()->hasPermissions(['user.create', 'user.update'], false, 1)) {
    echo 'tenho ambas as permiss√Ķes na filial 1';
}

if (Auth::user()->hasPermissions(['user.create', 'user.update'], true, 1)) {
    echo 'tenho pelo menos uma das permiss√Ķes na filial 1';
}

config/acl.php

return [
    //Informe a tabela de usu√°rio aqui
    'tables' => [
        'user' => 'users',
    ],

    //Informe o model usuado que conecta a tabela de usu√°rio
    'model' => \App\User::class,

    /**
     * Informe a class que negar√° acesso
     * caso usu√°rio n√£o tenha permiss√£o
     * você pode criar uma personalizada,
     * porem precisa estender esta.
     */
    'forbidden_callback' => ResultSystems\Acl\Handlers\ForbiddenHandler::class,
    /**
     * Middleware para pegar a filial automaticamente
     * para você não precisar informar na rota ou no controler
     */
    'middleware' => [
        //Auto carrega o middleware em todas as rotas
        'autoload' => false, //Auto load middleware in all reques

        // Middleware utilizado para compatibilidade com o `Auth` do Laravel
        'owner'   => ResultSystems\Acl\Middlewares\AuthOwnerMiddleware::class,

        // Middleware utilizado para compatibilidade com o `Jwt`
        // mais informa√ß√Ķes https://github.com/tymondesigns/jwt-auth
        //'owner'    => ResultSystems\Acl\Middlewares\JwtOwnerMiddleware::class,

        /**
         * Campo no Auth::user()
         * ou no JWT (Neste caso campo adicional)
         * que representa a filial/owner atual
         */
        'owner_id' => 'owner_id',
    ],
];

The Versions

27/04 2018

dev-master

9999999-dev

Access Control List (ACL) Solution for Laravel 5.1/Laravel 5.2

  Sources   Download

MIT

The Requires

  • php >=5.5.9

 

The Development Requires

by Leandro Henrique Reis

15/05 2016

0.2.1

0.2.1.0

Access Control List (ACL) Solution for Laravel 5.1/Laravel 5.2

  Sources   Download

MIT

The Requires

  • php >=5.5.9

 

The Development Requires

by Leandro Henrique Reis

15/05 2016

0.3.0

0.3.0.0

Access Control List (ACL) Solution for Laravel 5.1/Laravel 5.2

  Sources   Download

MIT

The Requires

  • php >=5.5.9

 

The Development Requires

by Leandro Henrique Reis

26/02 2016

0.2.0

0.2.0.0

Access Control List (ACL) Solution for Laravel 5.1/Laravel 5.2

  Sources   Download

MIT

The Requires

  • php >=5.5.9

 

The Development Requires

by Leandro Henrique Reis

24/02 2016

0.1.1

0.1.1.0

Access Control List (ACL) Solution for Laravel 5.1

  Sources   Download

MIT

The Requires

  • php >=5.5.9

 

The Development Requires

by Leandro Henrique Reis

24/02 2016

0.1.0

0.1.0.0

Access Control List (ACL) Solution for Laravel 5.1

  Sources   Download

MIT

The Requires

  • php >=5.5.9

 

The Development Requires

by Leandro Henrique Reis

24/02 2016

0.0.3

0.0.3.0

Access Control List (ACL) Solution for Laravel 5.1

  Sources   Download

MIT

The Requires

  • php >=5.5.9

 

The Development Requires

by Leandro Henrique Reis

10/02 2016

0.0.21

0.0.21.0

Access Control List (ACL) Solution for Laravel 5.1

  Sources   Download

MIT

The Requires

  • php >=5.5.9

 

The Development Requires

by Leandro Henrique Reis