update matrix doc
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful

This commit is contained in:
Simon Vieille 2023-02-12 22:49:58 +01:00
parent 362f8958b8
commit 21a36974cf
Signed by: deblan
GPG key ID: 579388D585F70417
3 changed files with 53 additions and 15 deletions

View file

@ -0,0 +1,36 @@
# Présentation
Lors d'une précédente précédente AG, Alexis et Baptiste ont évoqué le souhait de changer notre outil principal de communication qui est Mattermost.
Nous avons choisi le protocole Matrix qui est libre, securisé (chiffré) et non centralisé par nature. En effet, tout le monde peut créer son propre serveur Matrix et s'interconnecter avec les autres. Bien évidemment, nous n'allons pas vous demander d'en installer un 🤪
Selon nous, Matrix réunit 4 points forts :
---
1. **il permet d'échanger des messages avec quasi n'importe quel autre protocole** (Telegram, Signal, WhatsApp, Facebook, Discord, IRC, etc.) sans sortir de l'outil (!!). Ainsi, on peut soi-même franchir le pas sans avoir à convaincre tous ses proches immédiatement
---
2. **il est chiffré**, contrairement à Mattermost
---
3. **on peut créer des salons privés mais aussi publics** : que n'importe qui peut rejoindre. Par exemple, le canal "Auto-hébergement" ouvert suite à l'atelier au Fablab tourne a plein régime !
---
4. **on peut se créer un compte sur notre serveur** (`matrix.tinternet.net`) **mais celleux qui préfèrent peuvent utiliser d'autres serveurs** "publics" comme matrix.org pour ne pas dépendre de Tinternet, ou pour le proposer à ses ami.e.s. Contre la centralisation : la fédération !
---
Par exemple, Simon est inscrit sur le serveur Matrix `neutralnetwork.org` avec le nom d'utilisateur `deblan`. Son identifiant complet est `@deblan:neutralnetwork.org`.
Baptise a choisi de créer son compte sur `baptabl.fr` et porte le nom d'utilisateur `bat`. Son identifiant complet est `@bat:baptabl.fr`.
Simon et Baptise peuvent communiquer ensemble en utilisant leur identifiant complet pour se retrouver, un peu comme pour les emails ! 🚀
Bref, Matrix, ça déchire vraiment 😎
Tinternet a mis en place son propre serveur Matrix : `matrix.tinternet.net`. Nous vous invitons à vous inscrire dessus !
Pour vous aider, nous avons rédigé cette documentation.

View file

