====== Installer un pont Signal - Matrix ======

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 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 [[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 git</code>

Installez le module shared-secret-authenticator :
<code bash>sudo pip install git+https://github.com/devture/matrix-synapse-shared-secret-auth</code>

==== Signald ====

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).

On va récupérer le dépôt officiel en commençant par récupérer les clés de signature :
<code bash>
sudo wget -O /usr/share/keyrings/signald.gpg https://signald.org/signald.gpg
</code>

Créez le fichier
<code>/etc/apt/sources.list.d/signald.list</code>

Ajoutez les lignes suivante puis enregistrez
<code>deb [signed-by=/usr/share/keyrings/signald.gpg] https://updates.signald.org unstable main</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 pour installer Libolm, nécessaire au chiffrement :
<code bash>sudo aptitude install libolm-dev python3-dev build-essential</code>

===== Matruix-signal =====

==== Installation ====

Créez un répertoire et accédez-y
<code bash>mkdir mautrix-signal && cd mautrix-signal</code>

Créez l'environnement Python
<code bash>virtualenv -p /usr/bin/python3 .</code>

Activez-le
<code bash>source ./bin/activate</code>

Installez le pont
<code bash>pip install --upgrade mautrix-signal[all]</code>

L'installation est finie, on peut passer à la configuration

==== Configuration ====

Créez une copie du fichier example-config.yaml
<code bash>cp example-config.yaml config.yaml</code>

Ouvrez le fichier config.yaml. Si votre serveur Matrix tourne sur la même machine que le pont, remplacez la ligne 
<code>address: https://example.com</code>
par 
<code>address: http://localhost:8008</code>
Si le serveur Matrix tourne sur une autre machine, indiquez l'url du serveur Matrix.

Dans la ligne
<code>domain: example.com</code>
remplacez example.com par le domaine servant à accéder à votre serveur Matrix

Remplacer la ligne
<code>database: postgres://username:password@hostname/db</code>
par
<code>database: postgres://signalbridge:motdepasse@localhost:5432/signalbridge</code>
Mettez le mot de passe de votre choix, on créera la base de données plus tard.

Dans la partie "permissions", adaptez les lignes à votre cas. Dans mon cas, je n'ai qu'un seul utilisateur qui est admin.
J'ai donc que la ligne
<code>'@fate:matrix.nomdedomaine.fr': admin</code>
Remplacez "fate" par votre nom d'utilisateur ainsi que "nomdedomaine.fr" par l'url d'accès à votre serveur Matrix.

Dans la partie "encryption", passez les options "allow" et "default" à true pour activer le chiffrement entre le pont et le serveur Matrix

Pour que le pont puisse accéder à Signald, il a besoin d'avoir accès au fichier socket (remplacez "pi" par l'utilisateur qui exécutera le pont)
<code bash>sudo chown signald:pi /var/run/signald/</code>

L'utilisateur qui exécute le pont a besoin d'être membre du groupe signald pour accéder au répertoire (sinon vous aurez des erreurs lors d'envoi de message avec des photos)
<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 adduser pi signald</code>

Passons à la base de données

==== Création de la base de données ====

Connectez-vous avec l'utilisateur postgres
<code bash>sudo -i -u postgres</code>

Lancez PostgreSQL
<code bash>psql</code>

Créez l'utilisateur
<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

Créez la base de données
<code sql>CREATE DATABASE signalbridge OWNER signalbridge;</code>

Quittez PostgreSQL
<code bash>exit</code>

Déconnectez-vous de l'utilisateur postgres
<code bash>exit</code>

==== Registration.yaml ====

Les ponts ont besoin d'un fichier registration.yaml pour avoir certain droits sur votre serveur. Pour le créer, lancez la commande suivante
<code bash>python -m mautrix_signal -g</code>

Ensuite ouvrez le fichier homeserver.yaml de votre serveur et indiquez l'emplacement du fichier registration après la ligne "app_service_config_files:"
<code>
# A list of application service config file to use
app_service_config_files:
- "/home/pi/mautrix-signal/registration.yaml"
</code>

Relancez votre serveur Matrix
<code bash>sudo systemctl restart matrix-synapse.service</code>

===== Lancement du pont via Systemd =====

Créez le fichier 
<code>/etc/systemd/system/mautrix-signal.service</code>

Copiez les lignes suivantes dedans
<code>

[Unit]
Description=mautrix-signal bridge
After=matrix-synapse.service postgresql.service

[Service]
# N.B. If you didn't create a user with the correct home directory, set this
#      to the directory where config.yaml is (e.g. /opt/mautrix-signal).
WorkingDirectory=/home/pi/mautrix-signal/
ExecStart=/home/pi/mautrix-signal/bin/python -m mautrix_signal
User=pi

[Install]
WantedBy=multi-user.target
</code>
Modifier les chemins et le nom de l'utilisateur si besoin.

Activez le service au démarrage
<code bash>sudo systemctl enable mautrix-signal.service</code>

Démarrez le service
<code bash>sudo systemctl start mautrix-signal.service</code>

Dans votre client Matrix (Element), ouvrez une discussion privée avec le bot @signalbot:votre.serveur

Dans la discussion, tapez 
<code>link signal-bridge</code>
Ca va vous afficher un QR code que vous devrez scanner avec votre application Signal pour lier les deux appareils.

===== 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és comme lus sur les autres appareils.

Installez Shared Secret Authenticator
<code bash>sudo -u matrix-synapse pip install git+https://github.com/devture/matrix-synapse-shared-secret-auth</code>

Générez un secret
<code bash>pwgen -s 128 1</code>

Ouvrez le fichier homeserver.yaml de Synapse et ajoutez les lignes suivantes
<code>
modules:
    - module: shared_secret_authenticator.SharedSecretAuthProvider
      config:
          shared_secret: "collez ici le secret généré précédemment"
          # 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
<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
<code>sudo systemctl restart matrix-synapse.service</code>
<code>sudo systemctl restart mautrix-signal.service</code>

===== Mise à 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 * * * /home/pi/matrix_bridges/update_signal_bridge.sh

Appuyez sur CTRL + O puis CTRL + X pour appliquer les modifications.

Tous les jours à minuit, le pont se mettra à jour si une nouvelle version est disponible.