Il Perfetto Server di Posta Push - Debian Squeeze (Debian 6.0) Con ISPConfig 3 & Z-push

Versione 1.0
Autore: Zicguy

Questo tutorial descrive l’installazione e la configurazione di Z-push su un server Debian Squeeze con ISPConfig 3.
Z-push è un’applicazione open-source per sincronizzare PDA e telefoni cellulari compatibili con ActiveSync.
Z-Push è stato inizialmente sviluppato da Zarafa Deutschland GmbH (Germania).
Alla fine di questo tutorial, i tuoi clienti dovrebbero essere in grado di sincronizzare i loro telefoni cellulari, utilizzando la tecnologia push, con i loro account e-mail memorizzati sul tuo server.

Non rilascio alcuna garanzia che questo funzionerà per te!

1 Requisiti

Per far funzionare Z-push, avrai bisogno dei seguenti:

un server Debian Squeeze completamente funzionante con ISPConfig 3,
Apache 2, Php 5 e Dovecot (utilizzando il protocollo IMAP) installati e funzionanti sul tuo server,
un telefono cellulare (ho usato un iPhone 3GS per questo tutorial).

2 Nota Preliminare

In questo tutorial, utilizzo il nome host example.com come dominio principale del server. Utilizzo anche il dominio e-mail toto.com come dominio cliente memorizzato sul server. Queste impostazioni potrebbero differire per te, quindi devi sostituirle quando è appropriato.

3 Pacchetto richiesto

Per far funzionare Z-push, il tuo server deve avere il pacchetto php-soap. Quindi, lo installiamo:

apt-get install php-soap

4 Installazione di Z-push

Possiamo ottenere Z-push scaricandolo da zarafa-deutschland.de. Naturalmente, puoi sostituire il file tar.gz con l’ultima versione stabile. Per informazione, la nuova versione 2.0.6 consente di gestire e-mail HTML con Z-push.
Come al solito, lo scarichiamo nella cartella /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

Ora, Z-push è installato sul tuo server in /usr/share/z-push.

5 Configurazione di Z-push

Z-push ha bisogno di altre due directory per funzionare: /var/lib/z-push e /var/log/z-push. Quindi, le creiamo e modifichiamo proprietari e diritti:

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

Poi, dobbiamo modificare il file /usr/share/z-push/config.php per adattarlo alle nostre esigenze:

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

Modifichiamo il

fuso orario

(e.g.

Europe/Rome

) e il

fornitore di backend

(nel nostro caso

BackendIMAP

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

6 Configurazione di Apache & PHP

Vogliamo che i nostri clienti configurino i loro telefoni cellulari con il loro dominio. Ad esempio, un cliente ha un dominio e-mail chiamato toto.com, memorizzato sul nostro server.
Vogliamo che il cliente configuri il proprio account e-mail sul proprio telefono cellulare utilizzando toto.com. Quindi, creiamo un file apache.conf in /usr/share/z-push:

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

Sarà simile a questo:

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

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

Z-Push è un’implementazione del protocollo ActiveSync, ecco perché dobbiamo usare un tale Alias.

Assicurati che PHP abbia le seguenti impostazioni:

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

Se non è così, puoi aggiungere queste righe nel /usr/share/z-push/apache.conf, all’interno del tag Directory.

Dopo di che, dobbiamo riavviare Apache per tenere conto delle modifiche:

service apache2 restart

7 Configurazione di Open Basedir PHP

L’ultima cosa che dobbiamo fare sul nostro server è configurare l’Open Basedir PHP del nostro dominio principale. Possiamo farlo utilizzando ISPConfig.
In questo tutorial, possiamo accedere a ISPConfig sotto https://example.com:8080 e accediamo con diritti di amministratore.
Sotto ISPConfig, ho creato un sito web che corrisponde a example.com.
Quindi, facciamo clic sulla scheda siti web e modifichiamo il sito web example.com. Poi, facciamo clic sulla scheda Opzioni.
Nel campo open_basedir PHP, aggiungi quanto segue alla fine della riga:

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

Questo dà accesso alle cartelle /usr/share/z-push, /var/lib/z-push e /var/log/z-push agli utenti web.

Ora, tutto è fatto sul nostro server!

8 Configurazione mobile

Possiamo ora testare se il protocollo push funziona configurando un account e-mail su un mobile. Per questo tutorial, ho usato un iPhone 3GS, ma dovrebbe funzionare anche con telefoni Android, Windows o BlackBerry.
Per farlo funzionare, dobbiamo configurare un account Exchange.
Su iPhone, andiamo in Impostazioni > Mail > Aggiungi un account. Poi, scegliamo Microsoft Exchange. Prima, dobbiamo compilare l’indirizzo e-mail, la password e la descrizione dell’account che vogliamo utilizzare.
Nella schermata successiva, dobbiamo compilare il campo server. Ad esempio, se l’indirizzo e-mail è [email protected], possiamo usare toto.com per il campo server. Usiamo l’indirizzo e-mail per il campo nome utente. Possiamo scegliere di utilizzare il protocollo SSL se è configurato sul nostro server.
Infine, convalidiamo facendo clic su OK.

È fatto! Ora, il telefono cellulare dovrebbe ricevere e-mail dal server istantaneamente…

Il Perfetto Server di Posta Push - Debian Squeeze (Debian 6.0) Con ISPConfig 3 & Z-push