2015-02-01 05:22:03 -06:00
|
|
|
# SQL: Add a mail alias account
|
|
|
|
|
|
|
|
[TOC]
|
|
|
|
|
|
|
|
## Create mail alias account with iRedAdmin-Pro
|
|
|
|
|
|
|
|
With iRedAdmin-Pro, you can easily add mail list account by click menu:
|
2015-08-04 22:07:00 -05:00
|
|
|
`Add -> Mail List` (or `Add -> Alias` for SQL backends) in main
|
2015-08-01 23:20:30 -05:00
|
|
|
navigation bar.
|
2015-02-01 05:22:03 -06:00
|
|
|
|
|
|
|
![](../images/iredadmin/maillist_create.png)
|
|
|
|
|
|
|
|
## Create mail alias account with SQL command line
|
2014-09-22 21:47:49 -05:00
|
|
|
|
|
|
|
To create an mail alias account, you can simply insert a SQL record in table
|
|
|
|
`vmail.alias`. For example:
|
|
|
|
|
|
|
|
```mysql
|
|
|
|
sql> USE vmail;
|
2015-02-24 01:47:50 -06:00
|
|
|
sql> INSERT INTO alias (address, goto, domain, islist) \
|
2014-09-22 21:47:49 -05:00
|
|
|
VALUES ('original@example.com', \
|
|
|
|
'user1@example.com,user2@example.com,user1@test.com', \
|
2015-02-20 08:02:03 -06:00
|
|
|
'example.com', \
|
|
|
|
1);
|
2014-09-22 21:47:49 -05:00
|
|
|
```
|
|
|
|
|
|
|
|
__NOTES__:
|
|
|
|
|
|
|
|
* Please always use lower cases for email addresses.
|
2015-02-20 08:02:03 -06:00
|
|
|
* Multiple destination addresses must be separated by comma.
|
|
|
|
* If destination address is a mail user under domain hosted on localhost,
|
2014-09-22 21:47:49 -05:00
|
|
|
it must exist. Otherwise emails sent to alias account will be bounced after
|
|
|
|
expanded to destination addresses.
|
2015-02-01 05:22:03 -06:00
|
|
|
|
|
|
|
## Access policy
|
|
|
|
|
|
|
|
You can restrict which senders are allowed to send email to this mail alias
|
|
|
|
account by adding proper policy name in SQL column `alias.accesspolicy`.
|
|
|
|
For example:
|
|
|
|
|
|
|
|
```
|
|
|
|
sql> UPDATE alias SET accesspolicy='domain' WHERE address='original@example.com';
|
|
|
|
```
|
|
|
|
|
|
|
|
Available access policies are:
|
|
|
|
|
|
|
|
* `public`: no restrictions.
|
|
|
|
* `domain`: all users under same domain are allowed to send email to this mail list.
|
|
|
|
* `subdomain`: all users under same domain and sub-domains are allowed to send email to this mail list.
|
|
|
|
* `membersOnly`: only members of this mail list are allowd.
|
2015-08-31 18:38:13 -05:00
|
|
|
* `allowedOnly`: only moderators of this mail list are allowed. Moderators
|
2015-02-01 05:22:03 -06:00
|
|
|
are email addresses stored in SQL column `alias.moderators`. With iRedAPD-1.4.5,
|
|
|
|
it's ok to use `*@domain.com` as (one of) moderator for all users under
|
|
|
|
mail domain 'domain.com'.
|
2017-04-08 08:24:37 -05:00
|
|
|
* `membersAndModeratorsOnly`: only members and moderators of this mail list are allowed.
|
2015-02-01 05:22:03 -06:00
|
|
|
|
|
|
|
Access restriction is implemented in iRedAPD (a simple Postfix policy server),
|
|
|
|
iRedMail has it enabled by default. You'd better check its config file
|
|
|
|
`/opt/iredapd/settings.py` to make sure plugin `sql_alias_access_policy` is
|
|
|
|
enabled in parameter `plugins = []`.
|
|
|
|
|
|
|
|
## See also
|
|
|
|
|
|
|
|
* [Create mailing list for OpenLDAP backend](./ldap.add.mail.list.html)
|