iredmail-doc/en_US/howto/ldap.add.alias.domain.md

53 lines
1.9 KiB
Markdown
Raw Normal View History

2014-09-22 21:47:49 -05:00
# LDAP: Add an alias domain
2018-01-12 22:57:01 -06:00
[TOC]
2014-09-22 21:47:49 -05:00
## What an alias domain is used for?
Let's say you have a mail domain `example.com` hosted on your iRedMail server,
if you add domain name `domain.ltd` as an alias domain of `example.com`, all
emails sent to `username@domain.ltd` will be delivered to user
`username@example.com`'s mailbox.
## Add alias domain with iRedAdmin-Pro
With iRedAdmin-Pro, you can simply add alias domain name in domain profile page,
under tab `Aliases`.
Screenshot:
![](./images/iredadmin/domain_profile_alias.png)
2014-09-22 21:47:49 -05:00
## How to add an alias domain with phpLDAPadmin:
* Login to phpLDAPadmin (`https://[your_server]/phpldapadmin`) as LDAP root dn
(`cn=Manager,dc=xx,dc=xx`)
* Find the LDAP object of your mail domain which you want to add alias
domain in left panel of phpLDAPadmin, click the ldap object, phpLDAPadmin will
show detailed LDAP attributes/values of this domain in right panel.
* Add a new LDAP attribute `domainAliasName` to this domain account, set value
to the alias domain (e.g. `alias.com`).
* Make sure LDAP attribute `enabledService` has value `domainalias`, if not,
add it manually. Note: `enabledService` has few values by default.
2014-09-22 21:47:49 -05:00
2015-01-04 10:17:26 -06:00
Now you should add additional mail address for all mail users, lists, aliases.
For example, if you have mail user `user@example.com`, you should add additional
email address `user@alias.com` for this user. Steps:
2014-09-22 21:47:49 -05:00
2015-01-04 10:17:26 -06:00
* Find the LDAP object of mail account which you want to add additional email
2014-09-22 21:47:49 -05:00
address in left panel of phpLDAPadmin, for example, user `user@example.com`,
click the ldap object, phpLDAPadmin will show detailed LDAP attributes/values
in right panel.
* Add a new LDAP attribute `shadowAddress` to this mail account, set value to
`user@alias.com`. __WARNING__: You must user the same username part as
2014-09-22 21:47:49 -05:00
original email address.
* Save your change.
If you have several mail accounts (mail users, lists, aliases), you have to
2015-01-04 10:17:26 -06:00
add additional email address for them all.