minor #16202 [Security] Add remember me description when using custom authenticator (gnito-org)

This PR was squashed before being merged into the 5.3 branch.

Discussion
----------

[Security] Add remember me description when using custom authenticator

This PR solves #16149.

<!--

If your pull request fixes a BUG, use the oldest maintained branch that contains
the bug (see https://symfony.com/releases for the list of maintained branches).

If your pull request documents a NEW FEATURE, use the same Symfony branch where
the feature was introduced (and `5.x` for features of unreleased versions).

-->

Commits
-------

7c26128 [Security] Add remember me description when using custom authenticator

Author: javiereguiluz

security/remember_me.rst

@@ -354,3 +354,42 @@ service you created before:
                     ->tokenProvider(DoctrineTokenProvider::class)
             ;
         };
+
+Activating Remember Me When Using a Custom Authenticator
+--------------------------------------------------------
+
+When you use a 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(),
+                ]
+            );
+        }
+    }