Commit 519d7912 authored by kaiyou's avatar kaiyou
Browse files

Add documentation about Matrix bridges

parent dff56eb5
Pipeline #1121 passed with stages
in 1 minute and 36 seconds
---
title: Documentation
menu:
side:
weight: 1
---
\ No newline at end of file
---
title: Compte TeDomum
---
\ No newline at end of file
......@@ -60,16 +60,6 @@ Pour mieux comprendre comment cela fonctionne, imaginons que Matrix (service) es
{{< figure src="images/bridges.gif" link="images/bridges.gif" target="_blank" width="100%" >}}
# Bridges
## Telegram
Nous avons un bridge permettant de communiquer avec les personnes utilisant Telegram. Ce bridge est disponible à l'adresse suivante : `@telegram:bridges.tedomum.net`
Toutes les commandes et fonctions sont disponibles en tapant `help` :
{{< figure src="images/telegram.png" link="images/telegram.png" target="_blank" width="70%" >}}
# Autres instances
Il existe d'autres instances Matrix. Si vous ne trouvez pas votre bonheur chez nous, peut-être le trouverez-vous ailleurs ?
......
---
title: Bridges Matrix
---
# Qu'est-ce qu'un bridge Matrix ?
Matrix est un réseau de messagerie fédéré, cela signifie que les utilisateurs ne sont pas enfermés sur un serveur mais peuvent s'inscrire et se connecter au serveur qu'ils souhaitent. Tout utilisateur de tout serveur Matrix peut parler à tous les autres. Toutefois, un utilisateur ne peut pas échanger via Matrix avec les utilisateurs d'autres services non compatibles, en particulier des services aux protocoles fermés ou non fédérés tels que Telgram, Signal, WhatsApp, Facebook Messenger, etc.
Afin de permettre les échanges avec ces services externes depuis Matrix, nous déployons des *bridges*, qui jouent le rôle de passerelle entre la messagerie Matrix et des services externes. Ils permettent d'interagir depuis Matrix avec un utilisateur Telegram ou WhatsApp par exemple.
Les bridges ne sont généralement pas entièrement transparents : il vous faudra disposer d'un compte sur les messageries en question par exemple.
# Bridge Telegram
Le bridge Telegram permet de connecter votre compte Telegram à votre messagerie Matrix, et d'échanger sur les salons et avec vos contacts Telegram.
## Rejoindre le bridge
Afin de connecter votre compte Telegram existant, suivez les étapes :
1. démarrez une nouvelle conversation avec `@telegram:bridges.tedomum.net`, il s'agit du robot de bridge qui permet de gérer la connexion ;
2. dans la conversation, envoyez `login` ;
3. lorsque le robot de bridge vous le demande, envoyez votre numéro de téléphone dans la conversation, au format international (par exemple `+336123456789`) ;
4. Telegram vous enverra un SMS ou un message sur votre client Telegram existant, envoyez le code dans la conversation ;
5. si un mot de passe est configuré pour votre compte, lorsque le robot vous le demande, envoyez le mot de passe dans la conversation.
Si vous avez saisi un mot de passe en particulier, vous pouvez soit effacer ce message, soit quitter la conversation avec le robot afin qu'elle soit supprimée.
## Quitter le bridge
Afin de quitter le bridge, et pour que le robot ne continue pas de récupérer vos messages Telegram, suivez les étapes :
1. démarrez une nouvelle conversation avec `@telegram:bridges.tedomum.net`, il s'agit du robot de bridge qui permet de gérer la connexion ;
2. dans la conversation, envoyez `logout` ;
3. attendez la confirmation du robot de bridge, il devrait également vous expulser de tous les salons Telegram ;
4. quittez la conversation.
## Sécurité
Le bridge ne supporte pas le chiffrement de bout en bout. Il est donc imossible de rejoindre un *Secret chat* Telegram.
Aussi, le bridge, ainsi que notre serveur Matrix, ont accès à vos messages Telegram.
Pour la conservation des messages, la gestion usuelle de notre serveur Matrix s'applique, c'est à dire que vous pouvez quitter les salons afin que les conversations soient supprimées de nos bases de données, ou bien vous pouvez effacer les messages afin qu'ils soient effacés de notre base de données.
Nous ne pouvons pas garantir que Telegram ne conserve pas une copie de vos messages.
## Plus de détails
Toutes les commandes et fonctions sont disponibles en envoyant `help` dans la conversation avec le robot de bridge :
{{< figure src="../images/telegram.png" link="../images/telegram.png" target="_blank" width="70%" >}}
\ No newline at end of file
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment