elmau
/
iredmail-doc
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Don't mention how to manage dovecot mailbox acl MANUALLY (too risky).

This commit is contained in:
Zhang Huangbin 2017-01-19 00:50:57 +08:00
parent a4de3175ed
commit 8b1fddbe08
2 changed files with 0 additions and 74 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
en_US/howto/public.folder.md
View File

@ -173,45 +173,6 @@ doveadm acl delete -A "Public/TestFolder" "user=postmaster@test.com"
For more details about ACL control, please read Dovecot tutorials mentioned in
[References](#references) below.
## Manage Access Control manually
!!! note
* if you're running Dovecot-2, it's recommended to manage ACL with `doveadm`
command.
* Dovecot will create file `/var/vmail/public/dovecot-acl-list` automatically,
it lists all mailboxes that have `l` rights assigned. If you manually
add/edit `dovecot-acl` files, you may need to delete the `dovecot-acl-list`
to get the mailboxes visible.
Access permission is controlled in file `dovecot-acl` under each shared folder,
let's create it before showing you some examples:
```
touch /var/vmail/public/.TestFolder/dovecot-acl
chown vmail:vmail /var/vmail/public/.TestFolder/dovecot-acl
chmod 0700 /var/vmail/public/.TestFolder/dovecot-acl
```
With shell command below, we grant `lookup` (l), `read` (r), `write` (w),
`insert` (i), `delete` (x), `expunge` (e) and `create sub-directory` (k) permissions to user
`postmaster@test.com` (again, this user is hosted on same server):
```
echo 'user=postmaster@test.com lrwixke' >> /var/vmail/public/.TestFolder/dovecot-acl
```
With shell command below, we grant all users `lookup` (l) and `read` (r)
permissions:
!!! note "Reminder"
It requires Dovecot setting `acl_anyone = allow` in `dovecot.conf`.
```
echo 'anyone lr' >> /var/vmail/public/.TestFolder/dovecot-acl
```
## Troubleshooting
* If public folder doesn't work as expected, please [turn on debug mode in

35
html/public.folder.html
View File

@ -21,7 +21,6 @@
<li><a href="#how-to-create-and-manage-public-folder">How to create and manage public folder</a><ul>
<li><a href="#enable-public-folder-in-dovecot">Enable public folder in Dovecot</a></li>
<li><a href="#manage-access-control-with-doveadm">Manage Access Control with doveadm</a></li>
<li><a href="#manage-access-control-manually">Manage Access Control manually</a></li>
<li><a href="#troubleshooting">Troubleshooting</a></li>
<li><a href="#use-someones-mailbox-as-public-folder">Use someone's mailbox as public folder</a></li>
<li><a href="#references">References</a></li>
@ -228,40 +227,6 @@ server, you can see a new folder <code>TestFolder</code>.</p>
<p>For more details about ACL control, please read Dovecot tutorials mentioned in
<a href="#references">References</a> below.</p>
<h2 id="manage-access-control-manually">Manage Access Control manually</h2>
<div class="admonition note">
<p class="admonition-title">Note</p>
<ul>
<li>if you're running Dovecot-2, it's recommended to manage ACL with <code>doveadm</code>
command.</li>
<li>Dovecot will create file <code>/var/vmail/public/dovecot-acl-list</code> automatically,
it lists all mailboxes that have <code>l</code> rights assigned. If you manually
add/edit <code>dovecot-acl</code> files, you may need to delete the <code>dovecot-acl-list</code>
to get the mailboxes visible.</li>
</ul>
</div>
<p>Access permission is controlled in file <code>dovecot-acl</code> under each shared folder,
let's create it before showing you some examples:</p>
<pre><code>touch /var/vmail/public/.TestFolder/dovecot-acl
chown vmail:vmail /var/vmail/public/.TestFolder/dovecot-acl
chmod 0700 /var/vmail/public/.TestFolder/dovecot-acl
</code></pre>
<p>With shell command below, we grant <code>lookup</code> (l), <code>read</code> (r), <code>write</code> (w),
<code>insert</code> (i), <code>delete</code> (x), <code>expunge</code> (e) and <code>create sub-directory</code> (k) permissions to user
<code>postmaster@test.com</code> (again, this user is hosted on same server):</p>
<pre><code>echo 'user=postmaster@test.com lrwixke' &gt;&gt; /var/vmail/public/.TestFolder/dovecot-acl
</code></pre>
<p>With shell command below, we grant all users <code>lookup</code> (l) and <code>read</code> (r)
permissions:</p>
<div class="admonition note">
<p class="admonition-title">Reminder</p>
<p>It requires Dovecot setting <code>acl_anyone = allow</code> in <code>dovecot.conf</code>.</p>
</div>
<pre><code>echo 'anyone lr' &gt;&gt; /var/vmail/public/.TestFolder/dovecot-acl
</code></pre>
<h2 id="troubleshooting">Troubleshooting</h2>
<ul>
<li>