What is ASSP ?
The Anti-Spam SMTP Proxy (ASSP) Server is an antispam SMTP Proxy server which implements auto-whitelists, self learning Hidden-Markov-Model(*) and/or Bayesian, Greylisting, DNSBL, DNSWL, URIBL, SPF, SRS, Backscatter, Virus scanning, attachment blocking, Senderbase and multiple other filter methods. ASSP can be controlled using an ASSP Web interface (GUI).
What is ASSP Deluxe for cPanel ?
"ASSP Deluxe for cPanel" is an ASSP frontend/integration for cPanel ; it's a set of PHP scripts which allow to install, configure, run and monitor ASSP in a cPanel server. ASSP Deluxe for cPanel includes an ASSP WHM interface, spambox IMAP for each email user, email queue finder, spam outgoing notifications, clamAV unofficial signatures support, Pyzor plugin for ASSP, automatic updates, Daily blocked email report, a cPanel ASSP frontend for users, ASSP SSL SNI and ASSP MySQL or BerkeleyDB automatic setup, ASSP Perl module automatic installation and other features. (*) ASSP v2 only
Time required to complete ASSP v1 installation 15~20 minutes.
Open cPanel WHM Service Configuration Service Manager and Disable/turn OFF SpamAssassin by unchecking SpamAssassin as shown below
Now go up in the page and be sure RecentAuthedMailIpTracker ( or the obsolete antirelayd cPanel service ) service is enabled as shown below
Now turn OFF SMTP alternative port(s) as shown below. You can setup SMTP alternative port(s) later using the ASSP Web Interface (post installation steps).
Now turn OFF cPanel Greylisting Daemon as shown below. You can enable ASSP Delaying/Greylasting later if you want.
Save Settings in Service Manager
Now click PHP tab and enable ioncube as shown below.
Save Settings in Tweak Settings
Why all EXIM ACLs settings should be set OFF in EXIM Configuration Manager ?
Simply because we want avoid antispam redundancy while running ASSP. For example we turn OFF RBL checks in EXIM because these checks are already executed by ASSP ( ASSP checks the email before EXIM ) there is no reason to do this twice.
Open cPanel WHM cPanel Manage Plugins and install ClamAV as shown below
Only if you have CSF firewall installed go to cPanel WHM Plugins ConfigServer Security & Firewall and click Firewall Configuration.
Adds ,125,25,26,587,55553,55555,2703 to TCP_IN =
Adds ,25,26,587,55553,55555,2703 to TCP_OUT =
Adds ,6277,24441 to UDP_IN =
Adds ,6277,24441 to UDP_OUT =
Set DENY_IP_LIMIT = to 500
Save Settings in CSF firewall and restart it.
Ok... WHM cPanel is configured to install ASSP. Now we can start the installation.
Now execute following commands to install ASSP Deluxe and ASSP WHM files
Once completed the commands above you can install Perl. ASSP 1.x requires Perl 5.14.0 ; it will be installed in /usr/local/perls . You can remove this custom Perl (/usr/local/perls) if you'll decide to uninstall ASSP. Execute following commands to install Perl 5.14.4 in /usr/local/perls now
Perl installation will require about 10 minutes , at the end of Perl installation execute following command to install ASSP Perl modules.
Perl module installation will require other 10 minutes, if it returns some perl module errors you may ignore them for now. Once completed execute this
Only if you have more than one /home location (e.g. /home /home2 /home3) you must enter each home location (one location per row) by editing the file /usr/local/assp/deluxe/home . For example if you have /home /home2 and /home3 your /usr/local/assp/deluxe/home file must have this
Each time you change something in this file /usr/local/assp/deluxe/home you should execute ex_localdomains.php as shown below to load new accounts and new email in ASSP. ASSP Deluxe currently accepts max 4 home locations.
Once completed return to console and execute the command below to edit your cronjobs
and add following rows ( later in the FAQs section you can learn what does these cronjobs )
Save cronjob list and exit.
Be sure to enter the rows MAILTO="" and MAILTO=root as shown above.
Every cron executed between MAILTO="" and MAILTO=root will not receive email cron notifications (each time the cron executes).
If you do not use MAILTO your email queue could be filled with email (email cron notification) generated by the crons above very fast !
Do not use > /dev/null since it will NOT work with these scripts.
Now execute this
ASSP should start correctly and you should be able to see its activity in ASSP log using this way
You should remember this important log /usr/local/assp/maillog.txt ; ASSP logs every incoming and outgoing email in this log . It's refreshed each 7 days automatically. A backup of your old ASSP logs are stored in /usr/local/assp. Each incoming and outgoing email has its own ASSP ID (e.g. id-83437-03814 ), the ASSP ID will be added in email headers too so you can identify an email blocked in ASSP log very easily. Email blocked will be collected in spambox while good email will be processed by EXIM and you will see them in EXIM log /var/log/exim_mainlog too.
Now return to ASSP WHM INTERFACE and enable ASSP SCORING MODE as shown below
By default ASSP installation the ASSP Delaying filter starts enabled. It's recommend to set if OFF now; your user can decide to swtich it ON/OFF using their cPanel user interface.
Go to ASSP WHM INTERFACE ASSP DOMAIN CONFIG , and turn/set OFF Delaying filter for ALL your domain/users, click Submit button to save settings.
Now go to ASSP WHM INTERFACE DEFAULT SETTINGS and click OFF for Delaying filter in FILTER STATUS DEFAULT SETTINGS , then press button SAVE FILTER STATUS SETTTINGS as shown below.
Even if the ASSP setup have to be completed (setting up ASSP SSL , SPAMBOX and other some settings) your ASSP is now already running and processing email, each incoming email is filtered and proxied to EXIM. All email will be checked using multiple spam filters and a numeric score point will be added by each filter ( scoring mode ) . If the scoring Penalty limit value ( MessageScoringUpperLimit ) will be surpassed the email will be collected as SPAM ( and tagged [ SPAM FOUND ] in ASSP log) , and you will see a 127.0.0.1 disconnection in EXIM log. If the scoring Penalty limit value will not be surpassed the email will be accepted ( and tagged [ MESSAGE OK ] in ASSP log ). Blocked email will be collected in /usr/local/assp/spam folder (and used to build the Bayesian database) and collected by the spambox spammaster email which delivers the SPAM in the imap /spambox folder of your users email (the spambox feature will be setup later in this HOW TO). Good email will be collected in /usr/local/assp/notspam folder (and used to build the Bayesian database) and proxied internally (127.0.0.1:125) to EXIM which will deliver the email in user INBOX .
Now you can install the ASSP Deluxe cPanel frontend for your users. Open the ASSP WHM INTERFACE and go down to Install / Upgrade Center , and click "ASSP Deluxe for cPanel frontend" for "ALL themes" as shown below.
The ASSP Deluxe cPanel frontend for your users will be installed in /usr/local/cpanel/base/frontend/yourskin/asspdeluxe and you can view the user interface by pointing your browser https://www.domain.com:2083/frontend/yourskin/asspdeluxe/index.php or click the ASSP SPAM Filter icon in the EMAIL section.
ASSP Deluxe for cPanel frontend for your users
The SPAMBOX red icon shown below will appear later when the spambox feature will be installed some step below. The HELP section is very important because explains you and your users how works the ASSP spam and notspam email interface reporting . Also after pressing the SPAMBOX red button your users can configure the spambox .
spambox requirements :
If adding a new account is an issue for you (e.g. you have a WHM license with single account limit) you can install the spambox over any existent domain . In this case follow the spambox how to for your domain name instead of fake domain spamxyz.us . In each case do NOT to install the spambox over the server hostname because it will NOT work.
note : the /spambox IMAP folder will be created after the email will receive the first SPAM email message. spambox IMAP folders are cleared automatically using the clear_spambox.php cronjob , read the FAQs section for more details.
After the spambox installation you'll see new spambox features in your ASSP WHM INTERFACE which allows you to check spamboxes (SPAM FINDER) , enable/disable spambox for your users, and set spambox IMAP default status for new accounts.
Installation is almost complete, at this point your ASSP should be running correctly with SSL, spambox and preconfigured with moderate antispam settings. There are few more simple steps required to run your ASSP at the best.
Finally it's time to open the ASSP GUI to set ASSP GUI password and some few configurations. Go to ASSP WHM INTERFACE and click ASSP WEB INTERFACE . Your ASSP WEB INTERFACE (GUI) should open you can login with..
note : there are various ASSP web interface parameters which are controlled by ASSP Deluxe for cPanel. All parameters controlled by ASSP Deluxe are listed in ASSP WHM INTERFACE AUTOMATION SETTINGS . If you are an experienced ASSP administrator and you want customize some of these parameters you should set OFF the parameter you want customize in AUTOMATION SETTINGS page.
Now to compete the ASSP v1 setup I recommend you to take only a look to your ASSP GUI and its detailed parameters description and to apply only following change (ASSP password).
If you want change your ASSP GUI password go to "Admministration Interface" menu , go down to "Web Admin Password (webAdminPassword)" and set a new password, then click "APPLY" in your ASSP GUI. Be sure to note the new password carefully because the password will be encrypted and cannot be changed by editing the assp.cfg file. You can close the ASSP WEB INTERFACE for now.
Ok... ASSP v1 installation is completed and all should work correctly . All incoming email should be filtered and everything should work correctly. Now you can check the Post installation steps and FAQs page. You can learn how to STOP fully ASSP and return instantly to cPanel only , how to restart ASSP from console, and other important administrative tasks.