Utiliser Matterbridge
Ce qui suit est basé sur un tutoriel pour utiliser Matterbridge avec le plugin : Matterbridge + Peertube
Pré-requis
- Plugin PeerTube livechat version 3.2.0 ou supérieure.
- Matterbridge version 1.22.4 ou supérieure.
La solution la plus simple consiste à faire tourner l’instance PeerTube et Matterbridge sur le même serveur.
Connexions internes uniquement (version simple)
Vous devez activer Activer les connexions client vers serveur
dans les
paramètres du plugin livechat.
Cela permettra aux clients XMPP de l’hôte local de se connecter au serveur XMPP Prosody.
Vous devrez peut-être ajouter une ligne à votre /etc/hosts
:
127.0.0.1 anon.example.org room.example.org
Remplacez example.org
par le nom de domaine de votre instance. Vous pouvez
ensuite poursuivre avec la configuration de Matterbridge ci-dessous.
Autoriser les connexions externes (avancé)
Par défaut, le serveur interne XMPP Prosody n’écoute que sur localhost (127.0.0.1).
Sur les versions de livechat >= 10.1.0, un nouvel appel d’option interfaces client vers serveur
a été ajouté pour permettre de changer cela.
Cela permet d’ajouter une liste d’adresses IP sur lesquelles écouter, séparées par des virgules (les espaces seront supprimés).
Vous pouvez également utiliser *
pour écouter sur toutes les interfaces
IPv4, et ::
pour toutes les interfaces IPv6. Cela permet un accès externe
à l’interface client-serveur.
Ensuite, vous devez ouvrir le port C2S (par défaut 52822
, mais vérifiez
les paramètres du plugin pour obtenir la valeur actuelle) dans votre
pare-feu afin qu’il soit accessible depuis l’internet. Si vous ne souhaitez
pas utiliser les connexions C2S pour autre chose que votre service
Matterbridge, vous devriez restreindre l’accès à ce port à l’IP de votre
serveur Matterbridge.
Vous devez également ajouter des enregistrements DNS (A et AAAA) pour
anon.example.org
et room.example.org
(remplacez example.org
par votre
nom de domaine actuel).
Si vous utilisez un port autre que 5222
(port standard XMPP), vous devez
également définir l’enregistrement SRV
xmpp-client sur le port correct.
Configurer Matterbridge
Dans la version 1.22.4, Matterbridge a ajouté la prise en charge des connexions anonymes XMPP, nécessaires pour se connecter au serveur Prosody intégré.
Ainsi, dans le fichier de configuration TOML, il faut mettre :
[xmpp.mypeertube]
Anonymous=true
Server="anon.example.org:52822"
Muc="room.example.org"
Nick="Matterbridge"
RemoteNickFormat="[{PROTOCOL}] <{NICK}> "
NoTLS=true
- Remplacez
example.org
par le nom de domaine de votre instance. - Remplacez
52822
par le port actuel si vous l’avez changé. mypeertube
peut être remplacé par un autre nom.- L’utilisation de
peertube
comme pseudonyme (Nick) fournira l’icône PeerTube pour les messages superposés, ce qui peut également être fait avec la modification de la configuration de la superposition. - Le paramètre
NoTLS=true
permet de se connecter à un serveur avec des certificats auto-signés.
Vous pouvez désormais ajouter ce compte aux passerelles et faire le pont des canaux de tchat.
Cette documentation utilise un compte anonyme pour connecter la passerelle
au tchat. Mais depuis la version 10.1.0 de livechat, il existe une nouvelle
façon de générer un jeton d’authentification à long terme, qui permet de se
connecter en utilisant son compte. Ceci est utilisé pour les docks
OBS. L’utilisation de
cette fonctionnalité à d’autres fins n’est pas documentée et n’est pas
encore officiellement supportée. Si vous voulez l’utiliser quand même, vous
pouvez demander un jeton en appelant le point de terminaison
/plugins/livechat/router/api/auth/tokens
. Pour obtenir les en-têtes et
le corps de requête nécessaires, regardez simplement ce qui se passe lorsque
vous générez un nouveau jeton pour les docks OBS.