Download the PHP package dotkernel/dot-rbac without Composer
On this page you can find all versions of the php package dotkernel/dot-rbac. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download dotkernel/dot-rbac
More information about dotkernel/dot-rbac
Files in dotkernel/dot-rbac
Package dot-rbac
Short Description DotKernel RBAC authorization component
License MIT
Homepage https://github.com/dotkernel/dot-rbac
Informations about the package dot-rbac
dot-rbac
Rbac authorization model implements dot-authorization's AuthorizationInterface
. An authorization service is responsible for deciding if the authenticated identity or guest has access to certain parts of the application.
The RBAC model defines roles that can be assigned to users. The authorization is done on a role basis, not user basis as in ACL. Each role can have one or multiple permissions/privileges assigned. When deciding if a user is authorized, the requested permission is checked in all user roles and if at least one role has that permission, access is granted.
Installation
Run the following command in your project root directory
Configuration
Even if the authorization service can be programmatically configured, we recommend using the configuration based approach. We further describe how to configure the module, using configuration file.
First of all, you should enable the module in your application by merging this package's ConfigProvider
with your application's config. This ensures that all dependencies required by this module are registered in the service manager. It also defines default config values for this module.
Create a configuration file in your config/autoload
folder and change the module options as needed.
authorization.global.php
Usage
Whenever you need to check if someone is authorized to take some actions, inject the AuthorizationInterface::class
service into your class, then call the isGranted
method with the correct parameters. There are 2 ways to call the isGranted method.
First Method
Specify which roles you want to check.
Second Method
Do not specify the roles or send an empty array as the second parameter. This will check if the authenticated identity has permission.
Customize the IdentityProvider
Whenever you request an authorization check on the authenticated identity, the identity will be provided to the AuthorizationService
through a registered IdentityProviderInterface
service.
This is because identity is authentication dependent, so the module lets you overwrite this service, depending on your needs. If you want to get the identity from other sources instead of the dot-authentication service, just overwrite the IdentityProviderInterface::class
service in the service manager with your own implementation of this interface.
Custom role providers
Write your own role provider by implementing the RoleProviderInterface
and register it in the RoleProviderPluginManager
. After that, you can use them in the configuration file, as described above.
Creating assertions
Assertions are checked after permission granting, right before returning the authorization result. Assertions can have a last word in deciding if someone is authorized for the requested action. A good assertion example could be an edit permission, but with the restriction that it should be able to edit the item just if the user id
matches the item's owner id
. It is up to you to write the logic inside an assertion.
An assertion has to implement the AssertionInterface
and be registered in the AssertionPluginManager
.
This interface defines the following method
The context variable can be any external data that an assertion needs in order to decide the authorization status. The assertion must return a boolean value, reflecting the assertion pass or failure status.
All versions of dot-rbac with dependencies
laminas/laminas-servicemanager Version ^3.11
dotkernel/dot-authorization Version ^3.4.1
laminas/laminas-stdlib Version ^3.7
laminas/laminas-authentication Version 2.16.0