From: Gavin Henry Date: Mon, 2 Feb 2009 17:58:42 +0000 (+0000) Subject: (ITS#5852) ACL behaviour does not match Admin Guide X-Git-Tag: ACLCHECK_0~899 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=886637a86acbc59c4e868da1f9d1185e380d4995;p=openldap (ITS#5852) ACL behaviour does not match Admin Guide --- diff --git a/doc/guide/admin/access-control.sdf b/doc/guide/admin/access-control.sdf index b43ebc2319..610467e71b 100644 --- a/doc/guide/admin/access-control.sdf +++ b/doc/guide/admin/access-control.sdf @@ -219,7 +219,14 @@ an entry and/or attribute, slapd compares the entry and/or attribute to the {{EX:}} selectors given in the configuration file. For each entry, access controls provided in the database which holds the entry (or the global access directives if not held in any database) apply -first, followed by the global access directives. Within this +first, followed by the global access directives. However, when dealing with +an access list, because the global access list is effectively appended +to each per-database list, if the resulting list is non-empty then the +access list will end with an implicit {{EX:access to * by * none}} directive. +If there are no access directives applicable to a backend, then a default +read is used. + +Within this priority, access directives are examined in the order in which they appear in the config file. Slapd stops with the first {{EX:}} selector that matches the entry and/or attribute. The corresponding @@ -304,9 +311,12 @@ are also under {{EX:dc=com}} entries. Also note that if no {{EX:access to}} directive matches or no {{EX:by }} clause, {{B:access is denied}}. That is, every {{EX:access -to}} directive ends with an implicit {{EX:by * none}} clause and -every access list ends with an implicit {{EX:access to * by * none}} -directive. +to}} directive ends with an implicit {{EX:by * none}} clause. When dealing +with an access list, because the global access list is effectively appended +to each per-database list, if the resulting list is non-empty then the access +list will end with an implicit {{EX:access to * by * none}} directive. If +there are no access directives applicable to a backend, then a default read is +used. The next example again shows the importance of ordering, both of the access directives and the {{EX:by }} clauses. It also @@ -635,7 +645,14 @@ to the {{EX:}} selectors given in the configuration. For each entry, access controls provided in the database which holds the entry (or the global access directives if not held in any database) apply first, followed by the global access directives (which are held in -the {{EX:frontend}} database definition). Within this priority, +the {{EX:frontend}} database definition). However, when dealing with +an access list, because the global access list is effectively appended +to each per-database list, if the resulting list is non-empty then the +access list will end with an implicit {{EX:access to * by * none}} directive. +If there are no access directives applicable to a backend, then a default +read is used. + +Within this priority, access directives are examined in the order in which they appear in the configuration attribute. Slapd stops with the first {{EX:}} selector that matches the entry and/or attribute. The @@ -720,10 +737,11 @@ would never be reached, since all entries under {{EX:dc=example,dc=com}} are also under {{EX:dc=com}} entries. Also note that if no {{EX:olcAccess: to}} directive matches or no {{EX:by -}} clause, {{B:access is denied}}. That is, every {{EX:olcAccess: -to}} directive ends with an implicit {{EX:by * none}} clause and -every access list ends with an implicit {{EX:olcAccess: to * by * none}} -directive. +}} clause, {{B:access is denied}}. When dealing with an access list, +because the global access list is effectively appended to each per-database +list, if the resulting list is non-empty then the access list will end with +an implicit {{EX:access to * by * none}} directive. If there are no access +directives applicable to a backend, then a default read is used. The next example again shows the importance of ordering, both of the access directives and the {{EX:by }} clauses. It also diff --git a/doc/man/man5/slapd.access.5 b/doc/man/man5/slapd.access.5 index e6cb8ae95a..34b2eede26 100644 --- a/doc/man/man5/slapd.access.5 +++ b/doc/man/man5/slapd.access.5 @@ -54,7 +54,15 @@ are then used. If no access controls are present, the default policy allows anyone and everyone to read anything but restricts updates to rootdn. (e.g., "access to * by * read"). -The rootdn can always read and write EVERYTHING! +.LP +When dealing with an access list, because the global access list is +effectively appended to each per-database list, if the resulting +list is non-empty then the access list will end with an implicit +.B access to * by * none +directive. If there are no access directives applicable to a backend, +then a default read is used. +.LP +.B Be warned: the rootdn can always read and write EVERYTHING! .LP For entries not held in any backend (such as a root DSE), the global directives are used.