The Security Component
Warning: You are browsing the documentation for Symfony 4.x, which is no longer maintained.
Read the updated version of this page for Symfony 7.1 (the current stable version).
The Security component provides a complete security system for your web application. It ships with facilities for authenticating using HTTP basic authentication, interactive form login or X.509 certificate login, but also allows you to implement your own authentication strategies. Furthermore, the component provides ways to authorize authenticated users based on their roles.
Installation
1
$ composer require symfony/security
Note
If you install this component outside of a Symfony application, you must
require the vendor/autoload.php
file in your code to enable the class
autoloading mechanism provided by Composer. Read
this article for more details.
The Security component is divided into several smaller sub-components which can be used separately:
symfony/security-core
- It provides all the common security features, from authentication to authorization and from encoding passwords to loading users.
symfony/security-http
- It integrates the core sub-component with the HTTP protocol to handle HTTP requests and responses.
symfony/security-csrf
- It provides protection against CSRF attacks.
symfony/security-guard
- It brings many layers of authentication together, allowing the creation of complex authentication systems.
See also
This article explains how to use the Security features as an independent component in any PHP application. Read the Security article to learn about how to use it in Symfony applications.
Learn More
- Authentication
- Authorization
- The Firewall and Authorization
- Securely Generating Random Values
- Security
- How Does the Security access_control Work?
- How to Customize Access Denied Responses
- How to Use Access Control Lists (ACLs)
- Built-in Authentication Providers
- How to Implement CSRF Protection
- How to Create a custom Authentication Provider
- Using Expressions in Security Access Controls
- How to Restrict Firewalls to a Request
- How to Force HTTPS or HTTP for different URLs
- Using the form_login Authentication Provider
- How to Build a Login Form
- Custom Authentication System with Guard (API Token Example)
- How to Impersonate a User
- How to Build a JSON Authentication Endpoint
- Authenticating against an LDAP server
- How to Use Multiple Guard Authenticators
- How to Use A Different Password Encoder Algorithm Per User
- How to Migrate a Password Hash
- How to Add "Remember Me" Login Functionality
- How to Add a Reset Password Feature
- How to Secure any Service or Method in your Application
- How to Create and Enable Custom User Checkers
- Security User Providers
- How to Use Voters to Check User Permissions
- Security Configuration Reference (SecurityBundle)
- UserPassword