Différences

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

--- tuto_utiliser_matrix_au_quotidien [2019/07/06 22:55] – [Résumé] prak2015
+++ tuto_utiliser_matrix_au_quotidien [2020/07/16 15:15] – [Le gestionnaire d'intégration et les widgets] prak2015
@@ Ligne 1: / Ligne 1: @@
-====== Prise en main de Matrix et Riot ======
+====== Prise en main de Matrix et Element (Anciennement Riot) ======
 ====== Résumé ======
@@ Ligne 11: / Ligne 11: @@
     * Exemple : ##agora:iiens.net
-  * MP : **@id:nom_du_serveur** dans la recherche
+  * MP : **@id:nom_du_serveur** dans la recherche (avec le bouton +)
   * Communauté : **+id:nom_du_serveur**
@@ Ligne 18: / Ligne 18: @@
   * Utiliser les commandes d'IRC sur matrix : taper **!commande** plutôt que /commande. Peut être fait en mp au bot irc bridge. Fonctionne pour whois, etc...
+**Salon d'aide** :
+https://matrix.to/#/##monarchiie:iiens.net ou **#monarchiie** ou encore **##monarchiie:iiens.net**
 Matrix utilisant les / pour ses commandes, il la prendra pour une commande non reconnue.
-  * Communiquer avec NickServ : MP **irc_NickServ:iiens.net** puis entrer les commandes **directement** en majuscule (et non pas NickServ COMMANDE ou /msg NickServ COMMANDE). Exemple : REGISTER <mot de passe> <email>
+  * Communiquer avec NickServ : MP **@irc_NickServ:iiens.net** (un salon devrait être ouvert avec lors de l'arrivée sur IRC) puis entrer les commandes **directement** en majuscule (et non pas NickServ COMMANDE ou /msg NickServ COMMANDE). Exemple : REGISTER <mot de passe> <email> ou encore IDENTIFY <mot de passe>
+  * Communiquer avec ChanServ : MP **@irc_ChanServ:iiens.net** puis entrer les commandes **directement**
-  * Communiquer avec ChanServ : MP **irc_ChanServ:iiens.net** puis entrer les commandes **directement**
+  * Se dépoiraliser : Aller dans un salon lié à irc -> /myroomnick <peu importe> -> /myroomnick <votre pseudo> -> mp Nickserv -> identify <votre mot-de-passe>
 ====== Brève présentation ======
@@ Ligne 31: / Ligne 38: @@
 En ce qui concerne Arise, notre association favorite, le pont a été fait par un moyen ésotérique que je ne connais pas, et est d'une excellence sans égale. Il est probablement possible d'avoir plus informations auprès du responsable, que je ne connais pas puisque je n'y suis pas.
-Pour dire la vérité, je n'ai pas testé le pont avec d'autres serveurs irc, peut être que c'est partout comme ça, mais j'ai un doute.
 Riot est un client pour Matrix. Il est disponible sous Android via F-Droid ou PlayStore, IOS via l'Appstore, et PC via https://about.riot.im/ (en client bureau ou web). Ce tutoriel s'applique par conséquent en particulier à ce client qui est un des plus développés. D'autres clients sont disponibles sur https://matrix.org
@@ Ligne 52: / Ligne 57: @@
 ===== Installation et connexion à Riot =====
-Riot est disponible sous Android via F-Droid (un store n'ayant que des applications open-source) ou PlayStore, IOS via l'Appstore, et pc via https://about.riot.im/ (en client bureau ou web)
+**Riot** est disponible sous **Android** via **F-Droid** (un store n'ayant que des applications open-source) ou **PlayStore**, **IOS** via **l'Appstore**, et **pc** via https://about.riot.im/ (en client bureau ou web)
+<del> Sur Android vous pouvez avoir **RiotX** qui a quelques fonctionnalités en plus (réactions ou éditions de messages par exemple) et quelques unes en moins (pas de gestion de salons encore mais c'est pour bientôt).
+Il est plutôt //recommandé// d'utiliser **RiotX**, disponible sur **F-Droid** et le **Playstore** aussi : https://wiki.iiens.net/tuto_utiliser_matrix_au_quotidien#installer_riotx_sur_android_et_le_garder_a_jour_automatiquement</del>
+Utilisez Riot android et attendez la migration vers Element (qui est en vérité RiotX) qui devrait arriver dans la semaine (16/07/20).
 Lors de la connexion, à moins que vous utilisez le client web sur riot.iiens.net //et// votre identifiant Arise, il faut sélectionner la case **serveur personnalisé** et entrer votre **serveur d'accueil** avant de pouvoir vous connecter. Inutile de changer de serveur d'identité.
@@ Ligne 61: / Ligne 71: @@
   * tedomum.net : **matrix.tedomum.net**
-Note : l'utilisation du client web de https://riot.im/develop/ permet d'avoir toutes les mises à jours de client rapidement et d'accéder aux fonctionnalités expérimentales comme **épingler des messages** ou encore des réactions aux messages.
+Note : l'utilisation du client web de https://riot.im/develop/ permet d'avoir toutes les mises à jours de client rapidement et d'accéder aux fonctionnalités expérimentales comme **épingler des messages**.
 ====== Fontionnalités ======
-Résumé pour les utilisateurs de discord : globalement la même chose, sans édition de messages, de réactions, d'emoji personnalisés, de pseudo par communauté/groupe (vague equivalent des serveurs, mais on y reviendra plus tard)
+/!\ Riot étant en développement, la liste des fonctionnalités peut ne pas être à jour /!\
+Résumé pour les utilisateurs de discord : globalement la même chose, sans emojis personnalisés, de pseudo par communauté/groupe (vague équivalent des serveurs, mais on y reviendra plus tard)
 Pour les autres :
-  * du chiffrement bout en bout (e2e), même dans un salon avec de multiples utilisateurs, avec un support de multiples appareils par compte (faisant de matrix le meilleur dans le domaine, d'après mes recherches)
+  * du chiffrement bout en bout (e2e), même dans un salon avec de multiples utilisateurs, avec un support de multiples appareils par compte (faisant de matrix le meilleur dans le domaine, d'après mes recherches (mais avec quelques compromis, voir plus bas))
-  * partage de fichiers, jusqu'à 100mo (mais dépend du serveur d'accueil) sans chiffrement et 2mo avec
+  * signature croisée, facilitant la vérification des appareils pour le chiffrement
-  * appel chiffré et vidéo
+  * partage de fichiers, dont la taille dépend du serveur d'accueil (sur le mien c'est 10mo, toujours mieux que //discord//)
+  * appels chiffré et vidéo
   * disponible sur tous supports (Web, bureau, Android, ios)
   * suppression de messages
@@ Ligne 79: / Ligne 91: @@
   * support du markdown
   * Réponses
-  * épingle de message (expérimental)
+  * épingler des messages (expérimental)
-  * Réactions aux messages (expérimental)
+  * réactions aux messages
-  * Edition de messages (expérimental et sur salons non-chiffrés)
+  * édition de messages
-  * intégration simple de widgets tels que etherpad, google doc, jitsi, spotify, giphy...
+  * intégration simple de widgets tels que etherpad, google doc, jitsi, spotify, giphy... à un salon
 ====== Prise en main ======
-Si vous n'utilisez pas de chiffrement, il n'est peut pas utile de lire ce tutoriel. L'interface de Riot étant plutôt classique, la plupart des fonctionnalités attendues de la part d'une application de messagerie instantanée sont présentes. Il est tout de même recommandé de **lire la partie sur les salons et les communautés**. Il y a aussi des lignes de commande, pour les nostalgiques du terminal.
+Si vous n'utilisez pas de chiffrement, il n'est peut pas utile de lire ce tutoriel. L'interface de Riot étant plutôt classique, la plupart des fonctionnalités attendues de la part d'une application de messagerie instantanée sont présentes. Il est tout de même //recommandé// de **lire la partie sur les salons et les communautés**. Il y a aussi des lignes de commande, pour les nostalgiques du terminal qui sont visibles en tapant simplement / dans le tchat.
 Cependant, la partie sur le chiffrement présente plusieurs subtilités qu'il vaut mieux savoir avant d'en faire usage.
@@ Ligne 101: / Ligne 113: @@
 **NE JAMAIS UTILISER !nick POUR CHANGER DE PSEUDO**. Cela ne changerait que le pseudo IRC sans toucher à celui de Matrix, désynchronisant le changement de pseudo entre Matrix et IRC, condamnant le compte à devoir utiliser !nick pour changer de pseudo sur IRC quand un changement est fait sur Matrix.
+Pour changer de pseudo seulement sur irc :
+/myroomname <pseudo> (il se peut que la commande ne soit pas celle-ci, écrire / pour la liste des commandes)
+Cela ne va changer le pseudo que sur irc, mais le pseudo sera changé lors d'un changement de pseudo global.
 ====== Réponse, citation et mention ======
@@ Ligne 135: / Ligne 153: @@
 ====== Salons ======
-Créer ou Rejoindre un salon : **/join #nom_du_salon:nom_du_serveur** Ou cliquer sur le + à droite de la catégorie **salons** et tapez ce qui suit le /join dans la commande précédente.
+Créer ou Rejoindre un salon : **/join #nom_du_salon:nom_du_serveur** (seulement pour rejoindre) ou cliquer sur le + à droite de la catégorie **salons** et tapez ce qui suit le /join dans la commande précédente.
 Exemple de salon : **#katerose_loves_you:tedomum.net**
@@ Ligne 167: / Ligne 185: @@
 Cliquez sur l'icône bonhomme et entrez : **@identifiant:serveur_d'accueil**
-Par exemple : **@evla:tedomum.net**
+Par exemple : **@siegfriedkircheis:tedomum.net** (cette personne n'existe pas)
 Ou il est possible de cliquer sur le nom de la personne et sur la case proposant de la mp.
@@ Ligne 175: / Ligne 193: @@
 Avec Arise, votre identifiant est : **nom_de_familleAnnee_d'arrivee:iiens.net**
-Exemple : **kircheis2015:iiens.net**
+Exemple : si l'identifiant est **kircheis2015:iiens.net**, il faudra envoyer un mp à **@kircheis2015:iiens.net**
 Note : cette personne n'existe //vraiment// pas, il est inutile de tenter de la contacter. **SIEGFRIED KIRCHEIS** est un personnage fictif de //Legend of the Galactic Heroes//.
@@ Ligne 239: / Ligne 257: @@
 En ce qui concerne iiens.net, par défaut un créateur de salon sera modérateur et ne pourra pas activer la lecture d'historique, sauf si Arise change ça ultérieurement.
-Note à propos d'irc : je suppose que si quelqu'un rejoint un salon irc et qu'il obtient assez de droits pour activer l'historique, alors l'historique sera disponible pour n'importe quel utilisateur de matrix, même rejoignant plus tard, à partir de ce moment.
 ===== Rejoindre le salon d'une communauté =====
@@ Ligne 250: / Ligne 265: @@
 kircheis2015:iiens.net cherche à rejoindre un salon de la communauté +cc:tedomum.net et dont les salons sont hébergés sur tedomum.net, même en cliquant sur un salon de la page d'accueil il ne pourra pas si jamais le salon n'a pas d'adresse.
+====== Le gestionnaire d'intégration et les widgets ======
+Il est possible d'ajouter des widgets aux salons. Ils permettent d'ajouter diverses fonctionnalité comme un pont avec IRC, un bot wikipedia ou encore un etherpad (un gdoc mais libre), ou même des stickers.
+/!\ Les stickers ne sont pas visibles par les utilisateurs d'IRC /!\
+**Ajouter un widget** : Cliquer sur l'icone avec 4 petits carrés -> choisir son widget
+Il existe de plus un widget nommé **Custom Widget**. Il prend en argument le lien d'une webapp et devrait l'afficher directement dans un widget du salon. On peut par exemple lui donner un lien étherpad provenant d'un autre hébergeur que celui par défaut et l'afficher.
+Les widgets utilisent un serveur appelé _gestionnaire d'intégration_. Par défaut c'est celui de Matrix.org, mais il est possible de changer de gestionnaire d'intégration et d'héberger le sien : https://dimension.t2bot.io/
+En gros, pour changer de gestionnaire d'intégration, il faut un peu bidouiller le code de son client. Dans le cas de <del>Riot(X)</del> Element, il faut pour le moment recompiler l'application après avoir changé la ligne donnant le gestionnaire d'intégration
+On en parlera probablement un jour, j'ai pas encore installé mon gestionnaire d'intégraton.
 ====== Avec chiffrement ======
-Tout ce qui est au dessus est valable ici aussi, sauf en ce qui concerne la recherche de message. Elle ne fonctionne pas en chiffré car elle se fait côté serveur.
+Tout ce qui est au dessus est valable ici aussi, sauf en ce qui concerne la recherche de message.
-Les messages épinglés mettent aussi un peu de temps à charger.
+Les messages épinglés mettent un peu de temps à charger.
 Pour activer le chiffrement, cochez la case correspondante dans les paramètres d'un salon. Cette opération est irréversible.
-Chiffrer les messages de bout en bout (e2e) permet de ne pas avoir à faire confiance au serveur mais seulement à l'interlocuteur. En choisissant bien le serveur d'accueil, il n'y aura probablement rien à craindre, et je crois qu'il est possible de faire confiance à Arise.
+Chiffrer les messages de bout en bout (e2e) permet de ne pas avoir à faire confiance au serveur mais seulement à l'interlocuteur.
+Pour plus de détails sur le chiffrement bout en bout et en particulier sur le compromis de matrix pour avoir de la récupération de messages antérieurs __et__ du chiffrement E2E avec plusieurs appareils (c'est en anglais) : https://blog.soykaf.com/post/encryption/
-On se place maintenant dans un salon chiffré.
+On se place maintenant dans un salon __chiffré__.
 ===== IRC et le chiffrement =====
-**Attention**, irc ne supporte pas le chiffrement. Pour avoir testé, un salon irc chiffré côté matrix ne recevra plus aucun messages d'utilisateurs de matrix. En revanche vous pourrez toujours lire les messages venant d'irc.
+**Attention**, irc __**ne supporte pas**__ le chiffrement. Pour avoir testé, un salon irc chiffré côté matrix ne recevra plus aucun messages d'utilisateurs de matrix. En revanche vous pourrez toujours lire les messages venant d'irc.
 ===== Plusieurs contraintes =====
-Étant donné le principe même du e2e, l'appareil recevant le message est tout aussi important que l'interlocuteur. Par conséquent matrix met en place un principe d'identifiant appareil et de vérification.
+Le principe même du E2E étant de chiffrer __d'appareil à appareil__, il y a plusieurs contraintes pour que ce soit possible avec plusieurs appareils par interlocuteur. Par conséquent matrix met en place un principe d'identifiant appareil et de vérification.
 L'id des appareils est visible dans les paramètres du compte.
@@ Ligne 279: / Ligne 311: @@
   * En pratique : il est possible de juste cliquer sur "vérifier" sans le faire réellement.
-Si vous ne **vérifiez pas les appareils pour de vrai**, demandez au moins à l'interlocuteur sur combien d'appareils il s'est connecté.
+Si vous ne **vérifiez pas les appareils pour de vrai**, demandez au moins à l'interlocuteur sur combien d'appareils il s'est connecté. Si vous avez un doute sur les appareils de votre interlocuteur, **demandez-lui**.
 De plus, pensez à supprimer les appareils sur lesquels vous-vous êtes connectés provisoirement via **Paramètres** -> **Appareils** puis vous pouvez sélectionner les appareils à supprimer. Le mot de passe sera demandé avant la suppression.
@@ Ligne 285: / Ligne 317: @@
 Afin de savoir quels appareils vous utilisez et ne pas les supprimer lors d'un nettoyage, il est conseillé de leur donner un nom explicite (ou bien un joli petit nom trop choupi <3).
+===== La signature croisée =====
+La signature croisée est la nouvelle méthode de vérification d'appareils. Elle permet d'éviter de vérifier chaque appareil de son interlocuteur avec chacun de nos appareils (ce qui est rapidement fastidieux). A la place, c'est à chacun de vérifier ses appareils et il suffit juste de vérifier seulement une fois la clé de signature croisée de son interlocuteur pour vérifier tous les appareils en lesquels il a confiance.
+**Attention** la signature croisée n'est pas disponible sur //Riot Android// mais //RiotX//.
+__**Activer la signature croisée**__ :
+Paramètres -> Sécurité (& vie privée) -> Réinitialiser la signature croisée et le coffre secret
+Une fois votre passphrase choisie, il faut alors vérifier avec ce compte tous les autres appareils que vous possédez. Les techniques de vérification ci-dessous devraient fonctionner.
+Si tout est bon, vous devriez avoir un petit bouclier vert près de votre pseudo lorsque vous êtes dans un salon chiffré.
+**Vérifier la clé de signature croisé d'un interlocuteur**
+Prévenez votre interlocuteur que vous vous apprêtez à vérifier sa clé de signature croisée (car il faut qu'il accepte) -> Cliquez sur (l'image de profil ou le pseudo sur la droite) d'un interlocuteur -> Sécurité -> Cliquez sur vérifier -> Commencer la vérification.
+Il suffit alors que vous confirmiez que la suite d'emoji que vous voyez est bien la même, et ce sera bon (comme pour la vérification d'appareil via emoji, voir plus bas)
+Si vous avez vérifié la clé de signature croisée de votre interlocuteur et qu'il a vérifié tous ses appareils, il devrait aussi avoir un petit bouclier vert.
+**Note** : La passphrase choisie pour la signature croisée est la même que pour le coffre secret (décrit plus bas)
 ==== "Techniques" de vérification d'appareils ====
@@ Ligne 315: / Ligne 369: @@
 Que le message soit lu sur C ou D, il est indéchiffrable pour Julia, et donc perdu, //pas de chance//.
+Note : ce cas ne s'applique plus si les utilisateurs utilisent la signature croisée et qu'ils ont vérifiés leurs appareils.
 ===== Synchronisation des clés de (dé)chiffrement =====
 Il existe deux méthodes de synchronisation des clés de chiffrement :
-  * semi automatique. Cliquez sur "demander clés de déchiffrement". Une pop-up apparaîtra sur l'autre appareil et il faudra simplement confirmer. C'est fastidieux, il faut faire ça pour chaque message.
+  * très manuel (ne le faites pas). Cliquez sur "demander clés de déchiffrement". Une pop-up apparaîtra sur l'autre appareil et il faudra simplement confirmer. C'est fastidieux, il faut faire ça pour chaque message.
   * manuel. Paramètres -> exporter les clés e2e puis entrez un mot de passe (sera demandé à l'import) -> importer sur l'appareil ayant besoin de recevoir les clés.
@@ Ligne 329: / Ligne 384: @@
 En ce qui concerne le chiffrement, se déconnecter et se reconnecter ensuite **entraînera la création d'un nouvel appareil**. Il est donc plutôt conseillé de ne pas se déconnecter si vous ne souhaitez pas multiplier les appareils.
-===== Message Recovery =====
+===== Message Recovery ou Coffre Secret =====
 **Attention** : Cette fonctionnalité ne **sert pas à éviter** de devoir vérifier les appareils de vos interlocuteurs dans les conversations chiffrées, juste à pouvoir sauvegarder en ligne vos clés de chiffrement.
@@ Ligne 354: / Ligne 409: @@
 En revanche, la section ne sera pas toujours présente. En effet, tout dépend de votre client :
-  * Android/Ios, la section n'est pas activable à ma connaissance. Par conséquent il n'est pas encore possible d'épingler des messages ou d'en voir par exemple.
+  * Android/Ios, la section n'est pas activable, mais il existe RiotX qui permet d'avoir certaines fonctionnalités expérimentales. Voir la section suivante.
-  * Il existe RiotX pour Android qui permet d'avoir certaines fonctionnalités expérimentales comme l'édition et la réaction aux messages. Cette version est censée grand remplacer le client actuel à terme, mais elle est vraiment en test pour le moment. En effet, si elle supporte des fonctionnalités avancées plutôt bien, certaines basiques ne sont pas encore présentes, comme la gestion d'un salon. /!\ Ces exemples ne sont valables qu'au moment où j'écris et cette version de riot évolue assez rapidement.
+  * Bureau : Installez l'application nightly : https://packages.riot.im/nightly/install/ **OU BIEN** Remplacez votre fichier config.json par celui-ci https://riot.im/develop/config.json En revanche, il faudra le faire à chaque mise à jour du client.
-  * Bureau : Remplacez votre fichier config.json par celui-ci https://riot.im/develop/config.json En revanche, il faudra le faire à chaque mise à jour du client.
   * Web, tout dépend depuis quel site est utilisé le client. Sur tedomum.net la section est déjà disponible, de même sur riot.iiens.net. En revanche sur Riot.im, il faut utiliser riot.im/develop/ plutôt que riot.im/app/
-====== Les widgets ======
+===== Installer RiotX sur Android et le garder à jour automatiquement =====
+Il existe RiotX pour Android qui permet d'avoir certaines fonctionnalités expérimentales comme l'édition et la réaction aux messages. Cette version est censée grand remplacer le client actuel à terme, mais elle est vraiment en test pour le moment. En effet, si elle supporte des fonctionnalités avancées plutôt bien, certaines basiques ne sont pas encore présentes, comme la gestion d'un salon par interface graphique. /!\ Ces exemples ne sont valables qu'au moment où j'écris et cette version de riot évolue assez rapidement.
+Méthode manuelle :
+  * Télécharger RiotX ici (voir les builds): https://github.com/vector-im/riotX-android
+  * Installer l'APK obtenue
+Méthode automatique :
+  * Télécharger et installer F-droid : https://f-droid.org/en/ ou se rendre sur le playstore.
+  * Rechercher et installer Riot X par Matrix.org
+====== Ésotérisme, random et Devtools ======
+Votre identifiant s'affiche à côté de votre pseudo ?
-Il est possible d'ajouter des widgets aux salons. Ils permettent d'ajouter diverses fonctionnalité comme un pont avec IRC, un bot wikipedia ou encore un etherpad (un gdoc mais libre).
+  * Il existe quelqu'un avec le même pseudo que vous dans le salon
-Il existe de plus un widget nommé **Custom Widget**. Il prend en argument le lien d'une webapp et devrait l'afficher directement dans un widget du salon.
+  * Si ce n'est pas le cas, c'est peut-être un problème du cache de votre client : **paramètres -> aide et à propos -> vider le cache et recharger**
-La suite quand j'aurai un peu plus d'expérience avec.
-====== Ésotérisme et Devtools ======
 Changer de pseudo (et/ou d'image) dans un salon seulement (possible que sur pc) :
-entrez la commande "/devtools" -> parcourir l'état du salon -> room members -> sélectionner votre nom (id:nom_du_serveur) -> modifier -> modifier le displayname (et/ou avatar_url) -> envoyer
+entrez la commande "/devtools" -> parcourir l'état du salon -> room members -> sélectionner votre nom (id:nom_du_serveur) -> modifier -> modifier le displayname (et/ou avatar_url) -> envoyer **(maintenant la commande /myroomname permet de le faire)**
 Notes :
@@ Ligne 383: / Ligne 452: @@
 ====== Aide ======
-N'hésitez pas à me contacter à **evla:tedomum.net** si vous avez des questions ou besoin d'aide.
+N'hésitez pas à me contacter en rejoignant https://riot.iiens.net/#/room/##monarchiie:iiens.net si vous avez des questions ou besoin d'aide