Bug 1032767 - Examples of the targetattrfilters ACI keyword need to be documented
Summary: Examples of the targetattrfilters ACI keyword need to be documented
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Directory Server
Classification: Red Hat
Component: Doc-administration-guide
Version: 10.0
Hardware: Unspecified
OS: Unspecified
unspecified
unspecified
Target Milestone: ---
: ---
Assignee: Marc Muehlfeld
QA Contact: Viktor Ashirov
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2013-11-20 19:46 UTC by Nathan Kinder
Modified: 2017-03-14 10:33 UTC (History)
2 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2017-03-14 10:33:25 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)

Description Nathan Kinder 2013-11-20 19:46:33 UTC
The Administration Guide has no examples of usage of the "targetattrfilters" ACI keyword.  We simply mention what it can be used for with a very brief description.  We should add some real examples to show how it is used.  The DS source code has some explanation, but I think development will need to provide more details and examples for the docs:

        /*
         * Check to see if we need to evaluate any targetattrfilters.
         * They look as follows:
         * (targetattrfilters="add=sn:(sn=rob) && gn:(gn!=byrne),
         *                                         del=sn:(sn=rob) && gn:(gn=byrne)")
         *
         * For ADD/DELETE:
         * If theres's a targetattrfilter then each add/del filter
         * that applies to an attribute in the entry, must be satisfied
         * by each value of the attribute in the entry.
         *
         * For MODIFY:
         *      If there's a targetattrfilter then the add/del filter
         * must be satisfied by the attribute to be added/deleted.
         * (MODIFY acl is evaluated one value at a time).
         *
         *
         */

Comment 1 Martin Kosek 2014-05-28 15:14:57 UTC
Note that

https://access.redhat.com/site/documentation/en-US/Red_Hat_Directory_Server/9.0/html/Administration_Guide/Managing_Access_Control-Creating_ACIs_Manually.html#Creating_ACIs_Manually-Defining_Targets

talks about "targattrfilters" and not "targetattrfilters" - this also makes it harder to find...

Comment 2 Deon Ballard 2014-07-10 16:49:00 UTC
Reassigning to Tomas.

Comment 3 Marc Muehlfeld 2017-01-17 13:42:47 UTC
(In reply to Martin Kosek from comment #1)
> https://access.redhat.com/site/documentation/en-US/Red_Hat_Directory_Server/
> 9.0/html/Administration_Guide/Managing_Access_Control-Creating_ACIs_Manually.
> html#Creating_ACIs_Manually-Defining_Targets
> 
> talks about "targattrfilters" and not "targetattrfilters" - this also makes
> it harder to find...

I replaced all occurrences of the incorrect keyword in the Admin Guide (DS-9, 10.1, and master branch).

Comment 9 Marc Muehlfeld 2017-03-14 10:33:25 UTC
The update is now available on the Customer Portal.


Note You need to log in before you can comment on or make changes to this bug.