Différences

Ci-dessous, les différences entre deux révisions de la page.

--- serveur_hebergement:matrix:installer_un_pont_signal_-_matrix [2022/05/10 12:07] – ↷ Page déplacée de gnu_linux:matrix:installer_un_pont_signal_-_matrix à serveur_hebergement:matrix:installer_un_pont_signal_-_matrix fate
+++ serveur_hebergement:matrix:installer_un_pont_signal_-_matrix [2025/01/25 17:03] (Version actuelle) – fate
@@ Ligne 3: / Ligne 3: @@
 Matrix est capable d'échanger avec d'autres protocoles grâce à des ponts.
-Les étapes pour installer un pont sont plus ou moins les mêmes quelque soit le pont. On va voir comment installer un pont entre Signal et Matrix, [[https://github.com/mautrix/signal|matruix-signal]], qui vous permettra de recevoir/envoyer des messages de ou vers vos contacts Signal.
+Les étapes pour installer un pont sont plus ou moins les mêmes quel que soit le pont. On va voir comment installer un pont entre Signal et Matrix, [[https://github.com/mautrix/signal|matruix-signal]], qui vous permettra de recevoir/envoyer des messages de ou vers vos contacts Signal.
 ===== Prérequis =====
-Il vous faut un serveur Matrix, Synapse par exemple, et PostgreSQL. Je pars du principe que vous avez suivi le tuto sur comment [[gnu_linux:matrix:installer_matrix|Installer Matrix]] et que vous avez déjà ces deux logiciels d'installés.
+Il vous faut un serveur Matrix, Synapse par exemple, et PostgreSQL. Je pars du principe que vous avez suivi le tuto sur comment [[serveur_hebergement:matrix:installer_matrix|Installer Matrix]] et que vous avez déjà ces deux logiciels d'installés.
 ==== Python3 ====
 Installez Python3 ainsi que pip et virtualenv
-<code bash>sudo aptitude install python3 virtualenv python3-pip</code>
+<code bash>sudo aptitude install python3 virtualenv python3-pip git</code>
-==== Signald ====
+Installez le module shared-secret-authenticator :
+<code bash>sudo pip install git+https://github.com/devture/matrix-synapse-shared-secret-auth</code>
-Il va nous falloir également installer [[https://gitlab.com/signald/signald|Signald]], un logiciel qui permet d'interagir avec Signal (comme la version desktop de Signal).
-Créez le fichier
-<code>/etc/apt/sources.list.d/signald.list</code>
-Ajoutez les ligne suivante puis enregistrez
-<code>deb https://updates.signald.org unstable main</code>
-Ajoutez les clés du dépôt
-<code bash>curl https://updates.signald.org/apt-signing-key.asc | sudo apt-key add -</code>
-Mettez à jours les paquets
-<code bash>sudo aptitude update</code>
-Installez Signald
-<code bash>sudo aptitude install signald</code>
 ==== Libolm et bibliothèques dev ====
-Lancez la commande suivante
+Lancez la commande suivante pour installer Libolm, nécessaire au chiffrement :
 <code bash>sudo aptitude install libolm-dev python3-dev build-essential</code>
@@ Ligne 89: / Ligne 74: @@
 <code>/var/lib/signald/</code>
 L'utilisateur qui exécute le pont chez moi est "pi". Pour le rajouter au groupe signald, lancez la commande
-<code bash>sudo addgroup pi signald</code>
+<code bash>sudo adduser pi signald</code>
 Passons à la base de données
@@ Ligne 102: / Ligne 87: @@
 Créez l'utilisateur
-<code sql>CREATE USER signalbridge WITH PASSWORD 'motdepasse';</code>
+<code sql>CREATE ROLE signalbridge LOGIN PASSWORD 'mot_de_passe';</code>
 Mettez le même mot de passe que celui que vous avez renseigné dans le fichier config.yaml
@@ Ligne 167: / Ligne 152: @@
 ===== Activer le double puppeting =====
-Le "double puppeting" permet que lorsque vous envoyez un message depuis l'application Signal, le message sera également présent dans Matrix et les messages marqués comme lu dans Matrix seront également marqué comme lus sur les autres appareils.
+Le "double puppeting" permet que lorsque vous envoyez un message depuis l'application Signal, le message sera également présent dans Matrix et les messages marqués comme lu dans Matrix seront également marqués comme lus sur les autres appareils.
-Installez Shared Secret Authenticator
+Créez un fichier doublepupetting.yaml dans le répertoire du pont et copiez les lignes suivantes :
-<code bash>sudo -u matrix-synapse pip install git+https://github.com/devture/matrix-synapse-shared-secret-auth</code>
+<code>
+# The ID doesn't really matter, put whatever you want.
+id: doublepuppet
+# The URL is intentionally left empty (null), as the homeserver shouldn't
+# push events anywhere for this extra appservice. If you use a
+# non-spec-compliant server, you may need to put some fake URL here.
+url:
+# Generate random strings for these three fields. Only the as_token really
+# matters, hs_token is never used because there's no url, and the default
+# user (sender_localpart) is never used either.
+as_token: votre_token
+hs_token: votre_token
+sender_localpart: votre_token
+# Bridges don't like ratelimiting. This should only apply when using the
+# as_token, normal user tokens will still be ratelimited.
+rate_limited: false
+namespaces:
+  users:
+  # Replace your\.domain with your server name (escape dots for regex)
+  - regex: '@.*:votre\.domaine\.fr'
+    # This must be false so the appservice doesn't take over all users completely.
+    exclusive: false
+</code>
-Générez un secret
+Vous pouvez générer un token avec la commande suivante (les 3 tokens doivent être différents) :
 <code bash>pwgen -s 128 1</code>
-Ouvrez le fichier homeserver.yaml de Synapse et ajoutez les lignes suivantes
+Ouvrez le fichier homeserver.yaml de Synapse et ajoutez les lignes suivantes dans la section double_puppet:
 <code>
-modules:
+# Shared secrets for automatic double puppeting.
-    - module: shared_secret_authenticator.SharedSecretAuthProvider
+    # See https://docs.mau.fi/bridges/general/double-puppeting.html for instructions.
-      config:
+    secrets:
-          shared_secret: "collez ici le secret généré précédemment"
+        votre.domaine.fr: as_token:votre_token_as
-          # By default, only login requests of type `com.devture.shared_secret_auth` are supported.
-          # Below, we explicitly enable support for the old `m.login.password` login type,
-          # which was used in v1 of matrix-synapse-shared-secret-auth and still widely supported by external software.
-          # If you don't need such legacy support, consider setting this to `false` or omitting it entirely.
-          m_login_password_support_enabled: true
 </code>
-Ouvrez le fichier config.yaml et remplacez les lignes
+Enfin, ouvrez le fichier de config de Matrix et ajoutez dans la section app_service_config_files le chemin vers votre fichier doublepupetting.yaml
-<code>
-login_shared_secret_map:
-        example.com: foo
-</code>
-par
-<code>
-login_shared_secret_map:
-        adresse_du_serveur_matrix: secret_généré_précédemment
-</code>
 Redémarrez Synapse et le pont Signal
@@ Ligne 205: / Ligne 198: @@
 ===== Mise à jour =====
-On va créer une tâche cron pour mettre à jour le pont une fois par jour.
+On va créer un script pour mettre à jour le pont.
+Créez le fichier update_signal_bridge.sh dans le même répertoire que le dossier mautrix-signal et ajoutez-y les lignes suivantes (remplacez votreadressemail par une adresse mail valide et modifiez le chemin vers le dossier mautrix-signal):
+<code bash>
+#!/bin/bash
+errorFile="../mautrix-signalErrorUpdate"
+versionFile="../mautrix-signalVersion"
+adminMail="votreadressemail"
+cd /chemin/vers/mautrix-signal
+source ./bin/activate
+# Si le fichier de version existe, on récupére la version
+if [ -f $versionFile ]; then
+                currentVersion=$(cat $versionFile)
+#S'il n'existe pas, on force la version à 0
+else
+        currentVersion="0"
+fi
+# On récupère le numéro de la version présent sur le dépôt
+repositoryVersion=$(yolk -V mautrix-signal | awk '{print $2}')
+# Si la version présente sur le dépôt est plus récente, on lance la mise à jour
+if [ $currentVersion != $repositoryVersion ]; then
+        # On supprime l'ancien fichier d'erreur s'il existe
+        if [ -f $errorFile ]; then
+                rm -f $errorFile
+        fi
+        # On lance la mise à jour du paquet
+        pip install --upgrade mautrix-signal[all] > /dev/null 2> $errorFile
+        # Si le fichier d'erreur n'est pas vide, on envoie un mail d'erreur
+        if [ -s $errorFile ]; then
+                echo "Une erreur s'est produite lors de la mise à jour du pont Signal-Matrix (mautrix-signal). Le message d'erreur se trouve en pièce-jointe." | mutt -x -s "Erreur lors de la mise à jour du pont Signal-Matrix" -a $errorFile -- $adminMail
+        # Si le fichier d'erreur est vide, on envoie un mail de mise à jour et on met à jour le fichier de version
+        else
+                echo "Le pont mautrix-matrix (mautrix-signal) a été mis à jour de la version $currentVersion vers la version $repositoryVersion" | mutt -x -s "Mise à jour du pont mautrix-Matrix" -- $adminMail
+                echo "$repositoryVersion" > $versionFile
+        fi
+fi
+</code>
+Le script est commenté afin qu'il soit facile de comprendre chaque bloc. Pour que ce script fonctionne pleinement il faut que votre serveur soit capable d'envoyer des e-mails, sinon les mises à jours se lanceront mais vous ne serez pas averti lors des mises à jour ou des erreurs de mise à jour. Il vous faut également York pour récupérer les versions présentes sur les dépôts. Vous pouvez l'installer avec la commande suivante :
+<code bash>pip install yolk3k</code>
+On va créer une tâche cron afin que ce script se lance tous les jours.
 Ouvrez le fichier cron avec la commande
 <code bash>crontab -e</code>
 Ajoutez la ligne suivante (remplacez l'emplacement du répertoire) :
-<code bash>0 0 * * * cd /home/pi/matrix_bridges/mautrix-signal && source ./bin/activate && pip install --upgrade mautrix-signal[all]</code>
+<code bash>0 0 * * * /home/pi/matrix_bridges/update_signal_bridge.sh
 Appuyez sur CTRL + O puis CTRL + X pour appliquer les modifications.