From 0c9cde3be00c7a9d48992c5071a9bfcccb4881a4 Mon Sep 17 00:00:00 2001 From: Zhang Huangbin Date: Wed, 9 Aug 2017 09:59:24 +0800 Subject: [PATCH] Update doc en_US/howto/user.alias.address.md for iRedMail-0.9.7 due to sql structure change. --- en_US/howto/0-user.alias.address-20170701.md | 56 +++++++++++++ en_US/howto/user.alias.address.md | 40 +++++---- html/user.alias.address-20170701.html | 85 ++++++++++++++++++++ html/user.alias.address.html | 43 ++++++---- 4 files changed, 195 insertions(+), 29 deletions(-) create mode 100644 en_US/howto/0-user.alias.address-20170701.md create mode 100644 html/user.alias.address-20170701.html diff --git a/en_US/howto/0-user.alias.address-20170701.md b/en_US/howto/0-user.alias.address-20170701.md new file mode 100644 index 00000000..10a901dd --- /dev/null +++ b/en_US/howto/0-user.alias.address-20170701.md @@ -0,0 +1,56 @@ +# Per-user alias address + +[TOC] + +!!! attention + + * This document is applicable to iRedMail-0.9.6 and earlier releases. + * Here's [doc for iRedMail-0.9.7 and later releases](./user.alias.address.html). + +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". + +![](../images/iredadmin/user_profile_aliases.png){:width="1024px"} + +## 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'); +``` + +* Account `sales@domain.com` and `bill@domain.com` are NOT existing mail user accounts. +* Values of column `alias.goto` and `alias.alias_to` must be the same -- email address of the existing mail user. +* In above sample, `bill@domain.com` could be an email address which belongs to your alias domain. +* You're free to add as many additional email addresses as you want. + +## 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 +... +``` diff --git a/en_US/howto/user.alias.address.md b/en_US/howto/user.alias.address.md index 2df13077..553c36c1 100644 --- a/en_US/howto/user.alias.address.md +++ b/en_US/howto/user.alias.address.md @@ -2,6 +2,11 @@ [TOC] +!!! attention + + * This document is applicable to iRedMail-0.9.7 and later releases. + * Here's [doc for iRedMail-0.9.6 and earlier releases](./user.alias.address-20170701.html). + 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 @@ -12,27 +17,38 @@ 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. +page, under tab "Aliases". + +![](../images/iredadmin/user_profile_aliases.png){:width="1024px"} ## 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`: +__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 forwardings (address, forwarding, + domain, dest_domain, + is_alias, active) + VALUES ('sales@domain.com', 'john@domain.com', + 'domain.com', 'domain.com', + 1, 1); -sql> INSERT INTO alias (address, goto, alias_to, is_alias, domain) - VALUES ('bill@domain.com', 'john@domain.com', 'john@domain.com', 1, 'domain.com'); +sql> INSERT INTO forwardings (address, forwarding, + domain, dest_domain, + is_alias, active) + VALUES ('bill@domain.com', 'john@domain.com', + 'domain.com', 'domain.com', + 1, 1); ``` -* Account `sales@domain.com` and `bill@domain.com` are NOT existing mail user accounts. -* Values of column `alias.goto` and `alias.alias_to` must be the same -- email address of the existing mail user. -* In above sample, `bill@domain.com` could be an email address which belongs to your alias domain. -* You're free to add as many additional email addresses as you want. +* Account `sales@domain.com` and `bill@domain.com` are NOT existing mail user + accounts. +* In above sample, `bill@domain.com` could be an email address which belongs + to your alias domain. +* You can add as many additional email addresses as you want. ## LDAP backend: Manage per-user alias addresses @@ -47,7 +63,3 @@ shadowAddress: sales@domain.com shadowAddress: bill@domain.com ... ``` - -## Screenshot of iRedAdmin-Pro - -![](../images/iredadmin/user_profile_aliases.png){:width="1024px"} diff --git a/html/user.alias.address-20170701.html b/html/user.alias.address-20170701.html new file mode 100644 index 00000000..7213ae82 --- /dev/null +++ b/html/user.alias.address-20170701.html @@ -0,0 +1,85 @@ + + + + + Per-user alias address + + + + +

Per-user alias address

+
+ +
+
+

Attention

+ +
+

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".

+

+

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');
+
+ + +

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
+...
+
+

All documents are available in BitBucket repository, and published under Creative Commons license. You can download the latest version for offline reading. If you found something wrong, please do contact us to fix it.

+
+ + \ No newline at end of file diff --git a/html/user.alias.address.html b/html/user.alias.address.html index 41deb8d9..94c5adc2 100644 --- a/html/user.alias.address.html +++ b/html/user.alias.address.html @@ -22,11 +22,17 @@
  • Manage per-user alias addresses with iRedAdmin-Pro
  • SQL backend: Manage per-user alias addresses with SQL command line
  • LDAP backend: Manage per-user alias addresses
    • -
  • Screenshot of iRedAdmin-Pro
    • +
    +

    Attention

    + +

    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 @@ -35,24 +41,34 @@ 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.

    +page, under tab "Aliases".

    +

    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:

    +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 forwardings (address, forwarding,
+                              domain, dest_domain,
+                              is_alias, active)
+                      VALUES ('sales@domain.com', 'john@domain.com',
+                              'domain.com', 'domain.com',
+                              1, 1);
 
-sql> INSERT INTO alias (address, goto, alias_to, is_alias, domain)
-                VALUES ('bill@domain.com', 'john@domain.com', 'john@domain.com', 1, 'domain.com');
+sql> INSERT INTO forwardings (address, forwarding,
+                              domain, dest_domain,
+                              is_alias, active)
+                      VALUES ('bill@domain.com', 'john@domain.com',
+                              'domain.com', 'domain.com',
+                              1, 1);

    LDAP backend: Manage per-user alias addresses

    For LDAP backend, per-user alias addresses are stored in LDAP attribute @@ -63,10 +79,7 @@ enabledService: shadowaddress shadowAddress: sales@domain.com shadowAddress: bill@domain.com ... - - -

    Screenshot of iRedAdmin-Pro

    -

    +

    All documents are available in BitBucket repository, and published under Creative Commons license. You can download the latest version for offline reading. If you found something wrong, please do contact us to fix it.