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 @@ + + +
+ +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.
You can manage per-user alias addresses with iRedAdmin-Pro in user profile +page, under tab "Aliases".
+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');
+
+
+sales@domain.com
and bill@domain.com
are NOT existing mail user accounts.alias.goto
and alias.alias_to
must be the same -- email address of the existing mail user.bill@domain.com
could be an email address which belongs to your alias domain.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
+...
+
+
+
\ 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 @@
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.
You can manage per-user alias addresses with iRedAdmin-Pro in user profile -page, under tab "Aliases". Screenshot attached below.
+page, under tab "Aliases". +Add additional email addresses sales@domain.com
, bill@domain.com
for
-existing user john@domain.com
:
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);
sales@domain.com
and bill@domain.com
are NOT existing mail user accounts.alias.goto
and alias.alias_to
must be the same -- email address of the existing mail user.bill@domain.com
could be an email address which belongs to your alias domain.sales@domain.com
and bill@domain.com
are NOT existing mail user
+ accounts.bill@domain.com
could be an email address which belongs
+ to your alias domain.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 ... - - -