Installer le serveur de messagerie instantanée Prosody (XMPP)

Installer le serveur de messagerie Prosody (XMPP)

Prosody est un serveur de messagerie instantanée XMPP écrit en LUA. Ses objectifs sont d'être simple à configurer, d'être modulaire et de consommer peu de ressource système.

1. Installation

Rien de plus simple pour l'installer ! Il suffit d'exécuter la commande suivante.

pkg_add -i prosody

# pkg_add -i prosody
quirks-2.241 signed on 2016-07-26T16:56:10Z
prosody-0.9.10p2:libidn-1.32p1: ok
prosody-0.9.10p2:lua-5.1.5p6: ok
prosody-0.9.10p2:luafs-1.6.3p0: ok
prosody-0.9.10p2:luadbi-0.5p0: ok
prosody-0.9.10p2:luazlib-20100731p2: ok
prosody-0.9.10p2:luasocket-3.0rc1p1: ok
prosody-0.9.10p2:luasec-0.6p0: ok
prosody-0.9.10p2:luaexpat-1.3.0p0: ok
prosody-0.9.10p2: ok
The following new rcscripts were installed: /etc/rc.d/prosody
See rcctl(8) for details.
Look in /usr/local/share/doc/pkg-readmes for extra documentation.

2. Configuration minimale

Une fois l'installation effectuée, il faut éditer le fichier de configuration prosody.cfg.lua.

A savoir que le double-tiret -- sert à commenter les lignes.

nano /etc/prosody/prosody.cfg.lua

-- VirtualHost "localhost"
VirtualHost "votredomaine.fr"

Documentation : https://prosody.im/doc/configure

3. Premier démarrage

Après avoir configuré notre domaine, nous pouvons dès à présent démarrer notre serveur prosody.

rcctl start prosody

Nous vérifions ensuite que le service est bien démarré.

prosodyctl status

# prosodyctl status
Prosody is running with PID 99255

Pour qu'il soit exécuté à chaque démarrage, nous devons l'activer.

rcctl enable prosody

Documentation : https://prosody.im/doc/prosodyctl

4. Ajouter un utilisateur

Par défaut, l'option de création de compte via un client XMPP est désactivée. Il s'agit de la ligne allow_registration = false; du fichier de configuration.

Nous devons donc le créer manuellement via la commande suivante où votredomaine.fr est celui que nous avons spécifié dans le VirtualHost du fichier de configuration.

prosodyctl adduser user@votredomaine.fr

Nous pouvons ensuite nous connecter avec le client XMPP de notre choix et vérifier le fichier log.

cat /var/prosody/prosody.log

# cat /var/prosody/prosody.log
Mar 25 11:48:13 general info    Hello and welcome to Prosody version 0.9.10
Mar 25 11:48:13 general info    Prosody is using the select backend for connection handling
Mar 25 11:48:13 portmanager     info    Activated service 'c2s' on [::]:5222, [*]:5222
Mar 25 11:48:13 portmanager     info    Activated service 'legacy_ssl' on no ports
Mar 25 11:48:13 portmanager     info    Activated service 's2s' on [::]:5269, [*]:5269
Mar 25 11:48:13 mod_posix       info    Prosody is about to detach from the console, disabling further console output
Mar 25 11:48:13 mod_posix       info    Successfully daemonized to PID 5826
Mar 25 11:49:16 c2s107ce75ddf80 info    Client connected
Mar 25 11:49:20 c2s107ce75ddf80 info    Authenticated as user@votredomaine.fr
Mar 25 11:49:37 c2s107ce75ddf80 info    Client disconnected: closed

Pour changer le mot de passe d'un utilisateur.

prosodyctl passwd user@votredomaine.fr

Pour supprimer un utilisateur.

prosodyctl deluser user@votredomaine.fr

Documentation : http://prosody.im/doc/creating_accounts

5. Configurer le mode SSL

Commençons par générer le certificat.

prosodyctl cert generate votredomaine.fr

# prosodyctl cert generate votredomaine.fr
Choose key size (2048): 2048
Generating RSA private key, 2048 bit long modulus
...............................................+++
...........................+++
e is 65537 (0x10001)
Key written to /var/prosody/votredomaine.fr.key
Please provide details to include in the certificate config file.
Leave the field empty to use the default value or '.' to exclude the field.
countryName (GB): FR
localityName (The Internet): 
organizationName (Your Organisation): 
organizationalUnitName (XMPP Department):
commonName (votredomaine.fr):
emailAddress (xmpp@votredomaine.fr):

Config written to /var/prosody/votredomaine.fr.cnf
Certificate written to /var/prosody/votredomaine.fr.crt

Puis spécifions cela dans le fichier de configuration.

nano /etc/prosody/prosody.cfg.lua

-- These are the SSL/TLS-related settings. If you don't want
-- to use SSL/TLS, you may comment or remove this
ssl = {
        key = "/var/prosody/votredomaine.fr.key";
        certificate = "/var/prosody/votredomaine.fr.crt";
}

Ensuite on recharge la configuration et on redémarre le serveur.

prosodyctl reload

# prosodyctl reload
Prosody log files re-opened and config file reloaded. You may need to reload modules for some changes to take effect.

prosodyctl restart

# prosodyctl restart
Stopped
Started

Documentation : https://prosody.im/doc/certificates