minor #18033 [Security] Add tip for using new isGrantedForUser() function (natewiebe13)

This PR was merged into the 7.3 branch.

Discussion
----------

[Security] Add tip for using new isGrantedForUser() function

Adds tip for using new `isGrantedForUser()` function from symfony/symfony#48142

Commits
-------

c196b44 Add tip for using new isGrantedForUser() function

Author: javiereguiluz

security.rst

@@ -2596,6 +2596,18 @@ want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` ro
           // ...
       }
 
+.. tip::
+
+    Using ``isGranted()`` checks authorization against the currently logged in user. If you need to check
+    against a user that is not the one logged in or if checking authorization when the user session is not
+    available in a CLI context (example: message queue, cronjob) ``isGrantedForUser()`` can be used to set the
+    target user explicitly.
+
+    .. versionadded:: 7.3
+
+        The :method:`Symfony\\Bundle\\SecurityBundle\\Security::isGrantedForUser`
+        method was introduced in Symfony 7.3.
+
 If you're using the :ref:`default services.yaml configuration <service-container-services-load-example>`,
 Symfony will automatically pass the ``security.helper`` to your service
 thanks to autowiring and the ``Security`` type-hint.