O Servidor de E-mail Push Perfeito - Debian Squeeze (Debian 6.0) Com ISPConfig 3 & Z-push

Versão 1.0
Autor: Zicguy

Este tutorial descreve a instalação e configuração do Z-push em um servidor Debian Squeeze com ISPConfig 3.
O Z-push é uma aplicação de código aberto para sincronizar PDAs e telefones móveis compatíveis com ActiveSync.
O Z-Push foi inicialmente desenvolvido pela Zarafa Deutschland GmbH (Alemanha).
No final deste tutorial, seus clientes devem ser capazes de sincronizar seus telefones móveis, usando tecnologia push, com suas contas de e-mail armazenadas em seu servidor.

Não dou nenhuma garantia de que isso funcionará para você!

1 Requisitos

Para fazer o Z-push funcionar, você precisará do seguinte:

um servidor Debian Squeeze totalmente funcional com ISPConfig 3,
Apache 2, Php 5 e Dovecot (usando o protocolo IMAP) instalados e funcionando em seu servidor,
um telefone móvel (usei um iPhone 3GS para este tutorial).

2 Nota Preliminar

Neste tutorial, uso o nome de host example.com como o domínio principal do servidor. Também uso o domínio de e-mail toto.com como um domínio de cliente armazenado no servidor. Essas configurações podem diferir para você, então você deve substituí-las quando apropriado.

3 Pacote necessário

Para fazer o Z-push funcionar, seu servidor deve ter o pacote php-soap. Então, vamos instalá-lo:

apt-get install php-soap

4 Instalação do Z-push

Podemos obter o Z-push baixando-o de zarafa-deutschland.de. Claro, você pode substituir o arquivo tar.gz pela última versão estável. Para informação, a nova versão 2.0.6 permite gerenciar e-mails em HTML com o Z-push.
Como de costume, fazemos o download na pasta /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

Agora, o Z-push está instalado em seu servidor em /usr/share/z-push.

5 Configuração do Z-push

O Z-push precisa de mais dois diretórios para funcionar: /var/lib/z-push e /var/log/z-push. Então, vamos criá-los e modificar proprietários e permissões:

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

Em seguida, precisamos modificar o arquivo /usr/share/z-push/config.php para atender às nossas necessidades:

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

Modificamos o fuso horário (por exemplo, Europe/Paris) e o fornecedor de backend (no nosso caso BackendIMAP):

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

6 Configuração do Apache & PHP

Queremos que nossos clientes configurem seus telefones móveis com seu próprio domínio. Por exemplo, um cliente tem um domínio de e-mail chamado toto.com, armazenado em nosso servidor.
Queremos que o cliente configure sua conta de e-mail em seu telefone móvel usando toto.com. Então, criamos um arquivo apache.conf em /usr/share/z-push:

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

Ele ficará assim:

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

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

O Z-Push é uma implementação do protocolo ActiveSync, por isso precisamos usar um Alias assim.

Certifique-se de que o PHP tenha as seguintes configurações:

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

Se não tiver, você pode adicionar essas linhas no /usr/share/z-push/apache.conf, dentro da tag Directory.

Depois disso, precisamos reiniciar o Apache para que as alterações sejam levadas em conta:

service apache2 restart

7 Configuração do Open Basedir PHP

A última coisa que precisamos fazer em nosso servidor é configurar o Open Basedir PHP do nosso domínio principal. Podemos fazer isso usando o ISPConfig.
Neste tutorial, podemos acessar o ISPConfig em https://example.com:8080 e fazemos login com direitos de administrador.
No ISPConfig, criei um site que corresponde ao example.com.
Então, clicamos na aba de websites e editamos o site example.com. Em seguida, clicamos na aba de Opções.
No campo open_basedir PHP, adicione o seguinte ao final da linha:

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

Isso dá acesso às pastas /usr/share/z-push, /var/lib/z-push e /var/log/z-push para usuários da web.

Agora, tudo está feito em nosso servidor!

8 Configuração móvel

Podemos agora testar se o protocolo push está funcionando configurando uma conta de e-mail em um móvel. Para este tutorial, usei um iPhone 3GS, mas também deve funcionar com Android, Windows ou dispositivos BlackBerry.
Para fazê-lo funcionar, precisamos configurar uma conta Exchange.
No iPhone, vamos em Ajustes > Mail > Adicionar uma conta. Em seguida, escolhemos Microsoft Exchange. Primeiro, precisamos preencher o endereço de e-mail, a senha e a descrição da conta que queremos usar.
Na próxima tela, precisamos preencher o campo do servidor. Por exemplo, se o endereço de e-mail for [email protected], podemos usar toto.com para o campo do servidor. Usamos o endereço de e-mail para o campo de nome de usuário. Podemos optar por usar o protocolo SSL se estiver configurado em nosso servidor.
Finalmente, validamos clicando em OK.

Está feito! Agora, o telefone móvel deve receber e-mails do servidor instantaneamente…

O Servidor de E-mail Push Perfeito - Debian Squeeze (Debian 6.0) Com ISPConfig 3 & Z-push