delete: ejabberd - service de messagerie Jabber XMPP
This commit is contained in:
Cédrix
Binary file not shown.
|
Before Width: | Height: | Size: 75 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 10 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 12 KiB |
@@ -1,181 +0,0 @@
|
||||
# ejabberd - service de messagerie Jabber XMPP
|
||||
|
||||
|
||||
|
||||
Il est nécessaire d'avoir (pré requis) pour ce tuto :
|
||||
- un service Apache - **httpd**
|
||||
- un service de base de données - **mariaDb**
|
||||
- un système d'exploitation **Linux Debian 10**
|
||||
|
||||
## Installer
|
||||
Pour installer **ejabberd** sous la distribution Linux **Debian**, il suffit de taper en ligne de commandes :
|
||||
|
||||
sudo apt install ejabberd
|
||||
|
||||
|
||||
|
||||
Un service `/lib/systemd/system/epmd.service` est créé. Un service `/lib/systemd/system/ejabberd.service` est créé et un fichier de configuration par défaut est déployé dans `/etc/ejabberd/ejabberd.yml`. Ce dernier point est traité ci-dessous.
|
||||
|
||||
## Installer la base de données
|
||||
**ejabberd** est compatible avec plusieurs SGBD. J'aborde l'installation avec **MariaDB**.
|
||||
|
||||
Crééer l'utilisateur **ejabberd** avec son mot de passe **password** (à modifier).
|
||||
|
||||
echo "GRANT ALL ON ejabberd.* TO 'ejabberd'@'localhost' IDENTIFIED BY 'password';" | mysql -h localhost -u root
|
||||
|
||||
Créer la base de données associée à l'utilisateur **ejabberd**
|
||||
|
||||
echo "CREATE DATABASE ejabberd;" | mysql -h localhost -u ejabberd -p
|
||||
|
||||
## Mettre à jour
|
||||
Vérifier la dernière version disponible à la page de [téléchargement ejabberd](https:*www.process-one.net/en/ejabberd/downloads/)
|
||||
|
||||
Vérifier les modifications a effectuer sur la page de la [procédure de mise à jour ejabberd](https:*docs.ejabberd.im/admin/upgrade/).
|
||||
|
||||
```BASH
|
||||
sudo systemctl stop ejabberd
|
||||
wget https:*www.process-one.net/downloads/downloads-action.php?file=/21.07/ejabberd_21.07-0_amd64.deb -O ejabberd.deb
|
||||
sudo apt install ./ejabberd.deb
|
||||
sudo systemctl start ejabberd
|
||||
```
|
||||
|
||||
<note important>Cette mise à jour à modifié les chemins de configuation dans `/opt/ejabberd/conf` et les logs dans `/opt/ejabberd/logs`.</note>
|
||||
|
||||
## Log
|
||||
|
||||
|
||||
Les fichiers logs sont présents dans le dossier `/var/log/ejabberd`.
|
||||
|
||||
Après la mise à jour en 21.07, ils se trouvent dans `/opt/ejabberd/logs/`
|
||||
|
||||
## Configurer
|
||||
Le nom du serveur doit être déclaré dans les DNS et dans le fichiers `/etc/hosts`.
|
||||
|
||||
Le fichier de configuration est au format YML. Il doit être déposé dans le chemin `/etc/ejabberd/ejabberd.yml`
|
||||
Après la mise à jour en 21.07, le dossier de configuration s'est trouvé dans `/opt/ejabberd/conf`.
|
||||
|
||||
Dans l'exemple suivants prenoms les paramètres :
|
||||
- nom de serveur retenu pour le service : im.domain.tld, xmpp.domain2.tld
|
||||
- adresse ip : 45.54.65.42
|
||||
|
||||
## Configurer les champs DNS
|
||||
Déclarer les champs DNS suivants :
|
||||
|
||||
```
|
||||
im IN A 45.54.65.42
|
||||
*.im IN A 45.54.65.42
|
||||
```
|
||||
|
||||
## Configurer le SSL
|
||||
Je vous conseille d'associer un serveur http au nom de domaine *im.domain.tld// de votre service. Cela permettra de faire une page d'accueil web avec des services associés. Par la même occasion, effectuer une demande SSL. Les certificats seront générés dans le dossier `/etc/letsencrypt/live`. Il faudra copier la clé et le certificat dans le dossier de config de **ejabberd**.
|
||||
|
||||
```BASH
|
||||
sudo sh -c "cat /etc/letsencrypt/live/im.domain.tld/privkey.pem /etc/letsencrypt/live/im.domain.tld/fullchain.pem > /opt/ejabberd/conf/server.pem"
|
||||
```
|
||||
|
||||
Par conséquence, il est facile d'indiquer à **ejabberd** le certificat à utiliser :
|
||||
|
||||
```
|
||||
certfiles:
|
||||
1. "opt/ejabberd/conf/server.pem"
|
||||
```
|
||||
|
||||
## Configurer le host
|
||||
Il faut définir les hosts sur lesquels ejabberd écoute :
|
||||
```
|
||||
hosts:
|
||||
1. "im.domain.tld"
|
||||
1. "xmpp.domain2.tld"
|
||||
```
|
||||
|
||||
Le fichier peut prendre en compte autant de domaine que l'on souhaite avec des cas de configuration distinct. C'est le principe du `virtual hosting`
|
||||
|
||||
```
|
||||
host_config:
|
||||
im.domain.tld:
|
||||
...
|
||||
xmpp.domain2.tld:
|
||||
...
|
||||
```
|
||||
|
||||
## Configurer le type d'authentification
|
||||
On peut se baser sur une authentification **anonymous**, **pam**, **jwt**, **sql**, **internal** et **ldap**.
|
||||
|
||||
```
|
||||
host_config:
|
||||
im.domain.tld:
|
||||
auth_method: internal
|
||||
xmpp.domain2.tld:
|
||||
auth_method: sql
|
||||
sql_type: odbc
|
||||
sql_server: "DSN=ejabberd;UID=ejabberd;PWD=ejabberd"
|
||||
```
|
||||
|
||||
## Configurer les modules
|
||||
```
|
||||
## Configuration of modules that are common to all vhosts
|
||||
modules:
|
||||
mod_roster: {}
|
||||
mod_configure: {}
|
||||
mod_disco: {}
|
||||
mod_private: {}
|
||||
mod_time: {}
|
||||
mod_last: {}
|
||||
mod_version: {}
|
||||
|
||||
append_host_config:
|
||||
## Add some modules to vhost one:
|
||||
im.domain.tld:
|
||||
modules:
|
||||
mod_muc:
|
||||
host: conference.im.domain.tld
|
||||
mod_ping: {}
|
||||
## Add a module just to vhost two:
|
||||
xmpp.domain2.tld:
|
||||
modules:
|
||||
mod_muc:
|
||||
host: conference.xmpp.domain2.tld
|
||||
```
|
||||
|
||||
## Configurer les options
|
||||
```
|
||||
language: fr
|
||||
```
|
||||
|
||||
|
||||
|
||||
===== Configurer le module audio/vidéo STUN/TURN =====
|
||||
|
||||
Le module `mod_stun_disco` est disponible depuis la version 20.04.
|
||||
|
||||
```yamel
|
||||
modules:
|
||||
...
|
||||
mod_stun_disco:
|
||||
credentials_lifetime: 12h
|
||||
services:
|
||||
-
|
||||
host: 0.0.0.0
|
||||
port: 3478
|
||||
type: stun
|
||||
transport: udp
|
||||
restricted: false
|
||||
-
|
||||
host: 0.0.0.0
|
||||
port: 3478
|
||||
type: turn
|
||||
transport: udp
|
||||
restricted: true
|
||||
-
|
||||
host: im.domain.tdl
|
||||
port: 5349
|
||||
type: stuns
|
||||
transport: tcp
|
||||
restricted: false
|
||||
-
|
||||
host: im.domain.tdl
|
||||
port: 5349
|
||||
type: turns
|
||||
transport: tcp
|
||||
restricted: true
|
||||
```
|
||||
@@ -1,18 +0,0 @@
|
||||
{
|
||||
"uuid": "262b51cb-f69d-45a4-ac92-4cd9b3bce78c",
|
||||
"slug": "ejabberd-service-de-messagerie-jabber-xmpp",
|
||||
"title": "ejabberd - service de messagerie Jabber XMPP",
|
||||
"author": "cedric@abonnel.fr",
|
||||
"published": true,
|
||||
"published_at": "2023-02-10 22:48:50",
|
||||
"created_at": "2023-02-10 22:48:50",
|
||||
"updated_at": "2023-02-10 22:48:50",
|
||||
"revisions": [],
|
||||
"cover": "",
|
||||
"files_meta": [],
|
||||
"external_links": [],
|
||||
"seo_title": "",
|
||||
"seo_description": "",
|
||||
"og_image": "",
|
||||
"category": "Informatique"
|
||||
}
|
||||
Reference in New Issue
Block a user