summaryrefslogtreecommitdiff
path: root/docs/zcml/aclauthorizationpolicy.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/zcml/aclauthorizationpolicy.rst')
-rw-r--r--docs/zcml/aclauthorizationpolicy.rst35
1 files changed, 35 insertions, 0 deletions
diff --git a/docs/zcml/aclauthorizationpolicy.rst b/docs/zcml/aclauthorizationpolicy.rst
new file mode 100644
index 000000000..f4df1dce1
--- /dev/null
+++ b/docs/zcml/aclauthorizationpolicy.rst
@@ -0,0 +1,35 @@
+.. _aclauthorizationpolicy_directive:
+
+``aclauthorizationpolicy``
+--------------------------
+
+When this directive is used, authorization information is obtained
+from :term:`ACL` objects attached to model instances.
+
+Attributes
+~~~~~~~~~~
+
+None.
+
+Example
+~~~~~~~
+
+.. code-block:: xml
+ :linenos:
+
+ <aclauthorizationpolicy/>
+
+Alternatives
+~~~~~~~~~~~~
+
+You may create an instance of the
+:class:`repoze.bfg.authorization.ACLAuthorizationPolicy` and pass it
+to the :class:`repoze.bfg.configuration.Configurator` constructor as
+the ``authorization_policy`` argument during initial application
+configuration.
+
+See Also
+~~~~~~~~
+
+See also :ref:`authorization_policies_directives_section` and
+:ref:`security_chapter`.