Ejabberd

De ArchwikiFR

Ejebberd est un serveur de messagerie instantanée au protocole XMPP

Objectif

Installer un serveur ejabberd au sein d'un réseau local. Ce serveur sera uniquement accessible en interne.

Installation et configuration

Installation

pacman -S ejabberd

Configuration

Note : Avant toute modification, faire une copie du fichier /etc/ejabberd/ejabberd.cfg.

Éditer le fichier /etc/ejabberd/ejabberd.cfg. Le fichier est au format Erlang.

% En Erlang, un commentaire commence par "%"
%%%% Attention, en Erlang, une instruction se termine toujours par un "."
{une_valeur, "valeur"}.
{une_liste, ["val_1", "val_2"]}.
{ma_liste, 
  [
   % Un ensemble d'éléments
   {une_valeur, "val1"},
   {autre_valeur, "val2"},
   % Et maintenant une liste
   {liste, 
     [
      {option1, "option1"},
      {option2, "option2"}
     ]}
  ]
}.

Modifier les lignes suivantes:

Hostname

{hosts, ["jabber", "mamachine", "jabber.example.org"]}.

ou tout autre nom accessible sur votre réseau.

Attention : Veillez à toujours mettre le nom de la machine ou du domaine en minuscule, sinon, vous risquez d'obtenir un not_allowed lors de l'enregistrement et de l'accès à la page web.

Adresse de l'administrateur

Le compte sera créé ultérieurement.

{acl, admin, {user, "cestmoi", "mamachine"}}.

Plusieurs administrateurs peuvent êtres déclarés par domaine.

Méthode d'authentification

{auth_method, internal}.

Gestion interne au serveur.

Autorisation d'ouverture de compte

Permet de controler la création des comptes. Dans ce cas, seul l'administrateur peut créer des comptes.

{access, register, [{deny, all}]}.

Modification de la langue

{language, "fr"}

Ces quelques réglages suffisent dans notre cas. Bien d'autres options peuvent être ajustées.

Sauvegarder et quitter l'éditeur.

Enregistrer l'administrateur

ejabberdctl register cestmoi votremachine motdepasseadmin

Test

Afin de vérifier votre installation, lancer le serveur en mode interactif:

ejabberdctl live

Si votre serveur a démarré correctement, la procédure doit se terminer par:

  application: ejabberd
   started_at: ejabberd@localhost

Dans une autre console, lancer la commande nmap et vérifier la bonne ouverture des ports.

# nmap votremachine
…
PORT      STATE SERVICE
…
5222/tcp  open  xmpp-client
5269/tcp  open  xmpp-server
5280/tcp  open  xmpp/bosh
…

Dans la console interactive, à l'invite de commande, taper

(ejabberd@localhost)1> q().

pour quitter.

Démarrer le serveur Ejabbard

ejabberdctl start

Quelques commandes

  • État du serveur
ejabberdctl status
  • Arrêt du serveur
ejabberdctl stop
  • Redémarrage du serveur
ejabberd restart
  • Démarrer automatiquement le serveur au démarrage
systemctl enable ejabberd
systemctl enable epmd

Administration et exploitation

Le serveur Ejabberd peut maintenant être administré dans votre navigateur internet habituel à l'adresse http://votremachine:5280/admin. Vous trouverez de nombreux clients Ejabberd sur internet. Citons entre autre Psi.

Liens web