Le Serveur Mail Push Parfait - Debian Squeeze (Debian 6.0) Avec ISPConfig 3 & Z-push

Version 1.0
Auteur : Zicguy

Ce tutoriel décrit l’installation et la configuration de Z-push sur un serveur Debian Squeeze avec ISPConfig 3.
Z-push est une application open-source pour synchroniser les PDA et les téléphones mobiles compatibles ActiveSync.
Z-Push a été initialement développé par Zarafa Deutschland GmbH (Allemagne).
À la fin de ce tutoriel, vos clients devraient être en mesure de synchroniser leurs téléphones mobiles, en utilisant la technologie push, avec leurs comptes e-mail stockés sur votre serveur.

Je ne donne aucune garantie que cela fonctionnera pour vous !

1 Exigences

Pour faire fonctionner Z-push, vous aurez besoin des éléments suivants :

un serveur Debian Squeeze entièrement fonctionnel avec ISPConfig 3,
Apache 2, Php 5 et Dovecot (utilisant le protocole IMAP) installés et fonctionnels sur votre serveur,
un téléphone mobile (j’ai utilisé un iPhone 3GS pour ce tutoriel).

2 Remarque Préliminaire

Dans ce tutoriel, j’utilise le nom d’hôte example.com comme domaine principal du serveur. J’utilise également le domaine e-mail toto.com comme domaine client stocké sur le serveur. Ces paramètres peuvent différer pour vous, donc vous devez les remplacer lorsque c’est approprié.

3 Paquet Requis

Pour faire fonctionner Z-push, votre serveur doit avoir le paquet php-soap. Donc, nous l’installons :

apt-get install php-soap

4 Installation de Z-push

Nous pouvons obtenir Z-push en le téléchargeant depuis zarafa-deutschland.de. Bien sûr, vous pouvez remplacer le fichier tar.gz par la dernière version stable. Pour information, la nouvelle version 2.0.6 permet de gérer les e-mails HTML avec Z-push.
Comme d’habitude, nous le téléchargeons dans le dossier /tmp :

cd /tmp
wget zarafa-deutschland.de/z-push-download/final/2.0/z-push-2.0.6-1616.tar.gz
tar -xzvf z-push-2.0.6-1616.tar.gz
mkdir -p /usr/share/z-push
cp -R z-push-2.0.6-1616/ /usr/share/z-push
rm -rf z-push

Maintenant, Z-push est installé sur votre serveur dans /usr/share/z-push.

5 Configuration de Z-push

Z-push a besoin de deux autres répertoires pour fonctionner : /var/lib/z-push et /var/log/z-push. Donc, nous les créons et nous modifions les propriétaires et les droits :

mkdir -p /var/lib/z-push
mkdir -p /var/log/z-push
chown www-data:www-data /var/lib/z-push
chown www-data:www-data /var/log/z-push
chmod 750 /var/lib/z-push
chmod 750 /var/log/z-push

Ensuite, nous devons modifier le fichier /usr/share/z-push/config.php pour l’adapter à nos besoins :

vi /usr/share/z-push/config.php

Nous modifions le

fuseau horaire

(par exemple,

Europe/Paris

) et le

fournisseur de backend

(dans notre cas

BackendIMAP

) :

[...]
define('TIMEZONE', 'Europe/Paris');
[...]
define('BACKEND_PROVIDER', "BackendIMAP");
[...]

6 Configuration d’Apache & PHP

Nous voulons que nos clients configurent leurs téléphones mobiles avec leur propre domaine. Par exemple, un client a un domaine e-mail appelé toto.com, stocké sur notre serveur.
Nous voulons que le client configure son compte e-mail sur son téléphone mobile en utilisant toto.com. Donc, nous créons un fichier apache.conf dans /usr/share/z-push :

vi /usr/share/z-push/apache.conf

Il ressemblera à ceci :

Alias /Microsoft-Server-ActiveSync /usr/share/z-push/index.php

      Options -Indexes
      AllowOverride None
      Order allow,deny
      allow from all

Z-Push est une implémentation du protocole ActiveSync, c’est pourquoi nous devons utiliser un tel Alias.

Assurez-vous que PHP a les paramètres suivants :

php_flag magic_quotes_gpc off
php_flag register_globals off
php_flag magic_quotes_runtime off
php_flag short_open_tag on

Si ce n’est pas le cas, vous pouvez ajouter ces lignes dans le /usr/share/z-push/apache.conf, à l’intérieur de la balise Directory.

Après cela, nous devons redémarrer Apache pour prendre en compte les changements :

service apache2 restart

7 Configuration Open Basedir PHP

La dernière chose que nous devons faire sur notre serveur est de configurer l’Open Basedir PHP de notre domaine principal. Nous pouvons le faire en utilisant ISPConfig.
Dans ce tutoriel, nous pouvons accéder à ISPConfig sous https://example.com:8080 et nous nous connectons avec des droits d’administrateur.
Sous ISPConfig, j’ai créé un site web qui correspond à example.com.
Donc, nous cliquons sur l’onglet des sites web et éditons le site example.com. Ensuite, nous cliquons sur l’onglet Options.
Dans le champ open_basedir PHP, ajoutez ce qui suit à la fin de la ligne :

:/usr/share/z-push:/var/lib/z-push:/var/log/z-push

Cela donne accès aux dossiers /usr/share/z-push, /var/lib/z-push et /var/log/z-push aux utilisateurs web.

Maintenant, tout est fait sur notre serveur !

8 Configuration Mobile

Nous pouvons maintenant tester si le protocole push fonctionne en configurant un compte e-mail sur un mobile. Pour ce tutoriel, j’ai utilisé un iPhone 3GS, mais cela devrait également fonctionner avec des mobiles Android, Windows ou BlackBerry.
Pour que cela fonctionne, nous devons configurer un compte Exchange.
Sur l’iPhone, nous allons dans Réglages > Mail > Ajouter un compte. Ensuite, nous choisissons Microsoft Exchange. D’abord, nous devons remplir l’adresse e-mail, le mot de passe et la description du compte que nous voulons utiliser.
À l’écran suivant, nous devons remplir le champ serveur. Par exemple, si l’adresse e-mail est [email protected], nous pouvons utiliser toto.com pour le champ serveur. Nous utilisons l’adresse e-mail pour le champ nom d’utilisateur. Nous pouvons choisir d’utiliser le protocole SSL s’il est configuré sur notre serveur.
Enfin, nous validons en cliquant sur OK.

C’est fait ! Maintenant, le téléphone mobile devrait recevoir des e-mails du serveur instantanément…

Le Serveur Mail Push Parfait - Debian Squeeze (Debian 6.0) Avec ISPConfig 3 & Z-push