Cette page a été importée automatiquement de notre ancien wiki mais n’a pas encore été révisée.

Howto Ejabberd

Ejabberd est un serveur Jabber écrit en Erlang.

https://www.ejabberd.im/

Installation

Ejabberd est packagé dans Debian :

# apt install ejabberd

Lors de l’installation, indiquer :

• hostname : le domaine principal (fqdn) que le serveur devra gérer ;
• compte admin : un compte Jabber (sans la partie @domaine) qui sera admin du serveur (permet l’accès à l’interface web + accès à diverses commandes admin depuis un client Jabber.

DNS

Enregistrements à rajouter dans la zone DNS :

_xmpp-client._tcp       IN      SRV 0 0 5222 im
_xmpp-server._tcp       IN      SRV 0 0 5269 im
im                      IN      A   192.0.2.42

Note : xmpp-server est facultatif, mais recommandé pour communiquer avec d’autres serveurs XMPP.

Configuration

La configuration se fait désormais via le fichier /etc/ejabberd/ejabberd.yml.

Pour configurer plusieurs hosts :

hosts:
  - "im.example.com"
  - "example.com"

Authentification (à mettre à jour)

Ejabberd supporte plusieurs backends externes pour l’authentification (MySQL, LDAP, PAM, script externe…).

Pour utiliser un annuaire LDAP :

• commenter {auth_method, internal}. pour ne faire que de l’authentification sur LDAP. Pour utiliser plusieurs méthodes d’authentification, il est possible de passer une liste comme ceci :

{auth_method, [ldap, internal]}.

• Décommenter/modifier les directives suivantes :

%%
%% Authentication using LDAP
%%
{auth_method, ldap}.

%% List of LDAP servers:
{ldap_servers, ["localhost"]}.

%% Encryption of connection to LDAP servers (LDAPS):
{ldap_encrypt, none}.
%%{ldap_encrypt, tls}.

%% Port connect to LDAP server:
{ldap_port, 389}.
%%{ldap_port, 636}.

%% LDAP manager:
%%{ldap_rootdn, "dc=example,dc=com"}.

%% Password to LDAP manager:
%%{ldap_password, "******"}.

%% Search base of LDAP directory:
{ldap_base, "dc=example,dc=com"}.

%% LDAP attribute that holds user ID:
{ldap_uids, [{"uid", "%u"}]}.

%% LDAP filter:
{ldap_filter, "(objectClass=shadowAccount)"}.

Optimisation

Par défaut, le support du multi-cœur n’est pas forcément désactivé. Pour l’activer si le processeur le supporte, éditer le fichier /etc/default/ejabberd :

SMP=auto

Administration

# ejabberdctl status
The node ejabberd@node is started with status: started
ejabberd 14.07 is running in that node

# ejabberdctl register jdoe im.example.com <password>

# ejabberdctl connected_users
jdoe@im.example.com/4767678256447397329306554

# ejabberdctl registered_users im.example.com
jdoe

# ejabberdctl kick jdoe im.example.com
# ejabberdctl unregister jdoe im.example.com

Sauvegarde / migration

# ejabberdctl dump /tmp/ejabber.dump && mv /tmp/ejabber.dump /home/backup/

La restauration se fait avec ejabberdctl load

Note : on peut s’en servir pour migrer des données, en reformatant le fichier de dump qui n’est complexe à comprendre. Par exemple pour migrer le répertoire des utilisateurs (roster) :

{tables,[{roster,[{record_name,roster},
                  {attributes,[usj,us,jid,name,subscription,ask,groups,
                               askmessage,xs]}]}]}.
{roster,{"jdoe","im.example.com",
         {"bob","gmail.com",[]}},
        {"jdoe","im.example.com"},
        {"bob","gmail.com",[]},
        [],both,none,[],<<>>,[]}.
[...]