## ejabberd

## Servidor de Mensajería Instantánea (chat) (ejabberd)

### ¿Qué es XMPP?

XMPP es un protocolo federatedo para Mensajería Instantánea. Esto significa que los usuarios que tengan cuenta en un servidor XMPP pueden conversar con los usuarios que estén en el mismo u otros servidores XMPP. XMPP se puede usar también para llamadas de voz y vídeo si los clientes las soportan.

Con XMPP las conversaciones se pueden securizar de 2 maneras:

1. TLS: Esto securiza la conexión entre el cliente y el servidor o entre 2 servidores. Esto está áltamente recomendado y ya debería estar soportado por todos los clientes.

2. Punto a punto: Esto securiza los mensajes enviados entre los clientes de modo que ni siquiera el servidor pueda ver los contenidos. El último protocolo y también el más cómodo se llama OMEMO pero solo lo soportan algunos clientes. Algunos clientes que no soportan OMEMO podrían soportar otro protocolo llamado OTR. Para que funcione ambos clientes tienen que ser compatibles con el mismo protocolo.

### Estableciendo un Nombre de Dominio

Para que funcione XMPP tu FreedomBox necesita tener Nombre de Dominio accesible desde Internet. Puedes leer acerca de la obtención de un Nombre de Dominio en la sección DNS Dinámico de este manual.

Una vez tengas ya tu Nombre de Dominio puedes decirle a tu FreedomBox que lo use dándolo de alta en la configuración del sistema.

- Nota: Tras cambiar tu Nombre de Dominio la página del servidor (XMPP) de mensajería instantánea podría mostrar que el servicio no está funcionando. En un minuto más o menos se actualizará y lo volverá a mostrar operativo.

Ten en cuenta que de momento PageKite no soporta el protocolo XMPP.

### Registrando los usuarios XMPP mediante SSO

Actualmente todos los usuarios creados con Plinth podrán ingresar al servidor XMPP. Puedes añadir usuarios nuevos con el módulo de "Usuarios y Grupos del Sistema". Los grupos seleccionados para el usuario nuevo no importan.

### Usar el cliente web

Tras completar la instalación del módulo XMPP el cliente web JSXC para XMPP está accesible en `https://<tu_freedombox>/plinth/apps/xmpp/jsxc/`. Automáticamente comprobará la conexión del servidor BOSH al nombre de dominio configurado.

### Usar un cliente móvil o de escritorio

Hay disponibles clientes XMPP para varias platformas móviles y de escritorio.

### Enrutado de Puertos

Si tu FreedomBox está detrás de un router tendrás que configurar en él la redirección de puertos. Redirije los siguientes puertos de XMPP:

- TCP 5222 (cliente-a-servidor)

- TCP 5269 (servidor-a-servidor)

Volver a la descripción de Funcionalidades o a las páginas del manual.