File names renamed.

This commit is contained in:
Zhang Huangbin 2014-12-18 21:41:54 +08:00
parent 6fc3ae6bef
commit 1dbb150441
17 changed files with 139 additions and 27 deletions

View File

@ -1,5 +1,6 @@
# TODO
* http://www.iredmail.org/wiki/index.php?title=IRedMail/FAQ/Dovecot.Master.User
* which config files must be update if i want to change hostname
* re-generate ssl cert/key

View File

@ -88,7 +88,7 @@ Addition config files:
* `dovecot-pgsql.conf`: used to query mail users and passwords. PostgreSQL backend only.
* `dovecot-used-quota.conf`: used to store and query real-time per-user mailbox quota.
* `dovecot-share-folder.conf`: used to store settings of shared IMAP mailboxes.
* `dovecot-master-users-password`: used to store master users/passwords.
* `dovecot-master-users-password` or `dovecot-master-users`: used to store Dovecot master user accounts.
### Log files

View File

@ -0,0 +1,57 @@
# Dovecot Master User
iRedMail-0.8.6 and later releases have Dovecot Master User enabled for all
backends (OpenLDAP, MySQL/MariaDB, PostgreSQL) by default, what you need to do
is adding new master user.
iRedMail configures Dovecot to query master user accounts from config file
`/etc/dovecot/dovecot-master-users-password` (or `dovecot-master-users`) by
default, you can modify this file to add or remove master user.
The format is simple:
```
username:password
```
You can generate a password supported by Dovecot first. for example, SSHA512.
Let's generate password hash for our password `my_master_password`:
```
# doveadm pw -s SSHA512
Enter new password: my_master_password
Retype new password: my_master_password
{SSHA512}B0VHomJaMk6aLXOPglgNgJtCUA8JRnOweAwJxRW6NPWSNZ25rG/L6T05DJXH+t8WCQkemBilgkcEi6mq4Kadssivtts=
```
You can now pick up any username you like, for example,
`my_master_user@non-exist.com`. Now add new master user in file
`/etc/dovecot/dovecot-master-users-passwords` like below:
```
my_master_user@non-exist.com:{SSHA512}B0VHomJaMk6aLXOPglgNgJtCU...
```
WARNING: Make sure file `dovecot-master-users-password` is owned by Dovecot
daemon user and group, with file permission `0500`, so that others cannot view
the file content.
> * on Linux/FreeBSD, Dovecot daemon user/group is `dovecot/dovecot`.
> * on OpenBSD, Dovecot daemon user/group is `_dovecot/_dovecot`.
Then you can access user@domain.ltd's mailbox (via either IMAP or POP3
protocol) as `user@domain.ltd*my_master_user@non-exist.com` with password
`my_master_password`.
Notes:
* master user name must be in valid email address format. e.g. user@domain.com.
this email address doesn't need to exist.
## Troubleshooting
If it doesn't work for you, please enable debug mode in Dovecot and check
its log file. If you don't understand what the log says, please create a new
topic in our forum and paste related log:
* [Debug Dovecot](./debug.dovecot.html)
* [iRedMail online support forum](http://www.iredmail.org/forum/)

View File

@ -0,0 +1,73 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Dovecot Master User</title>
<link href="./css/markdown.css" rel="stylesheet"></head>
</head>
<body>
<div id="navigation">
<a href="http://www.iredmail.org" target="_blank">iRedMail web site</a>
// <a href="./index.html">Document Index</a>
</div><h1 id="dovecot-master-user">Dovecot Master User</h1>
<p>iRedMail-0.8.6 and later releases have Dovecot Master User enabled for all
backends (OpenLDAP, MySQL/MariaDB, PostgreSQL) by default, what you need to do
is adding new master user.</p>
<p>iRedMail configures Dovecot to query master user accounts from config file
<code>/etc/dovecot/dovecot-master-users-password</code> (or <code>dovecot-master-users</code>) by
default, you can modify this file to add or remove master user.</p>
<p>The format is simple:</p>
<pre><code>username:password
</code></pre>
<p>You can generate a password supported by Dovecot first. for example, SSHA512.
Let's generate password hash for our password <code>my_master_password</code>:</p>
<pre><code># doveadm pw -s SSHA512
Enter new password: my_master_password
Retype new password: my_master_password
{SSHA512}B0VHomJaMk6aLXOPglgNgJtCUA8JRnOweAwJxRW6NPWSNZ25rG/L6T05DJXH+t8WCQkemBilgkcEi6mq4Kadssivtts=
</code></pre>
<p>You can now pick up any username you like, for example,
<code>my_master_user@non-exist.com</code>. Now add new master user in file
<code>/etc/dovecot/dovecot-master-users-passwords</code> like below:</p>
<pre><code>my_master_user@non-exist.com:{SSHA512}B0VHomJaMk6aLXOPglgNgJtCU...
</code></pre>
<p>WARNING: Make sure file <code>dovecot-master-users-password</code> is owned by Dovecot
daemon user and group, with file permission <code>0500</code>, so that others cannot view
the file content.</p>
<blockquote>
<ul>
<li>on Linux/FreeBSD, Dovecot daemon user/group is <code>dovecot/dovecot</code>.</li>
<li>on OpenBSD, Dovecot daemon user/group is <code>_dovecot/_dovecot</code>.</li>
</ul>
</blockquote>
<p>Then you can access user@domain.ltd's mailbox (via either IMAP or POP3
protocol) as <code>user@domain.ltd*my_master_user@non-exist.com</code> with password
<code>my_master_password</code>.</p>
<p>Notes:</p>
<ul>
<li>master user name must be in valid email address format. e.g. user@domain.com.
this email address doesn't need to exist.</li>
</ul>
<h2 id="troubleshooting">Troubleshooting</h2>
<p>If it doesn't work for you, please enable debug mode in Dovecot and check
its log file. If you don't understand what the log says, please create a new
topic in our forum and paste related log:</p>
<ul>
<li><a href="./debug.dovecot.html">Debug Dovecot</a></li>
<li><a href="http://www.iredmail.org/forum/">iRedMail online support forum</a></li>
</ul><p style="text-align: center; color: grey;">Document published under a <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">CC BY-ND 3.0</a> license. If you found something wrong, please do <a href="http://www.iredmail.org/contact.html">contact us</a> to fix it.<!-- Google Analytics -->
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try {
var pageTracker = _gat._getTracker("UA-3293801-14");
pageTracker._trackPageview();
} catch(err) {}
</script>
</body></html>

