Typo: en_US/howto/authenticate.without.domain.name.md.

This commit is contained in:
Zhang Huangbin 2015-11-06 23:10:21 +08:00
parent 13d3b5e5eb
commit e4efb4f416
2 changed files with 29 additions and 27 deletions

View File

@ -4,23 +4,27 @@ With default settings, client must use full email address as username for
POP3/IMAP/SMTP/webmail login, if you want to login without domain name part in POP3/IMAP/SMTP/webmail login, if you want to login without domain name part in
email address, please follow below steps. email address, please follow below steps.
* Open Dovecot config file `/etc/dovecot/dovecot.conf` (Linux/OpenBSD) or ### Dovecot
`/usr/local/etc/dovecot/dovecot.conf` (FreeBSD), find parameter
`auth_default_realm`, set the domain name you want to allow user to login Open Dovecot config file `/etc/dovecot/dovecot.conf` (Linux/OpenBSD) or
without domain name part in email address. For example: `/usr/local/etc/dovecot/dovecot.conf` (FreeBSD), find parameter
`auth_default_realm`, set the domain name you want to allow user to login
without domain name part in email address. For example:
``` ```
auth_default_realm = mydomain.com auth_default_realm = mydomain.com
``` ```
Restarting Dovecot is required. After restarted Dovecot, user logins as Restarting Dovecot is required. After restarted Dovecot, user logins as
`john.smith` will be rewritten to `john.smith@mydomain.com` by Dovecot. `john.smith` will be rewritten to `john.smith@mydomain.com` by Dovecot.
This works for POP3/IMAP/SMTP services. This works for POP3/IMAP/SMTP services.
* [OPTIONAL] Open Roundcube webmail ### [OPTIONAL] Roundcube Webmail
[config file `config/main.inc.php`](./file.locations.html#roundcube-webmail),
find parameter `$config['username_domain']`, list your domain name Open Roundcube webmail
in this parameter. For example: [config file `config/main.inc.php`](./file.locations.html#roundcube-webmail),
find parameter `$config['username_domain']`, list your domain name
in this parameter. For example:
``` ```
// Automatically add this domain to user names for login // Automatically add this domain to user names for login
@ -36,4 +40,4 @@ auth_default_realm = mydomain.com
$config['username_domain'] = 'mydomain.com'; $config['username_domain'] = 'mydomain.com';
``` ```
Restarting Apache web server is recommended. Restarting web server (Apache or php-fpm) is recommended.

View File

@ -14,24 +14,22 @@
<p>With default settings, client must use full email address as username for <p>With default settings, client must use full email address as username for
POP3/IMAP/SMTP/webmail login, if you want to login without domain name part in POP3/IMAP/SMTP/webmail login, if you want to login without domain name part in
email address, please follow below steps.</p> email address, please follow below steps.</p>
<ul> <h3 id="dovecot">Dovecot</h3>
<li>Open Dovecot config file <code>/etc/dovecot/dovecot.conf</code> (Linux/OpenBSD) or <p>Open Dovecot config file <code>/etc/dovecot/dovecot.conf</code> (Linux/OpenBSD) or
<code>/usr/local/etc/dovecot/dovecot.conf</code> (FreeBSD), find parameter <code>/usr/local/etc/dovecot/dovecot.conf</code> (FreeBSD), find parameter
<code>auth_default_realm</code>, set the domain name you want to allow user to login <code>auth_default_realm</code>, set the domain name you want to allow user to login
without domain name part in email address. For example:</li> without domain name part in email address. For example:</p>
</ul>
<pre><code>auth_default_realm = mydomain.com <pre><code>auth_default_realm = mydomain.com
</code></pre> </code></pre>
<p>Restarting Dovecot is required. After restarted Dovecot, user logins as <p>Restarting Dovecot is required. After restarted Dovecot, user logins as
<code>john.smith</code> will be rewritten to <code>john.smith@mydomain.com</code> by Dovecot. <code>john.smith</code> will be rewritten to <code>john.smith@mydomain.com</code> by Dovecot.
This works for POP3/IMAP/SMTP services.</p> This works for POP3/IMAP/SMTP services.</p>
<ul> <h3 id="optional-roundcube-webmail">[OPTIONAL] Roundcube Webmail</h3>
<li>[OPTIONAL] Open Roundcube webmail <p>Open Roundcube webmail
<a href="./file.locations.html#roundcube-webmail">config file <code>config/main.inc.php</code></a>, <a href="./file.locations.html#roundcube-webmail">config file <code>config/main.inc.php</code></a>,
find parameter <code>$config['username_domain']</code>, list your domain name find parameter <code>$config['username_domain']</code>, list your domain name
in this parameter. For example:</li> in this parameter. For example:</p>
</ul>
<pre><code>// Automatically add this domain to user names for login <pre><code>// Automatically add this domain to user names for login
// Only for IMAP servers that require full e-mail addresses for login // Only for IMAP servers that require full e-mail addresses for login
// Specify an array with 'host' =&gt; 'domain' values to support multiple hosts // Specify an array with 'host' =&gt; 'domain' values to support multiple hosts
@ -45,7 +43,7 @@ email address, please follow below steps.</p>
$config['username_domain'] = 'mydomain.com'; $config['username_domain'] = 'mydomain.com';
</code></pre> </code></pre>
<p>Restarting Apache web server is recommended.</p><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.<script> <p>Restarting web server (Apache or php-fpm) is recommended.</p><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.<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)