This tutorial covers installing and configuring the DSPAM web frontend. Using the web frontend, the mail users can configure the sensitivity of the spam filter, see statistics and more.

I assume you already have the Apache2 web server and DSPAM daemon installed.

1. Install the dspam-webfrontend package and suexec module for the Apache2 web server.

apt-get install dspam-webfrontend apache2-suexec


2. Enable the suexec module

a2enmod suexec


3. Configure the default web site to allow access to DSPAM webfrontend. Append these lines to the file somewhere between <VirtualHost *:80></VirtualHost> (pico /etc/apache2/sites-enabled/000-default)

SuexecUserGroup dspam dspam
Addhandler cgi-script .cgi
Options +ExecCGI -Indexes
 
Alias /dspam /var/www/dspam/
<Directory /var/www/dspam/>
Addhandler cgi-script .cgi
Options +ExecCGI -Indexes
DirectoryIndex dspam.cgi
 
AuthType Basic
AuthName "DSPAM Control Center"
AuthUserFile /etc/dspam/webfrontend.htpasswd
Require valid-user
 
AllowOverride None
</Directory>


4. Create a file containing users that have access to the webfrontend

htpasswd -c /etc/dspam/webfrontend.htpasswd user1


Change user1 into the username you want to allow access. The username must match the username used by you mail server to indentify the mail box so you may want to use other authentication backend to match the one used by you mail server.

Now you can access the webfrontend by entering http://yourserver/dspam/ in your web browser.