diff --git a/en_US/howto/amavisd.wblist.md b/en_US/howto/amavisd.wblist.md new file mode 100644 index 00000000..04b99693 --- /dev/null +++ b/en_US/howto/amavisd.wblist.md @@ -0,0 +1,64 @@ +# Whitelists and Blacklists + +[TOC] + +This tutorial shows you how to whitelist and blacklist senders or recipients +with iRedAdmin-Pro and script shipped in iRedAPD (since iRedAPD-1.7.1). + +## Manage whitelists and blacklists with iRedAdmin-Pro + +With iRedAdmin-Pro, you can manage several levels of whitelists and blacklists: + +* Global white/blacklists: under menu `System -> Anti Spam -> Whitelists & Blacklists`. +* Per-domain white/blacklists: in domain profile page, under tab `Whitelists and Blacklists`. +* Per-user white/blacklists: in user profile page, under tab `Whitelists and Blacklists`. + +Screenshot attached below. + +## Manage whitelists and blacklists with SQL commands + +Since iRedAPD-1.7.1, iRedAPD ships script `tools/wblist_admin.py` to help you +manage white/blacklists. To get full usage message, please run this script +without argument like this: + +``` +# cd /opt/iredapd/tools/ +# python wblist_admin.py +``` + +Sample usages: + +* Add server-wide whitelisted or blacklisted senders: + +``` +# python wblist_admin.py --add --whitelist 202.96.134.133 john@example.com @test.com @.abc.com +# python wblist_admin.py --add --blacklist 202.96.134.133 john@example.com @test.com @.abc.com +``` + +* Show server-wide whitelisted and blacklisted senders: + +``` +# python wblist_admin.py --list --whitelist +# python wblist_admin.py --list --blacklist +``` + +* For per-domain or per-user white/blacklists, please add argument `--account`. + like below: + +``` +# python wblist_admin.py --account mydomain.com --add --whitelist 202.96.134.133 +# python wblist_admin.py --account user@mydomain.com --add --blacklist 202.96.134.133 + +# python wblist_admin.py --account mydomain.com --list --whitelist +# python wblist_admin.py --account user@mydomain.com --list --blacklist +``` + +* For outbound messages, please add argument `--outbound`. like below: + +``` +# python wblist_admin.py --outbound --account mydomain.com --add --whitelist 202.96.134.133 +``` + +Screenshot of iRedAdmin-Pro: + +![](http://www.iredmail.org/images/iredadmin/system_wblist.png) diff --git a/en_US/upgrade/0-upgrade.iredmail.0.9.2-0.9.3.md b/en_US/upgrade/0-upgrade.iredmail.0.9.2-0.9.3.md index 1fad6ba5..8b21b082 100644 --- a/en_US/upgrade/0-upgrade.iredmail.0.9.2-0.9.3.md +++ b/en_US/upgrade/0-upgrade.iredmail.0.9.2-0.9.3.md @@ -51,6 +51,8 @@ Detailed release notes are available [here](./iredapd.releases.html). ### Migrate from Cluebringer to iRedAPD +> NOTE: If your server doesn't have Cluebringer installed, please ignore this step. + In iRedMail-0.9.3, Cluebringer has been removed and replaced by iRedAPD. Cluebringer is not under active development and no new release since 2013 (the latest stable release doesn't support IPv6). iRedAPD offers greylisting and @@ -67,6 +69,8 @@ throttling settings from Cluebringer to iRedAPD: Please follow Roundcube official tutorial to upgrade Roundcube webmail to the latest stable release immediately: [How to upgrade Roundcube](http://trac.roundcube.net/wiki/Howto_Upgrade) +Note: package `rsync` must be installed on your server before upgrading. + ### Postfix: Add additional aliases ClamAV may detect virus in email, notification will be sent to system account @@ -147,8 +151,8 @@ $originating = 1; * Open Postfix config file `/etc/postfix/master.cf` (Linux/OpenBSD) or `/usr/local/etc/postfix/master.cf` (FreeBSD), update transport `submission` - to use `content_filter=smtp-amavis:[127.0.0.1]:10026` as content filter like - below: + to uncomment `content_filter=smtp-amavis:[127.0.0.1]:10026` line, so that we + can use Amavisd with policy bank `ORIGINATING` as content filter. like below: ``` submission inet n - n - - smtpd diff --git a/en_US/upgrade/0-upgrade.iredmail.0.9.3-0.9.4.md b/en_US/upgrade/0-upgrade.iredmail.0.9.3-0.9.4.md index 54477f56..351e0ef6 100644 --- a/en_US/upgrade/0-upgrade.iredmail.0.9.3-0.9.4.md +++ b/en_US/upgrade/0-upgrade.iredmail.0.9.3-0.9.4.md @@ -40,3 +40,4 @@ Detailed release notes are available [here](./iredapd.releases.html). Please follow Roundcube official tutorial to upgrade Roundcube webmail to the latest stable release immediately: [How to upgrade Roundcube](http://trac.roundcube.net/wiki/Howto_Upgrade) +Note: package `rsync` must be installed on your server before upgrading. diff --git a/html/amavisd.wblist.html b/html/amavisd.wblist.html new file mode 100644 index 00000000..3758f495 --- /dev/null +++ b/html/amavisd.wblist.html @@ -0,0 +1,83 @@ + + + + Whitelists and Blacklists + + + + +

