New: en_US/howto/user.alias.address.md -> user.alias.address.html.

This commit is contained in:
Zhang Huangbin 2016-04-28 09:17:46 +08:00
parent c9c3640448
commit ce7ac7ba37
4 changed files with 118 additions and 1 deletions

View File

@ -0,0 +1,51 @@
# Per-user alias address
Since iRedMail-0.9.3, we have per-user alias address support, that means mail
user `john.smith@domain.com` can have additional email addresses like
`john@domain.com`, `js@domain.com` and more, all emails sent to these addresses
will be delivered to same mailbox (`john.smith@domain.com`). With per-user
alias address support, you don't need to create separated mail alias accounts
anymore.
## Manage per-user alias addresses with iRedAdmin-Pro
You can manage per-user alias addresses with iRedAdmin-Pro in user profile
page, under tab "Aliases". Screenshot attached below.
## SQL backend: Manage per-user alias addresses with SQL command line
Add additional email addresses `sales@domain.com`, `bill@domain.com` for
existing user `john@domain.com`:
```
sql> USE vmail;
sql> INSERT INTO alias (address, goto, alias_to, is_alias, domain)
VALUES ('sales@domain.com', 'john@domain.com', 'john@domain.com', 1, 'domain.com');
sql> INSERT INTO alias (address, goto, alias_to, is_alias, domain)
VALUES ('bill@domain.com', 'john@domain.com', 'john@domain.com', 1, 'domain.com');
```
* Values of column `alias.goto` and `alias.alias_to` must be the same -- email address of the existing mail user.
* You can add as many additional email addresses as you want.
* In above sample, `bill@domain.com` could be an email address which belongs to your alias domain.
## LDAP backend: Manage per-user alias addresses
For LDAP backend, per-user alias addresses are stored in LDAP attribute
`shadowAddress` of user object, and attribute/value pair
`enabledService=shadowaddress` is required. For example:
```
dn: mail=john@domain.com,ou=Users,domainName=domain.com,o=domains,dc=xxx,dc=xxx
enabledService: shadowaddress
shadowAddress: sales@domain.com
shadowAddress: bill@domain.com
...
```
## Screenshot of iRedAdmin-Pro
![](../images/iredadmin/user_profile_aliases.png){:width="1024px"}

View File

@ -132,6 +132,7 @@
<li><a href="store.spamassassin.bayes.in.sql.html">Store SpamAssassin bayes in SQL</a></li>
<li><a href="use.a.bought.ssl.certificate.html">Use a bought SSL certificate</a></li>
<li><a href="use.openldap.as.address.book.in.outlook.html">Use OpenLDAP as address book in Microsoft Outlook</a></li>
<li><a href="user.alias.address.html">Per-user alias address</a></li>
</ul>
<p>Documents contributed by iRedMail users:</p>
<ul>

View File

@ -7,7 +7,7 @@
<body>
<div id="navigation">
<a href="/index.html" target="_blank">
<a href="http://www.iredmail.org/" target="_blank">
<img alt="iRedMail web site"
src="./images/logo-iredmail.png"
style="vertical-align: middle; height: 30px;"

View File

@ -0,0 +1,65 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Per-user alias address</title>
<link rel="stylesheet" type="text/css" href="./css/markdown.css" />
</head>
<body>
<div id="navigation">
<a href="/index.html" target="_blank">
<img alt="iRedMail web site"
src="./images/logo-iredmail.png"
style="vertical-align: middle; height: 30px;"
/>&nbsp;
<span>iRedMail</span>
</a>
&nbsp;&nbsp;//&nbsp;&nbsp;<a href="./index.html">Document Index</a></div><h1 id="per-user-alias-address">Per-user alias address</h1>
<p>Since iRedMail-0.9.3, we have per-user alias address support, that means mail
user <code>john.smith@domain.com</code> can have additional email addresses like
<code>john@domain.com</code>, <code>js@domain.com</code> and more, all emails sent to these addresses
will be delivered to same mailbox (<code>john.smith@domain.com</code>). With per-user
alias address support, you don't need to create separated mail alias accounts
anymore.</p>
<h2 id="manage-per-user-alias-addresses-with-iredadmin-pro">Manage per-user alias addresses with iRedAdmin-Pro</h2>
<p>You can manage per-user alias addresses with iRedAdmin-Pro in user profile
page, under tab "Aliases". Screenshot attached below.</p>
<h2 id="sql-backend-manage-per-user-alias-addresses-with-sql-command-line">SQL backend: Manage per-user alias addresses with SQL command line</h2>
<p>Add additional email addresses <code>sales@domain.com</code>, <code>bill@domain.com</code> for
existing user <code>john@domain.com</code>:</p>
<pre><code>sql&gt; USE vmail;
sql&gt; INSERT INTO alias (address, goto, alias_to, is_alias, domain)
VALUES ('sales@domain.com', 'john@domain.com', 'john@domain.com', 1, 'domain.com');
sql&gt; INSERT INTO alias (address, goto, alias_to, is_alias, domain)
VALUES ('bill@domain.com', 'john@domain.com', 'john@domain.com', 1, 'domain.com');
</code></pre>
<ul>
<li>Values of column <code>alias.goto</code> and <code>alias.alias_to</code> must be the same -- email address of the existing mail user.</li>
<li>You can add as many additional email addresses as you want.</li>
<li>In above sample, <code>bill@domain.com</code> could be an email address which belongs to your alias domain.</li>
</ul>
<h2 id="ldap-backend-manage-per-user-alias-addresses">LDAP backend: Manage per-user alias addresses</h2>
<p>For LDAP backend, per-user alias addresses are stored in LDAP attribute
<code>shadowAddress</code> of user object, and attribute/value pair
<code>enabledService=shadowaddress</code> is required. For example:</p>
<pre><code>dn: mail=john@domain.com,ou=Users,domainName=domain.com,o=domains,dc=xxx,dc=xxx
enabledService: shadowaddress
shadowAddress: sales@domain.com
shadowAddress: bill@domain.com
...
</code></pre>
<h2 id="screenshot-of-iredadmin-pro">Screenshot of iRedAdmin-Pro</h2>
<p><img alt="" src="../images/iredadmin/user_profile_aliases.png" width="1024px" /></p><p style="text-align: center; color: grey;">All documents are available in <a href="https://bitbucket.org/zhb/iredmail-docs/src">BitBucket repository</a>, and published under <a href="http://creativecommons.org/licenses/by-nd/3.0/us/" target="_blank">Creative Commons</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(){
(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)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-3293801-21', 'auto');
ga('send', 'pageview');
</script>
</body></html>