====== Jabberd14 ======

===== Introduction =====

Dans cette rubrique, vous trouverez toutes les instructions nécessaires pour installer et configurer un serveur Jabber/XMPP [[http://www.jabberd.org|Jabberd14]].

[[http://www.jabberd.org|Jabberd14]] est le serveur Jabber/XMPP historique, programmé par Jeremie Mieller, créateur de Jabber.

Une adresse Jabber se présente sous la forme : « login@dommaine ».

===== Installation =====

==== Debian 5.0 ====

L'intégralité des actions qui vont suivre doivent être exécutées en tant que super-utilisateur (typiquement : root).

Pour installer jabberd14, utilisez votre gestionnaire de paquets préféré.
Par exemple avec apt-get, entrez : <code># apt-get install jabber</code>

Dès lors, jabberd14 est installé.

Pour tester si votre serveur est dors et déjà opérationnel, entrez : 
<code># telnet 127.0.0.1 5222</code> ainsi que <code># telnet 127.0.0.1 5269</code> 

Si telnet ne vous indique pas « Unable to connect to remote host: Connection refused » mais « Connected to 127.0.0.1 » c'est que votre serveur est opérationnel.

Entrez « quit » et pressez Entrer pour sortir de telnet.

Pour communiquer avec l'extérieur, il faudra donc ouvrir les ports 5222 et 5269 de votre routeur.

Pour tester la communication de votre serveur avec l'extérieur, enrez : 
<code># telnet votre_nom_de_dommaine 5222</code> ainsi que <code># telnet votre_nom_de_dommaine 5269</code>

Si telnet ne vous indique pas « Unable to connect to remote host: Connection refused » mais « Connected to votre_nom_de_dommaine » c'est que votre serveur est opérationnel.

Entrez « quit » et pressez Entrer pour sortir de telnet.

===== Configuration =====

==== Générale ====

Le nom du serveur demeure toujours « localhost ».

La configuration du serveur se fait via le fichier « /etc/jabber/jabber.xml ».

Certaines lignes sont précédées de <!-- et suivies de -->. Ces lignes sont des commentaires, il ne sert donc à rien de les modifier.

Tout d'abord, pour changer le nom du serveur (localhost) dans jabber.xml, remplacez toutes les références à "localhost" par votre nom de dommaine.

Vous pouvez dors et déjà recharger votre serveur jabberd14 en entrant : 

<code># /etc/init.d/jabber restart</code>

Votre serveur peut alors accepter les connexion de l'extérieur par votre nom de dommaine.

Pour ajouter un utilisateur, utilisez votre client Jabber préféré (Pidgin, Gaim, Freetalk...).
Celui-ci vous proposera de créer un compte.
(Par défaut, jabberd14 autorise la création de comptes.)

Toujours dans le fichier /etc/jabber/jabber.xml, vous pourrez modifier le nom, la description et l'URL de votre serveur Jabber grâce aux lignes : 
<file>
<jabber>
 …
  <service id="sessions">
   …
    <jsm xmlns="jabber:config:jsm">
     …
      <vCard>
        <FN>Jabber Server</FN>
        <DESC>A Jabber Server on Debian GNU/Linux!</DESC>
        <URL>http://www.debian.org/</URL>
      </vCard>
</file>

Remplacez le texte contenu entre <FN> et </FN> par le nom de votre serveur Jabber, le texte contenu entre <DESC> et </DESC> par une petite description de votre serveur et le texte contenu entre <URL> et </URL> par l'URL de votre serveur jabber.

Les lignes 
<file>
<jabber>
 …
  <service id="sessions">
   …
    <jsm xmlns="jabber:config:jsm">
     …
      <register notify="yes">
        <instructions>Choose a username and password to register with this server.</instructions>
        <name/>
        <email/>
      </register>
</file>

servent à définir la phrase d'instruction qui sera demandée lors de l'enregistrement d'un compte. Je vous conseille de mettre un phrase explicite, en français.


Les éléments <name/> et <email/> indiquent que l'utilisateur va devoir renseigner son nom et son adresse e-mail lors de l'enregistrement.
Vous pouvez supprimer l'un ou ces deux éléments selon vos souhaits.

Pour ne pas accepter l'enregistrement de nouveaux comptes, ajoutez
<code><!--</code> avant <code><register notify="yes"></code> et <code><mod_register>./jsm/jsm.so</mod_register></code> (à la fin du fichier).
et <code>--></code> après <code></register></code> et <code><mod_register>./jsm/jsm.so</mod_register></code> (à la fin du fichier).

Les lignes :
<file>
<jabber>
 …
  <service id="sessions">
   …
    <jsm xmlns="jabber:config:jsm">
     …
      <welcome>
        <subject>Welcome!</subject>
        <body>Welcome to the Jabber server -- we hope you enjoy this service! For information about how to use Jabber, visit the Jabber User's Guide at http://jabbermanual.jabberstudio.org/</body>
      </welcome>
</file>
servent a définir le message d'accueil réservé à un nouvel utilisateur.

Remplacez le texte compris entre <subject> et </subject> par le sujet du message de bienvenue, typiquement quelque chose comme : "Bienvenue". Remplacez ensuite le texte compris entre <body> et </body> par votre message de bienvenue.

Le groupe
<file>
<jabber>
 …
  <service id="sessions">
   …
    <jsm xmlns="jabber:config:jsm">
     …
      <admin>
        <read>user@localhost</read>
        <write>user@localhost</write>
        <reply>
          <subject>Auto Reply</subject>
          <body>This is a special administrative address.  Your message was received and forwarded to server administrators.</body>
        </reply>
      </admin>
</file>

sert à définir le message de réponse lorsqu'un utilisateur << chattera >> avec votre serveur (en entrant seulement le nom du serveur comme utilisateur).

Remplacez le texte compris entre <read> et </read> ainsi que le texte compris entre <write> et </write> par l'adresse de l'administrateur du serveur.

Vous pouvez ajouter plusieurs <read>…</read> et <write>…</write> pour définir plusieurs administrateurs.

Remplacez ensuite le texte compris entre <subject> et </subject> par le sujet du message qui sera envoyé. 
Puis remplacez le texte compris entre <body> et </body> par votre message.

Voilà, la configuration de base de votre serveur est terminée ! vous n'avez plus qu'a redémarrer votre serveur jabberd14 en entrant : 
<code># /etc/init.d/jabberd14 restart</code>

==== Sécurisation des connexions avec OpenSSL ====

Pour sécuriser la connexion avec OpenSSL, il va tout d'abord faloir créer un certificat et une clé.

Assurez-vous que le paquet openssl est dors et déjà installé, sinon installez-le.

Entrez ensuite :

<code>
openssl req -new -x509 -newkey rsa:1024 -days 3650 -keyout privkey.pem -out key.pem
openssl rsa -in privkey.pem -out privkey.pem
cat privkey.pem >> key.pem
rm privkey.pem
</code>

Vous obtenez alors un fichier « key.pem ».
Copiez ce fichier dans un répertoire précis, comme « /etc/jabber/ssl/key.pem »

Éditez alors votre fichier jabber.xml et décommentez les lignes : 
<file>
<pthcsock>
  …
  <ssl port="5223">your-ip-address</ssl>
  …
</pthcsock>
…
<io>
  …
  <ssl>
    <key ip="your-ip-address">/path/to/cert_and_key.pem</key>
  </ssl>
  …
</io>
</file>
en remplacant « your-ip-address » par l'adresse ip de votre serveur.
Attention, aucun nom de dommaine n'est autorisé.

Remplacez aussi « /path/to/cert_and_key.pem » par l'emplacement de votre key.pem, pour mon exemple « /etc/jabber/ssl/key.pem »

Assurez-vous également que le fichier key.pem soit lisible par le serveur.

Enfin, ouvrez le port 5223 de votre routeur.

==== Pour aller plus loin ====

Vous pouvez, si vous le souhaitez encore plus approfondir la configuration de votre serveur : le fichier jabberd.xml est très bien documenté, certes, dans la langue de Shakespeare,  mais tout de même !

La documentation officielle http://jabberd.org/1.4/doc/adminguide vous permettra également de modeler votre configuration de jabberd14.