Utiliser Matterbridge

Ce qui suit est basé sur un tutoriel pour utiliser Matterbridge avec le plugin : Matterbridge + Peertube

Pré-requis

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.

Information

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.