Skip to content

Commit 7f67453

Browse files
committed
plugins/acl: Document how to use group statements to make rulesets
1 parent 6c97193 commit 7f67453

1 file changed

Lines changed: 33 additions & 0 deletions

File tree

docs/core/plugins/acl.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,39 @@ namespace shared {
113113
#acl_username = %{master_user}
114114
```
115115

116+
### Creating rulesets with group
117+
118+
You can also simplify ACL ruleset management by defining rulesets.
119+
These rulesets cannot be inherited or mixed, but they should simplify the configuration,
120+
especially when there is large number of mailboxes to configure.
121+
122+
```[dovecot.conf]
123+
# define rulesets
124+
125+
group @acl_ruleset ruleset1 {
126+
acl user=user1 {
127+
rights = lri
128+
}
129+
}
130+
131+
group @acl_ruleset ruleset2 {
132+
acl user=user1 {
133+
rights = lri
134+
}
135+
}
136+
137+
namespace public {
138+
mailbox "Secret" {
139+
@acl_ruleset = ruleset1
140+
}
141+
mailbox "TopSecret" {
142+
@acl_ruleset = ruleset2
143+
}
144+
mailbox "Foo*" {
145+
@acl_ruleset = ruleset1
146+
}
147+
}
148+
116149
## Master Users
117150
118151
::: info

0 commit comments

Comments
 (0)