| 1 |
.. _imap-admin-access-control-combining-rights: |
| 2 |
|
| 3 |
======================= |
| 4 |
Combining Access Rights |
| 5 |
======================= |
| 6 |
|
| 7 |
Access rights can combined to set a typical set of "read", "write" and |
| 8 |
"full control", potentially making it easier for client implementors to |
| 9 |
present their users with an interface to administer the ACLs to their |
| 10 |
mailboxes easily. |
| 11 |
|
| 12 |
.. NOTE:: |
| 13 |
|
| 14 |
:rfc:`4314` defines combinations of rights that should resulted in |
| 15 |
an untagged ``READ-ONLY`` or ``READ-WRITE`` response to a ``SELECT`` |
| 16 |
command, depending on whether the user has flag modification rights |
| 17 |
such as the :ref:`imap-admin-access-control-right-t` for maintaining |
| 18 |
``\Deleted`` flags on messages, and the |
| 19 |
:ref:`imap-admin-access-control-right-w` right for maintaining non- |
| 20 |
system flags on messages. |
| 21 |
|
| 22 |
Cyrus IMAP responds with ``READ-ONLY`` if the mailbox's |
| 23 |
``/vendor/cmu/cyrus-imapd/sharedseen`` annotation is set to ``true`` |
| 24 |
and the user selecting the mailbox is not given the |
| 25 |
:ref:`imap-admin-access-control-right-e`, |
| 26 |
:ref:`imap-admin-access-control-right-i`, |
| 27 |
:ref:`imap-admin-access-control-right-n`, |
| 28 |
:ref:`imap-admin-access-control-right-t` or |
| 29 |
:ref:`imap-admin-access-control-right-w` right. |
| 30 |
|
| 31 |
lrs |
| 32 |
=== |
| 33 |
|
| 34 |
The set of rights often referred to as "read-only". The ACI subject is |
| 35 |
allowed to lookup the folder, read its contents and maintain ``\Seen`` |
| 36 |
flags on messages. Meanwhile, the ``\Recent`` flags are maintained for |
| 37 |
the ACI subject as well. |
| 38 |
|
| 39 |
lirstw |
| 40 |
====== |
| 41 |
|
| 42 |
The set of rights that could arguably be referred to "semi-full". |
| 43 |
|
| 44 |
The ACI subject is allowed to lookup the folder, read its contents and |
| 45 |
maintain flags on messages, as well as insert new messages in to the |
| 46 |
folder, and flag messages as ``\Deleted``, but not expunge the folder's |
| 47 |
contents. |
| 48 |
|
| 49 |
Allowing ACI subjects to flag messages as ``\Deleted`` but not |
| 50 |
delegating the right to ``EXPUNGE`` the folder's contents enables |
| 51 |
messages to quickly be restored by ACI subjects themselves, if the |
| 52 |
client used can be configured to show or hide messages flagged |
| 53 |
``\Deleted``. |
| 54 |
|
| 55 |
.. seealso:: |
| 56 |
|
| 57 |
* :ref:`imap-admin-sop-restoring-expunged-messages` |
| 58 |
|
| 59 |
Please note that the configuration value of |
| 60 |
``/vendor/cmu/cyrus-imapd/sharedseen`` on the folder has no bearing on |
| 61 |
the ``\Deleted`` flag, but only on the ``\Seen`` flag. To be more |
| 62 |
precise, all flags other than ``\Seen`` are global. |
| 63 |
|
| 64 |
ACL "Macros" |
| 65 |
============ |
| 66 |
|
| 67 |
Cyrus administration supports short-hand macros you may use: |
| 68 |
|
| 69 |
none |
| 70 |
---- |
| 71 |
|
| 72 |
Remove any existing ACL for this ACI |
| 73 |
|
| 74 |
read (lrs) |
| 75 |
---------- |
| 76 |
|
| 77 |
Grant the ACI read-only access to the mailbox (*lookup*, *read* and |
| 78 |
*seen*). |
| 79 |
|
| 80 |
post (lrsp) |
| 81 |
----------- |
| 82 |
|
| 83 |
Give the ACI read access to the mailbox, and allow them to post to |
| 84 |
the mailbox using the delivery system (*lookup*, *read*, *seen* and |
| 85 |
*post*). |
| 86 |
|
| 87 |
Most delivery systems do not provide authentication, so the ``p`` |
| 88 |
right usually has meaning only for the "anonymous" user. |
| 89 |
|
| 90 |
append (lrsip) |
| 91 |
-------------- |
| 92 |
|
| 93 |
The ACI can read and append to the mailbox, either through IMAP, or |
| 94 |
through the delivery system. |
| 95 |
|
| 96 |
write (lrswipkxtecd) |
| 97 |
-------------------- |
| 98 |
|
| 99 |
The ACI may do pretty much anything with a mailbox, and folders |
| 100 |
within it. |
| 101 |
|
| 102 |
delete (lrxte) |
| 103 |
-------------- |
| 104 |
|
| 105 |
The ACI may list, read, delete and expunge messages and delete |
| 106 |
folders. |
| 107 |
|
| 108 |
all (lrswipkxtecda) |
| 109 |
------------------- |
| 110 |
|
| 111 |
Same as write, plus admin rights. |
| 112 |
|
| 113 |
Features and Combined Access Rights |
| 114 |
=================================== |
| 115 |
|
| 116 |
For most features, ACI subjects need certain access rights on a folder |
| 117 |
in order to perform or control the feature. |
| 118 |
|
| 119 |
METADATA |
| 120 |
-------- |
| 121 |
|
| 122 |
In order to be allowed to retrieve and/or set annotations on a folder, |
| 123 |
the ACI subject requires the :ref:`imap-admin-access-control-right-l` |
| 124 |
right, and any one of the :ref:`imap-admin-access-control-right-r`, |
| 125 |
:ref:`imap-admin-access-control-right-s`, |
| 126 |
:ref:`imap-admin-access-control-right-w`, |
| 127 |
:ref:`imap-admin-access-control-right-i` or |
| 128 |
:ref:`imap-admin-access-control-right-p` rights. |