[Security] Dispatch an event when "logout user on change" steps in

Simperfit · Simperfit · commit b18cb1553cd1 · 2019-04-18T20:01:13.000+02:00
diff --git a/components/security/authentication.rst b/components/security/authentication.rst
@@ -283,6 +283,7 @@ security.authentication.success  ``AuthenticationEvents::AUTHENTICATION_SUCCESS`
 security.authentication.failure  ``AuthenticationEvents::AUTHENTICATION_FAILURE``  :class:`Symfony\\Component\\Security\\Core\\Event\\AuthenticationFailureEvent`
 security.interactive_login       ``SecurityEvents::INTERACTIVE_LOGIN``             :class:`Symfony\\Component\\Security\\Http\\Event\\InteractiveLoginEvent`
 security.switch_user             ``SecurityEvents::SWITCH_USER``                   :class:`Symfony\\Component\\Security\\Http\\Event\\SwitchUserEvent`
+security.logout_on_change        ``SecurityEvents::LOGOUT_ON_CHANGE``              :class:`Symfony\\Component\\Security\\Http\\Event\\LogoutOnChangeEvent`
 ===============================  ================================================  ==============================================================================
 
 Authentication Success and Failure Events
@@ -314,6 +315,13 @@ order to give your user a welcome flash message every time they log in.
 The ``security.switch_user`` event is triggered every time you activate
 the ``switch_user`` firewall listener.
 
+The ``security.logout_on_change`` event is triggered when a token has been deauthenticated
+because of a user change, it can help you doing some clean-up task when a logout has been triggered.
+
+.. versionadded:: 4.3
+
+    The ``security.logout_on_change`` event was introduced in Symfony 4.3.
+
 .. seealso::
 
     For more information on switching users, see