View File

@ -130,7 +130,7 @@
<li><code>dovecot-pgsql.conf</code>: used to query mail users and passwords. PostgreSQL backend only.</li>
<li><code>dovecot-used-quota.conf</code>: used to store and query real-time per-user mailbox quota.</li>
<li><code>dovecot-share-folder.conf</code>: used to store settings of shared IMAP mailboxes.</li>
<li><code>dovecot-master-users-password</code>: used to store master users/passwords.</li>
<li><code>dovecot-master-users-password</code> or <code>dovecot-master-users</code>: used to store Dovecot master user accounts.</li>
</ul>
<h3 id="log-files_1">Log files</h3>
<ul>

View File

@ -50,6 +50,7 @@
<li><a href="allow.insecure.pop3.imap.smtp.connections.html">Allow insecure POP3/IMAP/SMTP connections without STARTTLS</a></li>
<li><a href="allow.user.to.send.email.without.authentication.html">Allow user to send email without authentication</a></li>
<li><a href="amavisd.per-recipient.policy.lookup.html">Amavisd: Enable per-recipient policy lookup</a></li>
<li><a href="dovecot.master.user.html">Dovecot Master User</a></li>
<li><a href="force.user.to.change.password.html">Force mail user to change password in 90 days</a></li>
<li><a href="ignore.trash.folder.in.quota.html">Ignore Trash folder in mailbox quota</a></li>
<li><a href="iredadmin-pro.default.password.policy.html">iRedAdmin-Pro: Default password restrictions</a></li>
@ -100,11 +101,11 @@
</ul>
<h3 id="troubleshooting-and-debug">Troubleshooting and Debug</h3>
<ul>
<li><a href="turn.on.debug.mode.in.amavisd.html">Turn on debug mode in Amavisd and SpamAssassin</a></li>
<li><a href="turn.on.debug.mode.in.cluebringer.html">Turn on debug mode in Cluebringer</a></li>
<li><a href="turn.on.debug.mode.in.dovecot.html">Turn on debug mode in Dovecot</a></li>
<li><a href="turn.on.debug.mode.in.iredapd.html">Turn on debug mode in iRedAPD</a></li>
<li><a href="turn.on.debug.mode.in.openldap.html">Turn on debug mode in OpenLDAP</a></li>
<li><a href="debug.amavisd.html">Turn on debug mode in Amavisd and SpamAssassin</a></li>
<li><a href="debug.cluebringer.html">Turn on debug mode in Cluebringer</a></li>
<li><a href="debug.dovecot.html">Turn on debug mode in Dovecot</a></li>
<li><a href="debug.iredapd.html">Turn on debug mode in iRedAPD</a></li>
<li><a href="debug.openldap.html">Turn on debug mode in OpenLDAP</a></li>
</ul>
<h3 id="frequently-asked-questions">Frequently Asked Questions</h3>
<ul>

View File

@ -1,20 +0,0 @@
# Frequently Asked Questions
* [ Why append timestamp in maildir path](faq/why.append.timestamp.in.maildir.path.html)
# How to
* [ How to allow user to send email without authentication ](howto/allow.user.to.send.email.without.authentication.html)
* [ Amavisd + SpamAssassin not working, no mail header (X-Spam-*) inserted.](howto/amavisd.no.x-spam.headers.html)
* [ How to completely disable amavisd/ClamAV/SpamAssassin](howto/completely.disable.amavisd.clamav.spamassassin.html)
* [ How to disable spam virus scanning for outgoing mails](howto/disable.spam.virus.scanning.for.outgoing.mails.html)
* [ Configure Thunderbird as mail client (IMAP, SMTP and global ldap address book)](howto/howto.configure.thunderbird.for.iredmail.html)
* [ How to enable SMTPS service (SMTP over SSL, port 465)](howto/howto.enable.smtps.service.html)
* [ How to pipe incoming email for certain user to external script ](howto/pipe.incoming.email.for.certain.user.to.external.script.html)
* [ How to quarantine clean mail into SQL database](howto/quarantining.clean.mail.html)
* [ How to force Dovecot to recalculate mailbox quota ](howto/recalculate.mailbox.quota.html)
* [ How to store spamassassin bayes in SQL](howto/store.spamassassin.bayes.in.sql.html)
* [ How to perform silent/unattended iRedMail installation](howto/unattended.iredmail.installation.html)
* [ How to use or migrate password hashes](howto/use.or.migrate.password.hashes.html)
# Backup and Restore
* [How to migrate old iRedMail server to the latest stable release](backup-restore/migrate.to.new.iredmail.server.html)
# Troubleshooting and Debug
* [ How to turn on debug mode in Dovecot](troubleshooting/turn.on.debug.mode.in.dovecot.html)