Caution that roles should start with ROLE_

jrjohnson · jrjohnson · commit 1522de7c4143 · 2014-09-11T23:53:41.000-07:00
In order to save someone else a few hours of frustration make it clear that the ROLE_ preface is not just for show.
diff --git a/cookbook/security/entity_provider.rst b/cookbook/security/entity_provider.rst
@@ -651,6 +651,11 @@ about in this section.
     If you fail to return any roles, it may appear as if your user isn't
     authenticated at all.
 
+.. caution::
+
+    The default role voter requires that all of the roles returned should be prefaced by ROLE_.  
+    Example ROLE_ADMIN, ROLE_USER; not just ADMIN or USER.
+
 In this example, the ``AcmeUserBundle:User`` entity class defines a
 many-to-many relationship with a ``AcmeUserBundle:Role`` entity class.
 A user can be related to several roles and a role can be composed of