Whitelists and Blacklists

+
+ +
+

This tutorial shows you how to whitelist and blacklist senders or recipients +with iRedAdmin-Pro and script shipped in iRedAPD (since iRedAPD-1.7.1).

+

Manage whitelists and blacklists with iRedAdmin-Pro

+

With iRedAdmin-Pro, you can manage several levels of whitelists and blacklists:

+ +

Screenshot attached below.

+

Manage whitelists and blacklists with SQL commands

+

Since iRedAPD-1.7.1, iRedAPD ships script tools/wblist_admin.py to help you +manage white/blacklists. To get full usage message, please run this script +without argument like this:

+
# cd /opt/iredapd/tools/
+# python wblist_admin.py
+
+ +

Sample usages:

+ +
# python wblist_admin.py --add --whitelist 202.96.134.133 john@example.com @test.com @.abc.com
+# python wblist_admin.py --add --blacklist 202.96.134.133 john@example.com @test.com @.abc.com
+
+ + +
# python wblist_admin.py --list --whitelist
+# python wblist_admin.py --list --blacklist
+
+ + +
# python wblist_admin.py --account mydomain.com --add --whitelist 202.96.134.133
+# python wblist_admin.py --account user@mydomain.com --add --blacklist 202.96.134.133
+
+# python wblist_admin.py --account mydomain.com --list --whitelist
+# python wblist_admin.py --account user@mydomain.com --list --blacklist
+
+ + +
# python wblist_admin.py --outbound --account mydomain.com --add --whitelist 202.96.134.133
+
+ +

Screenshot of iRedAdmin-Pro:

+

All documents are available in BitBucket repository, and published under Creative Commons license. If you found something wrong, please do contact us to fix it. + \ No newline at end of file diff --git a/html/index.html b/html/index.html index e98390b6..aa1b1ba6 100644 --- a/html/index.html +++ b/html/index.html @@ -84,6 +84,7 @@

  • Allow member to send email as mailing list or mail alias
  • Allow user to send email without smtp authentication
  • Amavisd: Enable per-recipient policy lookup
    • +
  • Whitelists and Blacklists
  • Authenticate without domain part in email address
  • Change server hostname
  • Process more emails concurrently
    • diff --git a/html/upgrade.iredmail.0.9.2-0.9.3.html b/html/upgrade.iredmail.0.9.2-0.9.3.html index 9d88dd8f..af41a76f 100644 --- a/html/upgrade.iredmail.0.9.2-0.9.3.html +++ b/html/upgrade.iredmail.0.9.2-0.9.3.html @@ -102,6 +102,9 @@ sql> INSERT INTO greylisting (account, priority, sender, sender_priority, act

    Detailed release notes are available here.

    Migrate from Cluebringer to iRedAPD

    +
    +

    NOTE: If your server doesn't have Cluebringer installed, please ignore this step.

    +

    In iRedMail-0.9.3, Cluebringer has been removed and replaced by iRedAPD. Cluebringer is not under active development and no new release since 2013 (the latest stable release doesn't support IPv6). iRedAPD offers greylisting and @@ -117,6 +120,7 @@ in next iRedAdmin-Pro release.

    Upgrade Roundcube webmail to the latest stable release

    Please follow Roundcube official tutorial to upgrade Roundcube webmail to the latest stable release immediately: How to upgrade Roundcube

    +

    Note: package rsync must be installed on your server before upgrading.

    Postfix: Add additional aliases

    ClamAV may detect virus in email, notification will be sent to system account virusalert.

    @@ -197,8 +201,8 @@ quarantined mails.

  • Open Postfix config file /etc/postfix/master.cf (Linux/OpenBSD) or /usr/local/etc/postfix/master.cf (FreeBSD), update transport submission - to use content_filter=smtp-amavis:[127.0.0.1]:10026 as content filter like - below:

    + to uncomment content_filter=smtp-amavis:[127.0.0.1]:10026 line, so that we + can use Amavisd with policy bank ORIGINATING as content filter. like below:

    • submission inet n       -       n       -       -       smtpd
diff --git a/html/upgrade.iredmail.0.9.3-0.9.4.html b/html/upgrade.iredmail.0.9.3-0.9.4.html
index fc66984d..40ec35bf 100644
--- a/html/upgrade.iredmail.0.9.3-0.9.4.html
+++ b/html/upgrade.iredmail.0.9.3-0.9.4.html
@@ -51,7 +51,8 @@ latest stable release:
 
    Detailed release notes are available here.
    
 
    Upgrade Roundcube webmail to the latest stable release
    
 
    Please follow Roundcube official tutorial to upgrade Roundcube webmail to the
-latest stable release immediately: How to upgrade Roundcube
    All documents are available in BitBucket repository, and published under Creative Commons license. If you found something wrong, please do contact us to fix it.