Merge branch '5.4' into 6.0

* 5.4:
  [Security] Add remember me description when using custom authenticator

Author: javiereguiluz

security/remember_me.rst

@@ -346,3 +346,43 @@ service you created before:
                     ->tokenProvider(DoctrineTokenProvider::class)
             ;
         };
+
+Activating Remember Me When Using a Custom Authenticator
+--------------------------------------------------------
+
+When you use a :doc:`custom authenticator </security/custom_authenticator>`, you
+must add a ``RememberMeBadge`` to the ``Passport`` for the "Remember Me" function
+to be activated. Without the badge, "Remember Me" will not be active, regardless
+of any other "Remember Me" settings.
+
+For example::
+
+    // src/Service/LoginAuthenticator.php
+    namespace App\Service;
+
+    // ...
+    use Symfony\Component\Security\Http\Authenticator\AbstractAuthenticator;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\CsrfTokenBadge;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\RememberMeBadge;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
+    use Symfony\Component\Security\Http\Authenticator\Passport\Passport;
+    use Symfony\Component\Security\Http\Authenticator\Passport\PassportInterface;
+
+    class LoginAuthenticator extends AbstractAuthenticator
+    {
+        public function authenticate(Request $request): PassportInterface
+        {
+            $password = $request->request->get('password');
+            $username = $request->request->get('username');
+            $csrfToken = $request->request->get('csrf_token');
+
+            return new Passport(
+                new UserBadge($username),
+                new PasswordCredentials($password),
+                [
+                    new CsrfTokenBadge('login', $csrfToken),
+                    new RememberMeBadge(),
+                ]
+            );
+        }
+    }