Configuración de Z-Push ActiveSync para Ubuntu Email Server

Z-Push ActiveSync es importante si deseas sincronizar tareas, contactos y correos electrónicos entre el ordenador de sobremesa y los dispositivos móviles.

Por defecto, los usuarios de clientes de correo electrónico disponen de un intervalo de tiempo específico durante el cual se comprueba el servidor y aparecen los correos electrónicos push. Para acelerar este proceso, también se puede utilizar Z-Push. Por lo tanto, en esta guía abordaremos algunos aspectos de configuración de Z-Push para usuarios de Ubuntu.

Lo que necesitarás para empezar

Para iniciar el proceso, ya deberías disponer de un servidor de correo de Ubuntu que funcione correctamente. En caso de que no lo tengas, existen numerosas guías con explicaciones detalladas sobre cómo configurarlo todo adecuadamente.

Paso 1: Configurar Z-Push en tu servidor de correo de Ubuntu

Accede al servidor de correo y utiliza la siguiente línea:

sudo apt install z-push z-push-backend-imap z-push-common

Una vez en el proceso de instalación, se te ofrecerá Lighttpd o Apache como servidor web para la configuración automática. En caso de que utilices el servidor Nginx, debes pulsar la tecla Tab y Enter para saltarte este proceso de selección.

Quienes seleccionen el servidor Apache crearán dos archivos de configuración. Sin embargo, en esta guía solo explicaremos el proceso de configuración con el backend IMAP para la sincronización del correo electrónico.

 sudo apt install z-push-backend-combined z-push-backend-caldav z-push-backend-carddav z-push-backend-kopano

Para la configuración de la detección automática, utiliza:

 sudo nano /etc/z-push/utodiscover.conf.php

A continuación, busca y configura tu zona horaria, y localiza la siguiente línea, en la que debes cambiar «false» por «true»:

define('USE_FULLEMAIL_FOR_LOGIN', false);

A continuación, busca la configuración del backend y activa el backend IMAP; por último, cierra el archivo guardando todos los cambios.

Ahora vamos a editar imap.conf.php:

sudo nano /etc/z-push/imap.conf.php

Busca la sección de configuración de IMAP, donde debes habilitar el cifrado TLS. Especifica la dirección del servidor en la parte de definición, añade el puerto y añade /ssl en IMAP_OPTIONS.

A continuación, indica smtp en IMAP_SMTP_METHOD. En este parámetro, $imap_smtp_params, añade la configuración SMTP del servidor, que incluye la dirección, el puerto, el nombre de usuario y la contraseña. Lo último que hay que cambiar antes de guardar es IMAP_FOLDER_CONFIGURED, que debe estar en «true». Una vez hecho esto, puedes cerrar el archivo con todos los cambios guardados.

Paso 2: Añadir extensiones esenciales de PHP

Z-Push no es compatible con PHP 8, por lo que puedes utilizar la versión 7.4; la instalación es la siguiente:

sudo apt install software-properties-common

sudo add-apt-repository ppa:ondrej/php

sudo apt update

sudo apt install php-soap php7.4-common php7.4-soap php7.4-fpm php7.4-imap php7.4-mbstring

En caso de que utilices un servidor Apache, el proceso comienza desactivando PHP7 y MPM:

sudo a2dismod php7.4 

sudo a2dismod mpm_prefork

A continuación, utiliza los siguientes comandos:

sudo a2enmod mpm_event proxy_fcgi setenvif

sudo a2enconf php7.4-fpm

El último paso será reiniciar el servidor Apache con:

sudo systemctl restart apache2

Paso 3: Configurar el servidor web para Z-Push

Configuración de Nginx para Z-Push

Comienza el proceso creando el archivo:

sudo nano /etc/nginx/conf.d/z-push.conf