@ -1,10 +1,10 @@
# Documentation de Matrix et Element
# Installation
## **Télécharger et installer le client Element**
Element est une interface pour utiliser Matrix. Element se télécharge depuis : [https://element.io/get-started#download](https://element.io/get-started#download)
Element est une interface pour utiliser Matrix. Element se télécharge depuis : [https://element.io/get-started#download](https://element.io/get-started#download)
Vous avez également une application mobile sur Android et Iphone :
Vous avez également une application mobile sur Android et Iphone :
[Android](https://play.google.com/store/apps/details?id=im.vector.app){.md-button .md-button--primary}
[IOS](https://apps.apple.com/fr/app/element-messenger/id1083446067){.md-button .md-button--primary}
@ -13,32 +13,32 @@ Vous avez également une application mobile sur Android et Iphone :
Lancer Element.
**Changement du serveur :**
**Changement du serveur :**
Pour s'inscrire sur le serveur de Tinternet, cliquer sur "Modifier" et renseigner "matrix.tinternet.net" :
Pour s'inscrire sur le serveur de Tinternet, cliquer sur `Modifier` et renseigner `matrix.tinternet.net` :
![](https://upload.deblan.org/u/2022-01/61e58b0a.png)
**Formulaire d'inscription :**
**Formulaire d'inscription :**
Seuls le nom d'utilisateur et le mot de passe sont obligatoires. Cependant, nous vous conseillons de saisir votre adresse mail pour récupérer le mot de passe en cas de perte.
!!! note "Information technique"
Afin de gérer les notifications par mail et par SMS lors de l'inscription, les données que vous fournissez sont transmises à element.io, un service géré par les développeurs du protocole Matrix.
Une fois le formulaire d'inscription validé, vous allez recevoir un mail avec un lien de confirmation :
Une fois le formulaire d'inscription validé, vous allez recevoir un mail avec un lien de confirmation :
![](https://upload.deblan.org/u/2022-01/61e58c50.jpg)
Votre identifiant complet est : **@nom d'utilisateur:matrix.tinternet.net**
Votre identifiant complet est : **@nom d'utilisateur:matrix.tinternet.net**
## Connexion au compte
Fermer et réouvrir Element et s'identifier :
Fermer et réouvrir Element et s'identifier :
![](https://upload.deblan.org/u/2022-01/61e58cc9.jpg)
Une fois connecté⋅e, vous verrez quelque chose de similaire à :
Une fois connecté⋅e, vous verrez quelque chose de similaire à :
![](https://upload.deblan.org/u/2022-01/61e58cf0.jpg)
@ -46,7 +46,7 @@ Une fois connecté⋅e, vous verrez quelque chose de similaire à :
Pour faciliter les échanges avec Tinternet, on a de créé une communauté qui regroupe plusieurs salons de discussions. On va y trouver les nouveaux GTI.
Cliquer sur "Explorer les salons publics", saisir **#tinternet-et-cie:matrix.tinternet.net** puis cliquer sur "Rejoindre" :
Cliquer sur `Explorer les salons publics`, saisir **#tinternet-et-cie:matrix.tinternet.net** puis cliquer sur `Rejoindre` :
<table>
<tr>
@ -70,13 +70,13 @@ Cliquer sur "Explorer les salons publics", saisir **#tinternet-et-cie:matrix.tin
Vous avez à présent la possibilité de rejoindre les salons publics de Tinternet \& cie. Des salons privés existent et sont accessibles sur invitation. Nous ne manquerons pas de vous inviter !
Si vous désirez échanger directement avec quelqu'un, cliquez alors sur le "+" à droite de "Personnes". En cliquant sur "En voir plus", vous verrez toutes les personnes de la communauté Tinternet.
Si vous désirez échanger directement avec quelqu'un, cliquez alors sur le `+` à droite de `Personnes`. En cliquant sur `En voir plus`, vous verrez toutes les personnes de la communauté Tinternet.
## Sauvegarde de la clé de sécurité
La clé de sécurité est un mécanisme important pour valider une session. Nous verrons ensemble son intérêt. Pour le moment, il s'agit de la mettre en lieu sûr !
Ouvrir l'onglet "Sécurité et vie privée" puis sur cliquer sur "Configurer la sauvegarde sécurisée" :
Ouvrir l'onglet `Sécurité et vie privée` puis sur cliquer sur `Configurer la sauvegarde sécurisée`&nbsp;:
<table>
<tr>
@ -93,6 +93,6 @@ Ouvrir l'onglet "Sécurité et vie privée" puis sur cliquer sur "Configurer la
</tr>
</table>
Choisir "Générer une clé de sécurité" puis cliquer sur "Télécharger". Il est impératif de garder cette clé de sécurité en lieu sûr. Lors d'une prochaine connexion avec un autre appareil, vous serez suceptible de devoir l'utiliser.
Choisir `Générer une clé de sécurité` puis cliquer sur `Télécharger`. Il est impératif de garder cette clé de sécurité en lieu sûr. Lors d'une prochaine connexion avec un autre appareil, vous serez suceptible de devoir l'utiliser.
Une fois téléchargée, on peut passer à l'étape suivante qu'on validera avec le mot de passe du compte.

View file

@ -35,4 +35,6 @@ markdown_extensions:
nav:
- Accueil: index.md
- Outils:
- Matrix et Element: outils/matrix.md
- Matrix:
- Présentation: outils/matrix/index.md
- Installation: outils/matrix/installation.md