[Security] Mention customizing successful and failed authentication

alexandre-daubois · alexandre-daubois · commit ef46ae28d8f1 · 2023-09-26T18:22:58.000+02:00
diff --git a/security.rst b/security.rst
@@ -1602,6 +1602,20 @@ and set the ``limiter`` option to its service ID:
             ;
         };
 
+Customize Successful And Failed Authentication
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you want to customize the success or failure handling process, instead of
+overwriting the respective listeners globally, you can set custom success
+failure handlers by implementing the
+:class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationSuccessHandlerInterface`
+or the
+:class:`Symfony\\Component\\Security\\Http\\Authentication\\AuthenticationFailureHandlerInterface`.
+
+If you want more information about this, you can have a look at the section
+about
+:ref:`customizing your success handler<login-link_customize-success-handler>`.
+
 .. _security-logging-out:
 
 Logging Out
diff --git a/security/login_link.rst b/security/login_link.rst
@@ -693,6 +693,8 @@ from the first hash value and the ``kernel.secret`` container parameter. This
 allows Symfony to sign this final hash, which is contained in the login URL.
 The final hash is also a Base64 encoded SHA-256 hash.
 
+.. _login-link_customize-success-handler:
+
 Customizing the Success Handler
 -------------------------------
 
