diff --git a/security.rst b/security.rst index a8a254ef137..905d14f7d23 100644 --- a/security.rst +++ b/security.rst @@ -462,6 +462,11 @@ you to control *every* part of the authentication process (see the next section) Guard Authenticators ~~~~~~~~~~~~~~~~~~~~ +.. deprecated:: 5.3 + + Guard authenticators are deprecated since Symfony 5.3 in favor of the + :doc:`new authenticator-based system `. + A Guard authenticator is a class that gives you *complete* control over your authentication process. There are many different ways to build an authenticator; here are a few common use-cases: diff --git a/security/auth_providers.rst b/security/auth_providers.rst index 2f9764a77fa..f2a672c41c7 100644 --- a/security/auth_providers.rst +++ b/security/auth_providers.rst @@ -1,9 +1,9 @@ Built-in Authentication Providers ================================= -If you need to add authentication to your app, we recommend using -:doc:`Guard authentication ` because it gives you -full control over the process. +If you need to add authentication to your app, we recommend using the +:doc:`new authenticator-based system ` because +it gives you full control over the process. But, Symfony also offers a number of built-in authentication providers: systems that are easier to implement, but harder to customize. If your authentication diff --git a/security/custom_authentication_provider.rst b/security/custom_authentication_provider.rst index 743fdb9382e..94fdda02708 100644 --- a/security/custom_authentication_provider.rst +++ b/security/custom_authentication_provider.rst @@ -7,10 +7,8 @@ How to Create a custom Authentication Provider .. caution:: Creating a custom authentication system is hard, and almost definitely - **not** needed. Instead, see :doc:`/security/guard_authentication` for a - simple way to create an authentication system you will love. Do **not** - keep reading unless you want to learn the lowest level details of - authentication. + **not** needed. Instead, see the + :doc:`new authenticator-based system ` Symfony provides support for the most :doc:`common authentication mechanisms `. However, your diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst index 67934f61592..8b61ac97558 100644 --- a/security/guard_authentication.rst +++ b/security/guard_authentication.rst @@ -4,6 +4,11 @@ Custom Authentication System with Guard (API Token Example) =========================================================== +.. deprecated:: 5.3 + + Guard authenticators are deprecated since Symfony 5.3 in favor of the + :doc:`new authenticator-based system `. + Guard authentication can be used to: * :doc:`Build a Login Form ` @@ -14,11 +19,6 @@ Guard authentication can be used to: and many more. In this example, we'll build an API token authentication system, so we can learn more about Guard in detail. -.. tip:: - - A :doc:`new authenticator-based system ` - was introduced in Symfony 5.1, which will eventually replace Guards in Symfony 6.0. - Step 1) Prepare your User Class ------------------------------- diff --git a/security/multiple_guard_authenticators.rst b/security/multiple_guard_authenticators.rst index 8c4647c49c6..7e121fcc6cc 100644 --- a/security/multiple_guard_authenticators.rst +++ b/security/multiple_guard_authenticators.rst @@ -1,6 +1,11 @@ How to Use Multiple Guard Authenticators ======================================== +.. deprecated:: 5.3 + + Guard authenticators are deprecated since Symfony 5.3 in favor of the + :doc:`new authenticator-based system `. + The Guard authentication component allows you to use many different authenticators at a time.