Installation de Maia Mailguard sur Debian Squeeze (Utilisateurs/Domains Virtuels avec Postfix/MySQL)

Version 1.0
Auteurs : Falko Timme, Dominik Najberg

Ce guide explique comment installer Maia Mailguard, un système de gestion de spam et de virus, sur un serveur de messagerie Debian Squeeze. Maia Mailguard est une interface web et un système de gestion basé sur le populaire scanner de courriels amavisd-new et SpamAssassin. Écrit en Perl et PHP, Maia Mailguard donne aux utilisateurs finaux le contrôle sur la façon dont leur courrier est traité par les scanners de virus et les filtres anti-spam, tout en donnant aux administrateurs de messagerie le pouvoir de configurer des valeurs et des limites par défaut sur l’ensemble du site.

Je ne donne aucune garantie que cela fonctionnera pour vous !

1 Remarque Préliminaire

Ce tutoriel est basé sur Utilisateurs et Domaines Virtuels avec Postfix, Courier, MySQL et SquirrelMail (Debian Squeeze), donc vous devriez déjà avoir cela configuré. Si votre configuration de messagerie est différente, ce tutoriel pourrait ne pas fonctionner pour vous, ou vous pourriez avoir à faire quelques ajustements.

Mon serveur a le nom d’hôte mail.example.com et l’adresse IP 192.168.0.1. J’installerai l’interface web de Maia dans le répertoire racine par défaut de lighttpd de Debian, /var/www, et j’utiliserai www.example.com pour accéder à l’interface web. Vous devrez ajuster cela si votre répertoire racine et votre domaine diffèrent.

2 Téléchargement de Maia Mailguard

Maia Mailguard ne peut être téléchargé que depuis SVN, donc nous devons d’abord installer Subversion :

aptitude install subversion

Je veux télécharger les sources dans /usr/src/maia :

mkdir /usr/src/maia  
cd /usr/src/maia

Ouvrez un navigateur et allez sur https://www.maiamailguard.com/svn/branches/1.0 pour découvrir quelle est la dernière révision - dans mon cas, c’était 1578. Ensuite, commencez le téléchargement comme suit :

svn -r 1578 checkout https://www.maiamailguard.com/svn/branches/1.0

(Assurez-vous de remplacer 1578 par la dernière révision.)

3 Création d’une Base de Données pour Maia Mailguard

Ensuite, connectez-vous à MySQL…

mysql -u root -p

… et créez une base de données appelée maia :

CREATE DATABASE maia;

Quittez ensuite le shell MySQL :

quit;

Importez le dump SQL de Maia dans la base de données maia vide :

cd /usr/src/maia/1.0/  
mysql -u root -p maia < maia-mysql.sql

Puis reconnectez-vous à MySQL…

mysql -u root -p maia

… et créez un utilisateur MySQL appelé amavis :

GRANT CREATE, DROP, ALTER, SELECT, INSERT, UPDATE, DELETE ON maia.* TO amavis@localhost IDENTIFIED BY 'amavismysqlpasswd';

FLUSH PRIVILEGES;

Corrigez le problème de colonne inconnue ‘discard_ham’ qui empêche l’envoi d’e-mails :

ALTER TABLE users ADD COLUMN discard_ham char(1) NOT NULL default 'N'

Quittez MySQL :

quit;

(Vous pouvez remplacer amavismysqlpasswd par un mot de passe de votre choix, mais gardez à l’esprit que vous devrez utiliser ce mot de passe plus tard dans la configuration de Maia !)

Ensuite, assurez-vous d’avoir une valeur suffisamment grande pour max_allowed_packet dans votre /etc/mysql/my.cnf (dans la section [mysqld]). Ce paramètre détermine la taille du plus grand élément de courrier que vous pourrez traiter avec Maia, donc assurez-vous de définir cette valeur suffisamment grande pour répondre à vos besoins.

nano /etc/mysql/my.cnf

| [...] [mysqld] [...] max_allowed_packet = 16M [...] |

Redémarrez MySQL si vous avez changé la valeur de max_allowed_packet :

/etc/init.d/mysql restart

4 Installation des Scripts et Modèles de Maia

Le répertoire personnel de l’utilisateur amavis sur Debian Squeeze est /var/lib/amavis, et c’est là que nous créons un sous-répertoire appelé maia. Dans ce sous-répertoire, nous placerons les scripts et modèles de Maia :

mkdir /var/lib/amavis/maia  
mkdir /var/lib/amavis/maia/scripts  
mkdir /var/lib/amavis/maia/templates

cp -pfr /usr/src/maia/1.0/scripts/* /var/lib/amavis/maia/scripts  
cp -pfr /usr/src/maia/1.0/templates/* /var/lib/amavis/maia/templates

chown -R amavis /var/lib/amavis/maia  
chgrp -R amavis /var/lib/amavis/maia  
chmod 640 /var/lib/amavis/maia/templates/*.tpl  
chmod 750 /var/lib/amavis/maia/scripts/*.pl

5 Configuration de Maia

Ensuite, nous renommons /usr/src/maia/1.0/maia.conf.dist en /etc/maia/maia.conf :

mkdir /etc/maia/  
cp /usr/src/maia/1.0/maia.conf.dist /etc/maia/maia.conf  
chown amavis /etc/maia/maia.conf  
chgrp amavis /etc/maia/maia.conf  
chmod 640 /etc/maia/maia.conf

Ouvrez /etc/maia/maia.conf et ajustez les paramètres suivants :

nano /etc/maia/maia.conf

| [...] # Configurez votre DSN de base de données Maia ici $dsn = "DBI:mysql:maia:localhost:3306"; # Le nom d'utilisateur de votre base de données Maia $username = "amavis"; # Le mot de passe de votre utilisateur de base de données Maia $password = "amavismysqlpasswd"; # Le répertoire où se trouvent les scripts Perl de Maia. $script_dir = "/var/lib/amavis/maia/scripts"; [...] # Emplacement pour écrire les fichiers de verrouillage/PID (doit être accessible en écriture par votre # utilisateur amavis) $pid_dir = "/var/lib/amavis/"; [...] # URL de base pour les scripts PHP de Maia $base_url = "http://www.example.com/"; # Répertoire des modèles $template_dir = "/var/lib/amavis/maia/templates/"; [...] |

Assurez-vous de remplir le mot de passe correct pour l’utilisateur MySQL amavis dans la ligne $password. Remplissez également l’URL correcte dans la ligne $base_url.