Skip to content

Commit d352284

Browse files
committed
Update memberof specific group design doc for new CLI usage
1 parent e071424 commit d352284

1 file changed

Lines changed: 12 additions & 2 deletions

File tree

docs/389ds/design/memberof-specific-group-scoping-design.md

Lines changed: 12 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,9 @@ This is implemented by passing a new *entry_info C struct*, that contains the gr
3131
Behavior
3232
--------
3333

34-
The specific group constraints are strict. If you specify one specific group to include, then all other groups in the DIT will be excluded, regardless of their location. If it's not found by the "specific group" filters, then it's not updated. Similarly for excluding specific groups, if the group is not by the exclude filters, then it gets updated. It might not make sense to use both include and exclude specific group filters simultaneously. Instead, choose one approach that best fits your needs.
34+
The specific group constraints are strict. If you specify one specific group to include, then all other groups in the DIT will be excluded, regardless of their location. If it's not found by the "specific group" filters, then it's not updated. Similarly for excluding specific groups, if the group does not match any of the exclude filters, then it gets updated. It might not make sense to use both include and exclude specific group filters simultaneously. Instead, choose one approach that best fits your needs.
35+
36+
NOTE - If you have a strong understanding of LDAP search filters you can technically create a single complex "include" filter to covers all the include/exclude cases, but this can be complicated/confusing and not a requirement.
3537

3638
Major configuration options and enablement
3739
------------------------------------------
@@ -48,7 +50,7 @@ The "entry_info" struct in memberof.c
4850
There are three new multi-valued configuration attributes that can be set in: **cn=MemberOf Plugin,cn=plugins,cn=config**:
4951

5052
- memberOfSpecificGroupFilter: <LDAP search filter>
51-
- memberOfsExcludeSpecificGroupFilter: <LDAP search filter>
53+
- memberOfExcludeSpecificGroupFilter: <LDAP search filter>
5254
- memberOfSpecificGroupOC: <objectclass name>
5355

5456
For example
@@ -66,13 +68,21 @@ For example
6668

6769
CLI usage
6870

71+
You can replace all current values by using **set**, or you can add/delete individual values using **add-attr** and **del-attr**
72+
6973
dsconf slapd-INSTANCE plugin memberof set --specific-group-filter=(cn=group)
7074
dsconf slapd-INSTANCE plugin memberof set --exclude-specific-group-filter=(cn=isolated group)
75+
dsconf slapd-INSTANCE plugin memberof set --specific-group-oc groupOfUniquenames customGroupObjClass
76+
77+
dsconf slapd-INSTANCE plugin memberof add-attr --specific-group-filter=(cn=group2)
78+
dsconf slapd-INSTANCE plugin memberof del-attr --exclude-specific-group-filter=(cn=isolated group2)
79+
7180

7281
Origin
7382
-------------
7483

7584
<https://github.com/389ds/389-ds-base/issues/7035>
85+
<https://github.com/389ds/389-ds-base/issues/7041>
7686

7787
Author
7888
------

0 commit comments

Comments
 (0)