minor #16369 [Security] Move Passport Attributes to their own section (javiereguiluz)

This PR was merged into the 5.3 branch.

Discussion
----------

[Security] Move Passport Attributes to their own section

I think attributes are important enough to move them to their own section, which also allows them to appear in the page TOC.

Commits
-------

d913e63 [Security] Move Passport Attributes to their own section

Author: javiereguiluz

security/custom_authenticator.rst

@@ -342,39 +342,39 @@ would initialize the passport like this::
         }
     }
 
-.. tip::
+Passport Attributes
+-------------------
 
-    Besides badges, passports can define attributes, which allows the
-    ``authenticate()`` method to store arbitrary information in the
-    passport to access it from other authenticator methods (e.g.
-    ``createAuthenticatedToken()``)::
+.. versionadded:: 5.2
 
-        // ...
-        use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
+    Passport attributes were introduced in Symfony 5.2.
 
-        class LoginAuthenticator extends AbstractAuthenticator
-        {
-            // ...
+Besides badges, passports can define attributes, which allows the ``authenticate()``
+method to store arbitrary information in the passport to access it from other
+authenticator methods (e.g. ``createAuthenticatedToken()``)::
 
-            public function authenticate(Request $request): PassportInterface
-            {
-                // ... process the request
+    // ...
+    use Symfony\Component\Security\Http\Authenticator\Passport\Badge\UserBadge;
+
+    class LoginAuthenticator extends AbstractAuthenticator
+    {
+        // ...
 
-                $passport = new SelfValidatingPassport(new UserBadge($username), []);
+        public function authenticate(Request $request): PassportInterface
+        {
+            // ... process the request
 
-                // set a custom attribute (e.g. scope)
-                $passport->setAttribute('scope', $oauthScope);
+            $passport = new SelfValidatingPassport(new UserBadge($username), []);
 
-                return $passport;
-            }
+            // set a custom attribute (e.g. scope)
+            $passport->setAttribute('scope', $oauthScope);
 
-            public function createAuthenticatedToken(PassportInterface $passport, string $firewallName): TokenInterface
-            {
-                // read the attribute value
-                return new CustomOauthToken($passport->getUser(), $passport->getAttribute('scope'));
-            }
+            return $passport;
         }
 
-.. versionadded:: 5.2
-
-    Passport attributes were introduced in Symfony 5.2.
+        public function createAuthenticatedToken(PassportInterface $passport, string $firewallName): TokenInterface
+        {
+            // read the attribute value
+            return new CustomOauthToken($passport->getUser(), $passport->getAttribute('scope'));
+        }
+    }