✎ prosody [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== Prosody ======

Prosody est un serveur Jabber libre, entièrement écrit en Lua, ce qui le rend très léger, simpliste et facile à configurer.

Il est bien sûr gratuit, et très jeune, ce qui peut être (pour certaines personnes), un désavantage par rapport à ses concurrents.

===== Installation =====

==== Depuis les dépôts officiels (Lucid) ====

<code bash> sudo apt-get install prosody</code>

==== Sur Karmic et versions antérieures d'Ubuntu ====

Prosody n'étant pas  disponible dans les dépôts officiels de ces [[versions]], vous devrez télécharger le paquet Debian sur le [[http://prosody.im/|site officiel]] du serveur Jabber Prosody.

<note important>Ce logiciel ne provient pas des dépôts officiels Ubuntu, ce qui fait que vous devez faire confiance à la source depuis laquelle vous le récupérez ([[http://prosody.im/]])</note>

Récupérez donc le paquet directement depuis [[http://prosody.im/download/start#debian_and_ubuntu|cette page]] afin d'installer le paquet localement par la suite.

N'oubliez pas d'installer le paquet additionnel de la librairie Lua, permettant d'utiliser le chiffrement SSL avec Prosody :

<code bash>sudo apt-get install liblua5.1-sec1</code>

Ceci fait, redémarrez le serveur Prosody :

<code bash>sudo /etc/init.d/prosody restart</code>

Si le paquet additionnel est correctement installé, vous ne devriez pas obtenir de message d'erreur dans le terminal lors du redémarrage du serveur XMPP.

===== Configuration =====

La grande puissance de Prosody est aussi sa grande faiblesse : ce serveur a beau être très simpliste (il ne proposera pas autant de fonctionnalités que [[ejabberd]]), il est plus que simple à configurer !

Voyons donc les étapes de sa configuration ! C'est parti !

==== Ouvrir les ports ====

Si vous êtes derrière un pare-feu ou une box/routeur (de type Freebox, Livebox, etc...), il se peut que les ports nécessaires au bon fonctionnement du protocole XMPP (côté serveur) soient fermés. Ce serait bête d'installer un serveur Jabber si celui-ci ne peut être utilisé !

Dans le cas d'un pare-feu, référez-vous à la documentation de ce dernier afin de connaître la marche à suivre pour la configuration.

Si vous avez une box/routeur, le plus souvent l'interface d'administration est accessible directement depuis l'adresse réseau locale [[http://192.168.1.1]] ou encore [[http://192.168.0.1]]. Sur une Livebox, le mot de passe par défaut est admin, avec un identifiant du même nom. Il est probable que vous (ou une autre personne) ayez changé ce mot de passe auparavant.

Une fois connecté, voici la marche à suivre pour une Livebox (type SAGEM) :

- Allez dans //Serveurs LAN//
  - En bas de la liste, cliquez sur //Nouvelle entrée//
  - Puis remplissez le formulaire selon votre configuration et vos souhaits, en répétant le point précédent pour chaque port à ouvrir.

Voici donc les ports principaux à ouvrir :

* 5222 (TCP) -> communications client/serveur
  * 5269 (TCP) -> communications serveur/serveur
  * 5280 (TCP) -> communications http/serveur

==== Le fichier de configuration ====

Nous y sommes ! Nous avons le fichier de configuration de Prosody à configurer pour "activer" le serveur en quelques sortes, pour lui dire d'accepter les connexions. Ouvrez un terminal et entrez cette commande :

<code bash>sudo gedit /etc/prosody/prosody.cfg.lua</code>

Le système vous demande votre mot de passe, jusque là c'est relativement simple (et vous ne devez pas être en terre inconnue !).

Votre éditeur de texte favori s'ouvre (ou pas, ça dépend des goûts !), et vous présente le magnifique fichier de configuration de Prosody. Nous allons donc commencer par activer le serveur : scrollez tout en bas du fichier, et recherchez la ligne :

''**enabled = false**'' que vous remplacez par ''**enabled = true**'' (non, sans blague !)

Ceci fait, nous allons ajouter un hôte à notre serveur. Vous avez probablement un nom de domaine associé à votre serveur du genre "monsite.org", ou encore "monsite.dyndns.org" si vous avez une IP dynamique. Remplacez tout simplement la ligne :

''**Virtualhost "example.com"**'' par ''**Virtualhost "monsite.org"**'' (en mettant bien sûr votre domaine à la place de //monsite.org//)

Si vous souhaitez utiliser le SSL placez vous en root dans le repertoire /etc/prosody/certs puis entrer la commande suivante :
<code bash>openssl req -new -x509 -nodes -out nom.de.domaine.crt -keyout nom.de.domaine.key -days 1000</code>

Nous avons presque fini ! Après avoir bien configuré les clés de chiffrement dans ''**ssl = {}**'' (si vous les utilisez), nous allons modifier la ligne :

''**allow_registration = false;**'' en ''**allow_registration = true;**'' (sinon vous ne pourrez pas vous inscrire à votre propre serveur, ce serait dommage !)

Et voilà ! Plus qu'à ajouter l'adresse Jabber de l'admin sur serveur (en tout cas ce que vous envisagez de créer comme adresse tout à l'heure), en l'entrant entre les crochets dans la ligne :

''**admins = {  }**'', ce qui peut me donner ''**admins = { "moi@monsite.org" }**'' (n'oubliez pas les guillemets autour de l'adresse/JID)

Avant de confirmer la nouvelle configuration, je vous laisse parcourir le reste du fichier (désactiver/activer des modules, etc...), sauvegarder, puis nous allons redémarrer Prosody :

<code bash>sudo /etc/init.d/prosody restart</code>

Normalement, si tout s'est bien passé, vous n'avez aucun message d'erreur, et vous pouvez à présent accéder à votre serveur depuis votre ordinateur avec un logiciel comme [[Gajim]]. Cependant, si votre serveur se trouve sur votre ordinateur où vous allez l'utiliser, il est conseillé de rajouter une ligne au fichier hosts. Ouvrez donc :

<code bash>sudo gedit /etc/hosts</code>

Puis rajoutez une ligne du type :

''**127.0.0.1      monsite.org**'' (ce qui résoudra les problèmes de connexion en local avec certains routeurs)

Et voilà ! Vous pouvez maintenant chatter en toute liberté sur les réseaux libres Jabber, utilisant le (magnifique) protocole XMPP !

===== Désinstallation =====

Pour supprimer Prosody, il suffit d'entrer la commande suivante :

<code bash>sudo apt-get remove --purge prosody</code>

Vous pouvez aussi désinstaller les paquets de la librairie Lua s'ils ne sont plus utilisés.

===== Voir aussi =====

* (en) [[http://prosody.im/|Site officiel de Prosody]]
  * (fr) vanaryon.eu/2010/01/prosody-un-serveur-jabber-leger/|Prosody : un serveur Jabber léger  DELETEME ce site ne correspond plus. A changé de propriétaire ?
  * (en) [[http://prosody.im/doc/configure|Configurer Prosody]]
  * (en) [[http://library.linode.com/communications/xmpp/prosody/ubuntu-9.10-karmic|Tutoriel sur Prosody]]

----

//Contributeurs : [[http://www.vanaryon.eu/|Vanaryon]]//

Merci de recopier le code ci-contre pour prouver que vous êtes humain : D N G G B Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported