Security debug console command for Symfony2
This bundle provides commands under the security namespace (security:debug:*) to help debugging your application
security in a simple way, by inspecting Voters, Listeners and (yet to come) ACL., (*1)
IMPORTANT
This bundle fakes credentials and tokens to be able to inspect permissions. This implies a possible security hole in
your application, please be aware of this. I'm not responsible for any issue derived for a misuse or an insecure use of it, (*2)
Caution
The DataCollector feature re issues the request and some events to be able to inspect the results.
If any of your custom voters, listeners, firewal listeners has side effects they will be issued twice, (*3)
Usage
As for any command you should use: app/console from your project root.
Current available commands are:, (*4)
-
app/console security:debug:firewalls to view listeners for a firewall.
-
app/console security:debug:voters to display voters, voters vote and result.
-
app/console security:debug:acl_voters to display voters, voters vote and result when ACL is present.
-
app/console security:debug:acl_object to display ACL results for each mask provided.
Available Commands
-
app/console security:debug:firewalls uri firewall username roles, (*5)
-
uri The exact URI you have in the firewall
-
firewall Firewall name
-
username User to test
-
roles Multiple space separated roles for the user
-
app/console security:debug:voters (this can be faked too, but for the moment a real user is needed), (*6)
-
firewall Secured area of the app
-
username Username to authenticate
-
password Username Password
-
app/console security:debug:acl_voters username object-fqcn id permission-name, (*7)
-
username For which user you need the information
-
object-fqcn The object class for which you are asking (using / instead of \)
-
id Object ID in the DB
-
permission-name The permission map name, e.g. OWNER
-
app/console security:debug:acl_object username object-fqcn mask-binary, (*8)
-
username For which user you need the information
-
object-fqcn The object class for which you are asking (using / instead of \)
-
id Object ID in the DB
-
mask-binary The binary of the mask, e.g. 128 (OWNER)
Sample output
-
app/console security:debug:firewalls here
-
app/console security:debug:voters here
-
app/console security:debug:acl_voters here
-
app/console security:debug:acl_object here
Installation and configuration
Get the bundle
Add to your composer.json, (*9)
{
"require": {
"egulias/security-debug-command-bundle": "0.5.0"
}
}
Use composer to download the new requirement, (*10)
$ php composer.phar update egulias/security-debug-command-bundle
Add SecurityDebugCommandBundle to your application kernel
``` php
<?php, (*11)
// app/AppKernel.php
public function registerBundles()
{
// ...
if (in_array($this->getEnvironment(), array('dev', 'test'))) {
$bundle[] = Egulias\SecurityDebugCommandBundle\EguliasSecurityDebugCommandBundle();
}
// ...
}, (*12)
## Configure the user class
In your `app/config/config.yml` you should add the FQCN that you use:
egulias_security_debug_command:
user_class: Acme\DemoBundle\Entity\User
```, (*13)
Wallogit.com
