Ejabberd está escrito en lenguaje Erlang, y utiliza el formato de este lenguaje para su archivo de configuración. Si bien no es complicado, no es a lo que uno está acostumbrado.
Comenzaré con lo básico de todos los tutoriales, pero con la idea de que el servidor autenticará con LDAP en lugar de la autenticación interna. Luego pasaré a los topics más interesantes como autopopular rosters con grupos de usuarios LDAP y armar un servicio de alta disponibilidad con dos servidores ejabberd.
Instalación
En debian, Ubuntu y supongo que otros derivados también, ejabberd se encuentra en los repositorios oficiales, por lo que instalarlo es tan fácil como ejecutar lo siguiente:
# apt-get install ejabberd
Configuración básica
Toda la configuración se realiza desde el archivo /etc/ejabberd/ejabberd.cfg. De base, tendremos que editar lo siguiente:
{hosts, ["dvpem.org"]}.donde:
{acl, admin, {user, "vektor", "dvpem.org"}}.
- hosts especifica los dominios que ejabberd manejará.
- acl Indica cuál es el usuario admin. Si utilizan LDAP (ver a continuación) este usuario debe ser uno que exista en el servidor de LDAP.
# ejabberdctl register vektor dvpem.org superPASSEs posible acceder a una interfaz web de administración apuntando a la siguiente URL:
http://<host-o-IP>:5280/admin
Habilitar LDAP
Para habilitar autenticación por LDAP veamos un ejemplo de configuración y qué significa cada valor:
%%{auth_method, internal}.Vamos por línea:
{auth_method, ldap}.
{ldap_servers, ["ldap.dvpem.org"]}.
{ldap_base, "ou=People,dc=dvpem,dc=org"}.
{ldap_rootdn, "cn=Usuario,dc=dvpem,dc=org"}.
{ldap_password, "PASSusuario"}.
{ldap_port, 636}.
{ldap_encrypt, tls}.
{ldap_uids, [{"uid", "%u"}]}.
- Deshabilita (comenta) autenticación interna.
- Habilita autenticación por LDAP.
- ldap_servers: indica cuáles son los servidores LDAP a los que se conectará ejabberd.
- ldap_base: especifica el DN base a partir del cual buscar los usuarios. Esto dependerá si se utiliza AD, OpenLDAP, u schemas propios.
- ldap_rootdn: especifica el usuario utilizado para conectar ejabberd con LDAP. El usuario utilizado debe poder listar usuarios y grupos, como mínimo.
- ldap_password: password del usuario utilizado en la conexión con LDAP.
- ldap_port: puerto del servidor LDAP.
- ldap_encrypt: indica que utilice TLS en la conexión.
- ldap_uids: indica qué atributo contiene el identificador del usuario. Esto también variará según el schema. En AD podría utilizarse samAccountName.
# server ejabberd restartNota 1: si iniciar ejabberd falla, probar de ejecutarlo en modo debug:
# ejabberd --debugNota 2: cuando la configuración está mal (o algo falla), puede que igualmente ejabberd deje un procesos corriendo y que ello les traiga problemas al intentar iniciar ejabberd nuevamente. Es un problema que queda medio oculto porque al iniciar ejabberd no arroja error, pero al mirar la lista de procesos escuchando, vemos que ninguno espera conexiones en el puerto default 5222 o 5280. En este caso, buscar y matar los procesos colgados antes de iniciar ejabberd nuevamente:
# killall -u ejabberd
Usar grupos de LDAP como grupos en los rosters
Es posible tomar los grupos de LDAP y utilizarlos en el roster, de forma que cada cliente que se conecte vea los grupos y los usuarios incluidos. Para ello, se puede utilizar el módulo mod_shared_roster_ldap, que por defecto no viene habilitado. Editar el archivo ejabberd.cfg, y en la sección de módulos agregar mod_shared_roster_ldap:
...El ejemplo está armado pensando en un servidor OpenLDAP, pero es fácilmente adaptable a AD, sólo hay que cambiar los nombres de los atributos.
{modules,
[
....
{mod_shared_roster_ldap, [
{ldap_base, "ou=Group,dc=dvpem,dc=org"},
{ldap_rfilter, "(objectClass=posixGroup)"},
{ldap_ufilter, "(&(objectClass=posixAccount)(uid=%u))},
{ldap_gfilter, "(&(objectClass=posixGroup)(cn=%g))"},
{ldap_groupattr, "cn"},
{ldap_groupdesc, "cn"},
{ldap_memberattr,"memberUid"},
{ldap_memberattr_format, "cn=%u,ou=People,dc=dvpem,dc=org"},
{ldap_useruid, "uid"},
{ldap_userdesc, "cn"}
]},
]}.
Veamos cada uno de los atributos:
- ldap_base: indica a partir de donde buscar los grupos para popular el roster.
- ldap_rfilter: filtro que utilizará para popular el roster, y como los grupos del roster son los mismos de LDAP, pues ahí va. Dado que el base ya apunta a los grupos, no sería estrictamente necesario ya que no debería haber otra cosa que grupos en esa OU, pero por las dudas... En este caso se asume que los grupos son Posix, si usan AD tendrán que cambiar por el fitro que mejor les quede.
- ldap_ufilter: filtro para obtener el atributo que contiene el nombre "humano" del usuario. Préstese atención que con este filtro obtenemos el nombre del atributo, no el valor del atributo, para esto último está ldap_user_desc.
- ldap_gfilter: filtro para obtener el nombre "humano" de los grupos. Misma idea que con ldap_ufilter.
- ldap_groupattr: nombre del atributo LDAP que tiene el nombre del grupo.
- ldap_groupdesc: nombre del atributo que tiene el nombre "humano" del grupo. Se usa en conjunto con ldap_gfilter, obteniendo del resultado de este filtro su valor.
- ldap_memberattr: nombre del atributo LDAP que apunta a los miembros del grupo (member también es común).
- ldap_memberattr_format: especifica el formato en que se guardan los miembros de un grupo. Por ejemplo, pueden tener cn=vektor,ou=People,dc=dvpem,dc=org. El %u le indica cuál es el nombre del usuario.
- ldap_useruid: nombre del atributo que contiene el ID de usuario (en AD samAccountName).
- ldap_user_desc: nombre del atributo que contiene el nombre "humano" del usuario. Se utiliza en conjunto con ldap_ufilter, obteniendo del resultado de este filtro su valor.
Instalar certificado propio
Para habilitar TLS/SSL ejabberd utiliza un sólo archivo que contiene clave privada, certificado y cadena de certificados. Por defecto, se genera uno al instalar ejabberd, denominado ejabberd.pem. Para no tener que editar el archivo de configuración, lo más simple es reemplazar este archivo con uno generado por nosotros a partir de nuestros certificados y clave. Este super archivo debe contener los datos en el siguiente orden:
- Clave privada
- Certificado
- Cadena certificante
# cat private.key certificado.key CA.crt > /etc/ejabberd/ejabberd.pem
Timeouts
Un problema que surgió en uno de los servers que instalé, es que después de un rato de inactividad, las conexiones TCP de ejabberd con LDAP mueren. Buscando encontré que si no hay actividad durante un dado período de tiempo, algunos equipos de red pueden "desconectar" las sesiones TCP sin notificar al software que las está usando. En este caso, desde ejabberd se sigue viendo como que la conexión está activa, y al ver la conexión activa la utiliza pero sin obtener resultados. Desde mi punto de vista, esto es un bug en ejabberd, ya que si al realizar consultas no se obtiene respuesta, debería cerrar esa conexión e intentar conectarse nuevamente al servidor LDAP. En lugar de hacer eso, sólo da un authentication failure, sin loguear siquiera un timeout en los logs :S
Lo importánte aquí es la solución a este problema. El kernel de Linux soporta el envío de paquetes keepalive, para mantener activas conexiones TCP o marcar una conexión como "muerta". Esto lo realiza enviando paquetes keepalive a intervalos definidos de tiempo, esperando respuesta del servidor para decidir si la conexión está muerta. Es decir, cumple dos funciones, por un lado envía paquetes generando tráfico de red para que la conexión no se muera, y en el caso de que la conexión ya esté muerta, lo detecta y le avisa a la aplicación que la está usando.
La configuración se realiza a través de tres variables que se encuentran en /proc/sys/net/ipv4/
- tcp_keepalive_time: default 7200 segundos, es decir, 2 horas. Especifica el intervalo en segundos entre el primer paquete de una secuencia de pruebas keepalive y el primer paquete de la próxima.
- tcp_keepalive_intvl: default 75 segundos. Indica cada cuántos segundos enviar paquetes keepalive en una secuencia.
- tcp_keepalive_probes: default 9. Valor numérico que especifica cuántos paquetes enviar en una secuencia.
Para no tener el problema de conexiones muertas podemo acomodar estos valores, ya que 2hs de espera puede ser demasiado. Según este post (http://start.nwt.fhstp.ac.at/blog/?p=307), los valores que mejores resultado les dieron son los siguientes:
tcp_keepalive_time = 600Lo cual se puede setear ejecutando:
tcp_keepalive_intvl = 30
tcp_keepalive_probes = 5
# echo 600 > /proc/sys/net/ipv4/tcp_keepalive_timeAl reiniciar el servidor, estos valores se perderán, pero pueden generar un script en bash que se ejecute al inicio.
# echo 30 > /proc/sys/net/ipv4/tcp_keepalive_intvl
# echo 5 > /proc/sys/net/ipv4/tcp_keepalive_probes
Así que ya saben, si ven que las conexiones con el servidor LDAP figuran activas (lsof -Pni), pero los clientes dan authentication failure sin razón, prueben esta solución.
Clustering
La configuración de un cluster ejabberd, es decir, tener más de un servidor ejabberd sirviendo el mismo dominio, es medio críptica, pero no compleja. Digo críptica porque hay que ejecutar comandos Erlang para que funcione. Básicamente configurar un cluster ejabberd es igual a configurar un cluster mnesia. Erlang utiliza mnesia, un manejador de base de datos distribuido, y lo que hay que hacer es configurar mnesia para que funcione en modo replicación.
Si bien la configuración puede ser multimaster, llamaré Master al primer nodo que damos de alta y Slave al segundo.
Configuración Master
Copiar cookie mágica de Erlang que se encuentra en /var/lib/ejabberd/.erlang.cookie al nodo slave. Esta cookie debe ser igual en todos los nodos.
# scp /var/lib/ejabberd/.erlang.cookie vektor@chat2.dvpem.org:~O bien hacer un cat de .erlang.cookie y pegar el contenido en el nodo destino.
Editar archivo /etc/default/ejabberd y agregar las líneas:
ERLANG_NODE=ejabberd@chat1donde:
INET_DIST_INTERFACE={192,168,1,1}
- ERLANG_NODE especifica el nombre completo del nodo.
- INET_DIST_INTERFACE es la IP en la cual esperará conexiones. Utilizar comas para separar los octetos, es decir, en lugar de utilizar los convencionales puntos, separar con comas.
# service ejabberd restart
Configuración Slave
Detener el servicio de ejabberd:
# service ejabberd stopEditar archivo /etc/default/ejabberd y agregar las líneas:
# killall -u ejabberd
ERLANG_NODE=ejabberd@chat2Mover la cookie al directorio de ejabberd y cambiar los permisos para que el usuario ejabberd la pueda acceder:
INET_DIST_INTERFACE={192,168,1,2}
# mv .erlang.cookie /var/lib/ejabberd/Iniciar ejabberd:
# chown ejabberd:ejabberd /var/lib/ejabberd/.erlang.cookie
# chmod 400 /var/lib/ejabberd/.erlang.cookie
# service ejabberd startAsegurarse que ejabberd se está ejecutando:
# ejabberctl statusAbrir una consola Erlang para conectar al nodo 1 y realizar una copia de la base de datos:
# ejabberctl debugEn la consola Erlang, ejecutar lo siguiente:
(ejabberd@chat2)1> mnesia:stop(),Cerrar la sesión precionando Ctrl+c Ctrl+c
(ejabberd@chat2)1> mnesia:delete_schema([node()]),
(ejabberd@chat2)1> mnesia:start(),
(ejabberd@chat2)1> mnesia:change_config(extra_db_nodes, ['ejabberd@chat1']),
(ejabberd@chat2)1> mnesia:change_table_copy_type(schema, node(), disc_copies).
(ejabberd@chat2)1> mnesia:info().
donde:
- mnesia:stop() detiene la ejecución de la BD mnesia,
- mnesia:delete_schema([node()]) elimina el schema actual del nodo,
- mnesia:start() inicia nuevamente la BD,
- mnesia:change_config(extra_db_nodes, ['ejabberd@chat1']) apunta la base de datos al nodo 1
- mnesia:change_table_copy_type(schema, node(), disc_copies) crea una copia local del schema.
- mnesia:info() imprime información del nodo. Al ejecutar este comando deberían ver ambos nodos en ejecución:
...
running db nodes = ['ejabberd@chat1','ejabberd@chat2']
...
Ahora, para tener un entorno multi-master hay que realizar una copia de todas las tablas en el nodo slave... que ya no sería más slave, sino otro master. En este caso los writes serán más lentos, pero tendremos un entorno de alta disponibilidad.
El comando para copiar tablas de otro nodo es mnesia:add_table_copy... pero hacerlo tabla por tabla es tedioso. Encontré en un comentario de StackOverflow como hacer una copia de todas las tablas en un comando:
(ejabberd@chat2)1> [{Tb, mnesia:add_table_copy(Tb, node(), Type)} || {Tb, [{'ejabberd@chat1', Type}]} <- [{T, mnesia:table_info(T, where_to_commit)} || T <- mnesia:system_info(tables)]].Hay que ejecutarlo en una consola Erlang con "ejabberdctl debug".
Referencias
- ejabberd 14.12 - Installation and Operation Guide
- Ejabberd Installation and Operation Guide
- Ejabberd Active Directory LDAP Login
- mod_shared_roster_ldap 0.5.3 - Shared Roster LDAP Documentation
- Ejabberd SSL Certificate
- Ejabberd cluster on Ubuntu Server
- Set up a federated XMPP Chat Network with ejabberd, your own Google Talk/Hangouts alternative
- Straight-forward Clustering of ejabberd