Añade las siguientes líneas al archivo:
server {

     listen 80;

     listen [::]:80;

     server_name: introduce tu nombre real;

     access_log /var/log/nginx/z-push.access;

     error_log /var/log/nginx/z-push.error;

     location ~* /AutoDiscover/AutoDiscover.xml {

             alias /usr/share/z-push/autodiscover/autodiscover.php;

             include /etc/nginx/fastcgi.conf;

             fastcgi_read_timeout 3660;

             fastcgi_pass unix:/run/php/php7.4-fpm.sock;

     }

     location ~* /Microsoft-Server-ActiveSync {

             alias /usr/share/z-push/index.php;

             include /etc/nginx/fastcgi.conf;

             fastcgi_read_timeout 3660;

             fastcgi_pass unix:/run/php/php7.4-fpm.sock;

     }

}

A continuación, comprueba si todo funciona correctamente y reinicia el servidor Nginx.

Configuración de Apache para Z-Push

Empieza por crear el archivo:

sudo nano /etc/apache2/sites-available/z-push.conf

Añade la siguiente información al archivo creado:

<VirtualHost *:80>

  ServerName introduce aquí el nombre real

  <IfModule mod_alias.c>

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

  </IfModule>

  <Directory /usr/share/z-push>

DirectoryIndex index.php

Options -Indexes +FollowSymLinks

AllowOverride none

<IfModule mod_authz_core.c>

     Require all granted

</IfModule>

<Files "config.php">

   <IfModule mod_authz_core.c>

     Require all denied

   </IfModule>

</Files>

  </Directory>

  <IfModule mod_alias.c>

Alias /AutoDiscover/AutoDiscover.xml "/usr/share/z-push/autodiscover/autodiscover.php"

Alias /Autodiscover/Autodiscover.xml "/usr/share/z-push/autodiscover/autodiscover.php"

Alias /autodiscover/autodiscover.xml "/usr/share/z-push/autodiscover/autodiscover.php"

  </IfModule>

  Include /etc/apache2/conf-available/php7.4-fpm.conf

</VirtualHost>

A continuación, debes reiniciar el servidor.

Paso 4: Protege tu correo electrónico con HTTPS

Para proteger tu correo electrónico, instala Let’s Encrypt con el siguiente comando:

sudo apt install certbot

Para los usuarios de Nginx, también es necesario añadir este paso:

sudo apt install python3-certbot-nginx

Para instalar el certificado, utiliza la siguiente línea:

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email you@name.com -d autodiscover.name.com

Para los usuarios de Apache, empieza con:

sudo apt install python3-certbot-apache

Para instalar el certificado, utiliza la siguiente línea:

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email you@name.com -d autodiscover.name.com

Una vez que hayas reiniciado el servidor, todo debería funcionar correctamente. De no ser así, más adelante en la guía te indicaremos algunos errores que podrás solucionar fácilmente.

Paso 5: Activar el correo electrónico push en dispositivos móviles

Los usuarios de iPhone pueden activar el correo electrónico push accediendo a «Ajustes», seleccionando «Correo», luego «Cuentas» y añadiendo cuentas. Durante el proceso de activación, selecciona «Microsoft Exchange». A continuación, introduce la dirección de correo electrónico, elige «Configuración manual» e introduce la contraseña. Vuelve a introducir las credenciales y añade la información del servidor.  

¿No se ha podido conectar al servidor? Aquí te explicamos por qué

Por lo general, los fallos en la conexión al servidor se deben a una versión incorrecta de PHP, por lo que solo tienes que actualizarla para que Z-Push funcione correctamente.

¿No puedes verificar la información de la cuenta? Solucionalo aquí

Para verificar la información de la cuenta, tendrás que editar el archivo de configuración de Dovecot. Accede al archivo con:

sudo nano /etc/dovecot/conf.d/10-auth.conf

Busca la línea con el dominio predeterminado y, tras eliminar el comentario, añade allí el dominio y reinicia.

Cómo diagnosticar problemas utilizando los registros del servidor

Para Nginx, utiliza:

/var/log/nginx/z-push.error.

Para diagnosticar los registros del servidor en Apache:

/var/log/apache2/z-push_error.log.

Registros de Z-Push:

/var/log/z-push/

En resumen

Esperamos que ahora dispongas de toda la información necesaria sobre la configuración de Z-Push ActiveSync para el servidor de correo de Ubuntu.