Skip to content

Commit 2cce577

Browse files
committed
Merge branch '6.3' into 6.4
* 6.3: Minor tweaks Adding info about when the firewall needs to encompass all pages
2 parents f607a3c + 6beab65 commit 2cce577

File tree

1 file changed

+10
-1
lines changed

1 file changed

+10
-1
lines changed

security.rst

+10-1
Original file line numberDiff line numberDiff line change
@@ -562,6 +562,8 @@ will be able to authenticate (e.g. login form, API token, etc).
562562
Only one firewall is active on each request: Symfony uses the ``pattern`` key
563563
to find the first match (you can also
564564
:doc:`match by host or other things </security/firewall_restriction>`).
565+
Here, all real URLs are handled by the ``main`` firewall (no ``pattern`` key means
566+
it matches *all* URLs).
565567

566568
The ``dev`` firewall is really a fake firewall: it makes sure that you
567569
don't accidentally block Symfony's dev tools - which live under URLs like
@@ -629,7 +631,14 @@ you'll see that you're visiting a page behind the firewall in the toolbar:
629631

630632
Visiting a URL under a firewall doesn't necessarily require you to be authenticated
631633
(e.g. the login form has to be accessible or some parts of your application
632-
are public). You'll learn how to restrict access to URLs, controllers or
634+
are public). On the other hand, all pages that you want to be *aware* of a logged in
635+
user have to be under the same firewall. So if you want to display a *"You are logged in
636+
as ..."* message on every page, they all have to be included in the same firewall.
637+
638+
The same firewall can have many modes of authentication. In other words, it
639+
enables many ways to ask the question *"Who are you?"*.
640+
641+
You'll learn how to restrict access to URLs, controllers or
633642
anything else within your firewall in the :ref:`access control
634643
<security-access-control>` section.
635644

0 commit comments

Comments
 (0)