minor #5943 Add tip for when returning null from createToken() (jeroenseegers)

xabbuh · xabbuh · commit 7186d17f08e0 · 2015-12-09T20:33:31.000+01:00
This PR was submitted for the 2.8 branch but it was merged into the 2.7 branch instead (closes #5943). Discussion ---------- Add tip for when returning `null` from `createToken()` | Q | A | ------------- | --- | Doc fix? | yes | New docs? | no | Applies to | all | Fixed tickets | #5264 Commits ------- 1337b31 Add caution when returning null from createToken()
diff --git a/cookbook/security/api_key_authentication.rst b/cookbook/security/api_key_authentication.rst
@@ -109,6 +109,11 @@ will cause authentication to fail. You might want to return ``null`` instead
 to just skip the authentication, so Symfony can fallback to another authentication
 method, if any.
 
+.. caution::
+
+    In case you return ``null`` from your ``createToken()`` method, be sure to enable
+    ``anonymous`` in you firewall. This way you'll be able to get an ``AnonymousToken``.
+
 2. supportsToken
 ~~~~~~~~~~~~~~~~
 
