Utilisation de RoundCube Webmail avec ISPConfig 3 sur Debian Wheezy (nginx)

Ce guide explique comment installer l’application webmail RoundCube sur un serveur Debian Wheezy exécutant ISPConfig et nginx, et comment activer les plugins ISPConfig 3 pour RoundCube afin que les utilisateurs puissent effectuer des actions telles que changer leurs mots de passe d’email depuis RoundCube. Roundcube webmail est un client IMAP multilingue basé sur un navigateur avec une interface utilisateur semblable à une application ; il est livré avec des fonctions telles que le support MIME, un carnet d’adresses, la manipulation de dossiers, la recherche de messages et la vérification orthographique.

Je ne donne aucune garantie que cela fonctionnera pour vous !

1 Remarque Préliminaire

Ce tutoriel suppose que vous utilisez nginx comme serveur web sur votre serveur ISPConfig 3 ; ce tutoriel ne fonctionnera pas pour Apache. Je vais installer RoundCube à partir des dépôts Debian Wheezy - c’est une version raisonnablement récente (0.7.2.9 contre 0.9.1 (version stable actuelle)).

Je vais montrer comment configurer un vhost pour RoundCube afin qu’il puisse être accessible via l’alias /webmail (par exemple, http://www.example.com/webmail).

2 Création d’un Utilisateur Distant dans ISPConfig

Les plugins ISPConfig 3 pour RoundCube fonctionnent via l’API distante d’ISPConfig. Pour utiliser cette API, nous avons besoin d’un utilisateur distant. Pour créer un tel utilisateur, allez dans Système > Gestion des utilisateurs > Utilisateurs distants et cliquez sur le bouton Ajouter un nouvel utilisateur :

Fournissez un nom d’utilisateur et un mot de passe pour l’utilisateur…

… et activez les fonctions suivantes :

Fonctions serveur
Fonctions client
Fonctions utilisateur de mail
Fonctions alias de mail
Fonctions utilisateur de filtre anti-spam de mail
Fonctions de politique de filtre anti-spam de mail
Fonctions fetchmail de mail
Fonctions de liste blanche de filtre anti-spam de mail
Fonctions de liste noire de filtre anti-spam de mail
Fonctions de filtre utilisateur de mail

Puis cliquez sur Enregistrer.

3 Installation de RoundCube

Nous pouvons installer RoundCube comme suit :

apt-get install roundcube roundcube-plugins roundcube-plugins-extra

Vous verrez les questions suivantes :

Configurer la base de données pour roundcube avec dbconfig-common ? <– Oui
Type de base de données à utiliser par roundcube : <– mysql
Mot de passe de l’utilisateur administratif de la base de données : <– votremotdepasseadminsql (le mot de passe de l’utilisateur root MySQL)
Mot de passe de l’application MySQL pour roundcube : <– motdepasseSQLroundcube
Confirmation du mot de passe : <– motdepasseSQLroundcube

Cela créera une base de données MySQL appelée roundcube avec l’utilisateur MySQL roundcube et le mot de passe motdepasseSQLroundcube.

Ensuite, allez sur votre site web dans ISPConfig. Dans l’onglet Options, vous verrez le champ Directives nginx :

Remplissez les directives suivantes et cliquez sur Enregistrer (peu importe si vous avez PHP activé pour ce vhost ou non car ce snippet de code utilise le PHP par défaut du système qui s’exécute sous l’utilisateur et le groupe www-data, ce qui est important car RoundCube est installé en dehors de la racine du document du vhost - dans /var/lib/roundcube) :

| client_max_body_size 100M; location /roundcube { root /var/lib/; index index.php index.html index.htm; location ~ (.+\.php)$ { try_files $uri =404; include /etc/nginx/fastcgi_params; # Pour accéder à SquirrelMail, l'utilisateur par défaut (comme www-data sur Debian/Ubuntu) doit être utilisé #fastcgi_pass 127.0.0.1:9000; fastcgi_pass unix:/var/run/php5-fpm.sock; fastcgi_index index.php; fastcgi_intercept_errors on; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_buffer_size 128k; fastcgi_buffers 256 4k; fastcgi_busy_buffers_size 256k; fastcgi_temp_file_write_size 256k; } location ~* /.svn/ { deny all; } location ~* /README|INSTALL|LICENSE|SQL|bin|CHANGELOG$ { deny all; } } location /webmail { rewrite ^ /roundcube last; } |

Avec cette configuration, RoundCube sera accessible sous les URL http://www.example.com/webmail et http://www.example.com/roundcube.

4 Configuration de RoundCube

Ouvrez /etc/roundcube/main.inc.php…

vi /etc/roundcube/main.inc.php

… et définissez $rcmail_config[‘default_host’] = ‘localhost’; (ou le nom d’hôte ou l’adresse IP de votre serveur de mail s’il est sur une machine distante) :

| [...] $rcmail_config['default_host'] = 'localhost'; [...] |

Sinon, RoundCube demandera un nom d’hôte avant chaque connexion, ce qui pourrait surcharger vos utilisateurs - nous voulons rendre l’utilisation aussi facile que possible.

Ensuite, installez les plugins ISPConfig 3 pour RoundCube :

cd /tmp  
git clone https://github.com/w2c/ispconfig3_roundcube.git  
cd /tmp/ispconfig3_roundcube/  
mv ispconfig3_* /usr/share/roundcube/  
cd /usr/share/roundcube/  
mv ispconfig3_account/config/config.inc.php.dist ispconfig3_account/config/config.inc.php  
ln -s /usr/share/roundcube/ispconfig3_* /var/lib/roundcube/plugins/

Ouvrez ispconfig3_account/config/config.inc.php…

vi ispconfig3_account/config/config.inc.php

… et remplissez les détails de connexion de votre utilisateur distant ISPConfig et l’URL de l’API distante - mon installation ISPConfig fonctionne sur https://192.168.0.100:8080, donc l’URL de l’API distante est https://192.168.0.100:8080/remote/ :

| |

Enfin, ouvrez à nouveau /etc/roundcube/main.inc.php…

vi /etc/roundcube/main.inc.php

… et activez le plugin jquerui ainsi que les plugins ISPConfig 3…

| [...] // ---------------------------------- // PLUGINS // ---------------------------------- // Liste des plugins actifs (dans le répertoire plugins/) //$rcmail_config['plugins'] = array(); $rcmail_config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter"); [...] |

… et changez le thème de par défaut à classique (sinon les plugins ISPConfig 3 ne fonctionneront pas) :

| [...] // nom du skin : dossier de skins/ $rcmail_config['skin'] = 'classic'; [...] |

C’est tout ; maintenant vous pouvez accéder à RoundCube sous l’alias /webmail (par exemple www.example.com/webmail). Connectez-vous avec l’adresse email et le mot de passe d’un compte email créé via ISPConfig :