From 2c2572321911108930678433225403ebf7e2c667 Mon Sep 17 00:00:00 2001 From: Wouter de Jong Date: Thu, 3 Jun 2021 14:52:56 +0200 Subject: [PATCH] Update documentation for stable authenticator security --- _build/redirection_map | 1 + event_dispatcher.rst | 2 +- security.rst | 6 +++--- ...imental_authenticators.rst => authenticator_manager.rst} | 4 +--- security/guard_authentication.rst | 2 +- 5 files changed, 7 insertions(+), 8 deletions(-) rename security/{experimental_authenticators.rst => authenticator_manager.rst} (99%) diff --git a/_build/redirection_map b/_build/redirection_map index 1069505a81a..9f9a4fd54f7 100644 --- a/_build/redirection_map +++ b/_build/redirection_map @@ -515,3 +515,4 @@ /frontend/encore/shared-entry /frontend/encore/split-chunks /testing/functional_tests_assertions /testing#testing-application-assertions /security/named_encoders /security/named_hashers +/security/experimental_authenticators /security/authenticator_manager diff --git a/event_dispatcher.rst b/event_dispatcher.rst index be7fe590e79..794a09bb83b 100644 --- a/event_dispatcher.rst +++ b/event_dispatcher.rst @@ -335,7 +335,7 @@ or can get everything which partial matches the event name: The ability to match partial event names was introduced in Symfony 5.3. -The :doc:`new experimental Security ` +The :doc:`new authenticator-based Security ` system adds an event dispatcher per firewall. Use the ``--dispatcher`` option to get the registered listeners for a particular event dispatcher: diff --git a/security.rst b/security.rst index 466dfa7aacd..a12c4ad86e0 100644 --- a/security.rst +++ b/security.rst @@ -40,7 +40,7 @@ install the security feature before using it: .. tip:: - A :doc:`new experimental Security ` + A :doc:`new authenticator-based Security ` was introduced in Symfony 5.1, which will eventually replace security in Symfony 6.0. This system is almost fully backwards compatible with the current Symfony security, add this line to your security configuration to start @@ -478,7 +478,7 @@ Limiting Login Attempts Login throttling was introduced in Symfony 5.2. Symfony provides basic protection against `brute force login attacks`_ if -you're using the :doc:`experimental authenticators `. +you're using the :doc:`authenticator-based authenticators `. You must enable this using the ``login_throttling`` setting: .. configuration-block:: @@ -1501,7 +1501,7 @@ Authentication (Identifying/Logging in the User) .. toctree:: :maxdepth: 1 - security/experimental_authenticators + security/authenticator_manager security/form_login_setup security/reset_password security/json_login_setup diff --git a/security/experimental_authenticators.rst b/security/authenticator_manager.rst similarity index 99% rename from security/experimental_authenticators.rst rename to security/authenticator_manager.rst index 10788ecd88e..58b1a2baf5d 100644 --- a/security/experimental_authenticators.rst +++ b/security/authenticator_manager.rst @@ -3,9 +3,7 @@ Using the new Authenticator-based Security .. versionadded:: 5.1 - Authenticator-based security was introduced as an - :doc:`experimental feature ` in - Symfony 5.1. + Authenticator-based security was introduced in Symfony 5.1. In Symfony 5.1, a new authentication system was introduced. This system changes the internals of Symfony Security, to make it more extensible diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst index a945cfb89e6..67934f61592 100644 --- a/security/guard_authentication.rst +++ b/security/guard_authentication.rst @@ -16,7 +16,7 @@ system, so we can learn more about Guard in detail. .. tip:: - A :doc:`new experimental authenticator-based system ` + 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