summaryrefslogtreecommitdiff
path: root/docs/api/security.rst
blob: c7088656ee573cba8bbc5788eedfa6970af44ece (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
.. _security_module:

:mod:`repoze.bfg.security`
==========================

.. automodule:: repoze.bfg.security

  .. autofunction:: authenticated_userid

  .. autofunction:: effective_principals

  .. autofunction:: has_permission

  .. autofunction:: principals_allowed_by_permission

  .. attribute:: Everyone

    The special principal id named 'Everyone'.  This principal id is
    granted to all requests.  Its actual value is the string
    'system.Everyone'.

  .. attribute:: Authenticated

    The special principal id named 'Authenticated'.  This principal id
    is granted to all requests which contain any other non-Everyone
    principal id (according to the security policy).  Its actual value
    is the string 'system.Authenticated'.

  .. attribute:: Allow

    The ACE "action" (the first element in an ACE e.g. ``(Allow, Everyone,
    'read')`` that means allow access.  A sequence of ACEs makes up an
    ACL.  It is a string, and it's actual value is "Allow".

  .. attribute:: Deny

    The ACE "action" (the first element in an ACE e.g. ``(Deny,
    'george', 'read')`` that means deny access.  A sequence of ACEs
    makes up an ACL.  It is a string, and it's actual value is "Deny".

  .. autoclass:: ACLDenied
     :members:

  .. autoclass:: ACLAllowed
     :members:

  .. autoclass:: Denied
     :members:

  .. autoclass:: Allowed
     :members: