How to Use Multiple Guard Authenticators¶
The Guard authentication component allows you to use many different authenticators at a time.
An entry point is a service id (of one of your authenticators) whose
start()
method is called to start the authentication process.
Multiple Authenticators with Separate Entry Points¶
However, there are use cases where you have authenticators that protect different parts of your application. For example, you have a login form that protects the secured area of your application front-end and API end points that are protected with API tokens. As you can only configure one entry point per firewall, the solution is to split the configuration into two separate firewalls:
- YAML
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
# config/packages/security.yaml security: # ... firewalls: api: pattern: ^/api/ guard: authenticators: - App\Security\ApiTokenAuthenticator default: anonymous: lazy guard: authenticators: - App\Security\LoginFormAuthenticator access_control: - { path: '^/login', roles: IS_AUTHENTICATED_ANONYMOUSLY } - { path: '^/api', roles: ROLE_API_USER } - { path: '^/', roles: ROLE_USER }
- XML
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
<!-- config/packages/security.xml --> <?xml version="1.0" encoding="UTF-8"?> <srv:container xmlns="http://symfony.com/schema/dic/security" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:srv="http://symfony.com/schema/dic/services" xsi:schemaLocation="http://symfony.com/schema/dic/services https://symfony.com/schema/dic/services/services-1.0.xsd http://symfony.com/schema/dic/security https://symfony.com/schema/dic/security/security-1.0.xsd"> <config> <!-- ... --> <firewall name="api" pattern="^/api/"> <guard> <authenticator>App\Security\ApiTokenAuthenticator</authenticator> </guard> </firewall> <firewall name="default"> <anonymous lazy="true"/> <guard> <authenticator>App\Security\LoginFormAuthenticator</authenticator> </guard> </firewall> <rule path="^/login" role="IS_AUTHENTICATED_ANONYMOUSLY"/> <rule path="^/api" role="ROLE_API_USER"/> <rule path="^/" role="ROLE_USER"/> </config> </srv:container>
- PHP
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
// config/packages/security.php use App\Security\ApiTokenAuthenticator; use App\Security\LoginFormAuthenticator; $container->loadFromExtension('security', [ // ... 'firewalls' => [ 'api' => [ 'pattern' => '^/api', 'guard' => [ 'authenticators' => [ ApiTokenAuthenticator::class, ], ], ], 'default' => [ 'anonymous' => 'lazy', 'guard' => [ 'authenticators' => [ LoginFormAuthenticator::class, ], ], ], ], 'access_control' => [ ['path' => '^/login', 'roles' => 'IS_AUTHENTICATED_ANONYMOUSLY'], ['path' => '^/api', 'roles' => 'ROLE_API_USER'], ['path' => '^/', 'roles' => 'ROLE_USER'], ], ]);