Prise en main rapide d'Element (anciennement Riot)

Salon d'aide : #matrix:iiens.net

  • Se connecter sur Element :
    • Se rendre sur le site https://chat.iiens.net (anciennement https://riot.iiens.net) :
    • Le bon serveur d'accueil est déjà défini (matrix.iiens.net).
    • Pour se connecter utiliser vos identifiants Arise (nomAnnéedePromo).
  • Rejoindre un salon :
    •  /join #nom_du_salon:nom_du_serveur 
    • Cas particulier pour rejoindre un salon IRC, deux # :
      •  /join ##nom_du_salon:iiens.net 
  • Envoyer un message privé :
    • L'id d'une personne s'écrit de cette façon : @id:nom_du_serveur. La manière d'envoyer un message diffère sur pc ou sur mobile.
    • Sur pc :
      • Utiliser le bouton + près de la rubrique Personnes et entrez l'id de la personne à contacter (Exemple : @pseudo:iiens.net). Cela créera un salon privé entre vous et le destinataire.
    • Sur mobile :
      • Utiliser le gros bouton vert “+”, puis “Commencer une discussion”
      • Entrez l'id de la personne.
  • Afficher plus de commande en écrivant “/” dans un tchat.
Pour aller plus loin, interagir avec IRC :
  • Certaines commandes sont disponibles pour contrôler le bridge vers IRC. Elles se font en parlant avec le bot IRC.
    • Envoyez un message privé au bot @_irc_bot@iiens.net puis accédez à l'aide en envoyant le message “!help”.
  • Communiquer avec NickServ :
    • Message Privée à @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>

Pour administrer un salon côté IRC (par exemple inviter un utilisateur d'irc sur un salon), il faut passer par le bot ChanServ.

  • Communiquer avec ChanServ :
    • Message Privé à @irc_ChanServ:iiens.net puis entrer les commandes directement. Vous pouvez obtenir les commandes en envoyant le message “HELP”. Attention à la casse pour les commandes.
  • Pour inviter un utilisateur d'irc dans un salon
    • Attention à n'utiliser que les commandes de ChanServ sinon il ne pourra pas rejoindre le salon.
  • Le pseudo sur IRC
    • Ne changez pas de pseudo sur irc avec la commande !nick, cela désynchronisera pour toujours votre pseudo matrix et irc. Utilisez la commande /nick ou changez votre pseudo via les paramètres de l'interface graphique.
  • Se dépoiraliser : Aller dans un salon lié à irc (possédant deux #) puis:
    • /myroomnick <peu importe> → /myroomnick <votre pseudo> → mp Nickserv en envoyant: “identify <votre mot-passe>”

Présentation

Matrix est un protocole de communication en temps réel décentralisé possédant une architecture similaire à celle des mails. Lorsqu'on envoie un mail à une personne, on ne se soucie pas de savoir si son serveur sur lequel il a créé son compte est le même que le notre (gmail, outlook, etc…). De la même manière dans Matrix, chaque personne peut choisir le serveur sur lequel il souhaite s'inscrire, et peut interagir avec une autre personne sans se préoccuper de son serveur (sauf cas exceptionnel où un serveur l'empêche explicitement).

Matrix est disponible aussi bien sur pc (sous forme web ou bien desktop) que sur mobile (pour Android et IOS).

Matrix, Element, Riot, IRC, c'est quoi tout ça?

On entend souvent les termes Matrix, Riot, Element, IRC à l'école. Précisons tout cela. Element est un client reposant sur le protocole Matrix. C'est pour cela qu'il est courant de confondre les deux dans le langage courant. IRC est aussi un protocole mais complètement différent du protocole Matrix. Nous faisons la confusion IRC ↔ Matrix/Element car il est possible de communiquer d'un protocole à un autre très facilement. Quand à Riot, c'est tout simplement l'ancien nom de Element.

Les bridges

Matrix permet aussi de réaliser des “bridges”. Cela permet de transporter les messages “Matrix” à un autre système de messagerie. Un bridge pour IRC est notamment disponible et permet de discuter de manière quasi transparente entre utilisateurs d'IRC et de Matrix.

Arise fournit un serveur Matrix sur lequel tous les élèves ont un compte (si vous payez votre cotiz), un client (https://chat.iiens.net), ainsi qu'un bridge vers le serveur IRC d'Arise.

Fonctionnalités disponibles sur Element

  • chiffrement bout en bout (e2e), même dans un salon avec plusieurs utilisateurs, avec un support de multiples appareils par compte
  • signature croisée, facilitant la vérification des appareils pour le chiffrement
  • partage de fichiers
  • appels chiffré et vidéo
  • disponible sur tous supports (Web, bureau, Android, ios)
  • suppression de messages
  • ajout de mots clés (mots sur lesquels vous pouvez être mentionnés)
  • citations
  • historique de recherche infini, dépendant aussi des paramètres d'un salon
  • support du markdown
  • réponses
  • épingler des messages (expérimental)
  • réactions aux messages
  • édition de messages
  • intégration simple de widgets tels que etherpad, google doc, jitsi, spotify, giphy… à un salon

Prise en main

L'interface d'Element est plutôt classique. La plupart des fonctionnalités que l'on peut attendre d'une application de messagerie moderne sont présentes.

Installation et connexion

Element est disponible sur Android et IOS via les app store ou en version web sur https://chat.iiens.net. Un client desktop est aussi téléchargeable sur https://element.io/get-started.

  • Note : pour Android, il existe une version d'Element disponible sur F-Droid qui n'utilise pas les services Google. Attention, le système de notification nécessite alors de faire régulièrement des requêtes, ce qui impacte la consommation d'énergie. Il y a aussi cette interface alternative à Element android : https://f-droid.org/fr/packages/de.spiritcroc.riotx/

Lors de la connexion, à moins que vous utilisez le client web sur https://chat.iiens.net, il faut sélectionner la case serveur personnalisé et entrer le serveur d'accueil https://matrix.iiens.net avant de pouvoir se connecter. Inutile de changer de serveur d'identité.

La partie sur le chiffrement présente plusieurs subtilités qu'il vaut mieux connaître avant d'en faire usage.

Changer de pseudo et s'identifier sur IRC

Paramètre → nom d'affichage sur Element

Ou /nick <pseudo>

Si vous voulez vous identifier, il faut MP @irc_NickServ:iiens.net et écrire : IDENTIFY <mdp> <mail>

Attention, depuis les dernières versions de Matrix, les MP sont par défaut chiffrés et le bot ne peut donc pas lire vos messages. Il faut donc créer un salon vide non chiffré puis inviter le bot, qui rejoindra automatiquement.

Vous pouvez aussi utiliser “!nick <pseudo>” dans la conversation avec le bot (@_irc_bot:iiens.net). Attention, cela ne change le pseudo que côté IRC sans toucher à celui de Matrix, et à partir de ce moment la synchro automatique avec le pseudo matrix est désactivée.

“/myroomname <pseudo>” peut aussi être utilisé. Cela ne change le pseudo que sur la room actuelle côté matrix. Par contre si jamais cette room est bridgée vers IRC, le bridge va détecter le changement et utiliser ce pseudo côté IRC aussi (sur toutes les rooms bridgées, on peut donc avoir sur certaines room un pseudo différent côté IRC et côté matrix). Cela ne désactive pas la synchro automatique avec le pseudo matrix si jamais il change.

Réponse, citation et mention

  • Citation :
    • mettre “>” devant un texte. Un saut de ligne sortira de la citation. Le menu sur un message propose un bouton “citer” aussi.
  • Répondre à quelqu'un :
    • menu sur un message, puis “Répondre”. La réponse citera et mentionnera la personne. Sous Android/IOs, faire glisser le message vers la gauche pour y répondre.
  • Mention :
    • Il suffit d'écrire le pseudo de la personne. L'auto-complétion, avec la touche tab, fonctionne aussi. On peut aussi cliquer sur un pseudo pour le mentionner. Sur ordiphone, taper le début d'un pseudo peut suffire pour avoir une proposition d'auto-complétion sous forme de popup.

Exemple de mention :

 Exemple mention

Exemple de mention avec autocomplétion :

 Exemple mention autompletion

Exemple de réponse :

 Exemple mention autompletion

Exemple de citation :

 Exemple mention autompletion

Mots clés ou HL

Un mot clé est un mot sur lequel une personne peut être mentionnée, au même titre que son pseudo.

  • Pour en ajouter :
    • Paramètres des notifications → Messages contenant des mots-clés → cliquer sur “mots-clés” en vert. Ajoutez les en les séparant par une virgule. Régler ses notifications sur Sonore sinon le mot clé ne fonctionnera pas.

Les messages contenant un mot clé seront ainsi de la même forme qu'une mention sans auto-complétion.

  • Note : si jamais votre pseudo contient des espaces, mettez le sans espaces dans vos mots clés afin d'être tout de même mentionné dessus. Par exemple le cas de mention sans auto-complétion ci-dessus.

Créer, rejoindre des salons

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

Les salons bridgés avec IRC sur iiens.net sont nommés selon la forme “##nom_du_salon:iiens.net”. Cela signifie que pour rejoindre un salon irc, comme #monarchiie, il faut par exemple entrer :

##monarchiie:iiens.net

Note : ce salon n'existe pas merci de ne pas tenter de le rejoindre.

Sous navigateur, il est possible d'accéder à un salon via un lien cliquable de cette forme :

https://lien.du.client/#/room/#nomdusalon:nomduserveur

Exemple pour #agora avec le client web riot :

https://chat.iiens.net/develop/#/room/##agora:iiens.net

Dans un salon de discussion, écrire #nom_du_salon:id_du_serveur fait un lien cliquable pour le rejoindre.

Messages privés

C'est juste un salon dans lequel les deux utilisateurs ont les droits d'administration. Les paramètres d'administration sont donc les mêmes que pour un salon normal.

Envoyer un mp à quelqu'un :

Cliquez sur l'icône bonhomme et entrez : @identifiant:serveur_d'accueil

Par exemple : @siegfriedkircheis:tedomum.net (cette personne n'existe pas)

Il est aussi possible de cliquer sur le nom de la personne et sur la case proposant de la mp.

L'identifiant de quelqu'un est le premier pseudo qu'il a entré en s'inscrivant sur un serveur d'accueil.

Avec Arise, votre identifiant est : identifant_arise: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.

Si pour parler à l'école c'est très bien, avoir son nom de famille comme identifiant est un peu moyen niveau anonymat.

Communauté

Attention : cette feature n'est plus développée, et n'a sous sa forme actuelle que peut d'intérêt. Elle devrait être complètement refaite dans un futur plus ou moins proche.

Les communautés permettent de faire des groupes de salon. Elles ont une page d'accueil en html et en cliquant dessus, seuls les salons et personnes en faisant parti apparaîtront sur la gauche. Ça sert vraiment à trier un peu ses salons.

Liste de salons générale :

 Exemple accueil communauté

Liste de salons d'une communauté seulement :

 Exemple accueil communauté

  • Note : rejoindre un salon appartenant à une communauté n'implique pas de faire partie de cette même communauté. En revanche, il pourra voir que le salon appartient à cette communauté et donc obtenir en l'identifiant dans les paramètres du salon dans la section badge. Pour éviter cela, supprimez le badge du salon (n'a aucun impact, sauf peut-être cosmétique) ou passez la communauté sur invitation seulement.

Page d'accueil de communauté sur mobile :

 Exemple accueil communauté

Sur pc, accueil et salons :

 Exemple accueil communauté

Pour créer une communauté, il suffit de cliquer sur l'icône correspondante et suivre les instructions.

Il faut aller dans les paramètres de la communauté pour ajouter des salons.

Ensuite, il suffira de cliquer sur un salon pour le rejoindre.

Salons disponibles dans une communauté sur mobile :

 Exemple salons communauté

Une communauté peut être rejointe par invitation ou par lien. Un lien de communauté aura la forme suivante :

https://lien.du.client/#/group/+id_du_groupe:nom_du_serveur

Administrer des salons et des communautés / groupes

  • Attention, il n'est pas encore possible de changer l'administrateur d'une communauté. Par conséquent, si l'admin d'une communauté est destiné à être passé à d'autres personnes, je recommande de créer la communauté avec un compte d'administration. De plus, pour en supprimer un salon, il faut se rendre sur l'accueil de la communauté, sur la droite il y a les utilisateurs mais aussi les salons. C'est là qu'il sera possible de les supprimer.

Pour qu'un salon de communauté puisse être rejoint par tous les utilisateurs possédant un lien, il faut impérativement que ce salon ait une adresse publiée sur le serveur sur lequel il est hébergé (exemple : ##monarchiie:iiens.net ). Si ce salon n'en a pas, il a cependant un identifiant interne de la forme : suite_de_caractères:nom_du_serveur.

Même si les salons sont cliquables à l'accueil d'une communauté, s'ils n'ont pas d'adresse, ils ne pourront être rejoint par des membres inscrits sur un serveur d'accueil différent de celui salon.

Par exemple, si julia:tedomum.net cherchait à rejoindre le salon ayant pour identifiant internet suite_de_caractères_aléatoires:iiens.net, elle ne pourrait pas, car ce n'est pas l'adresse du salon, même si elle y accédait via une communauté.

Historique

La lecture d'historique n'est disponible que depuis l'activation de ce paramètre, par défaut activée. Pensez à gérer ça dès la création du salon selon ce que vous désirez.

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.

Précision sur les salons importants dans une communauté

Attention, ajouter un salon à une communauté présente quelques spécificités importantes :

  • il faut que le salon puisse être rejoint par lien et non par invitation seulement.
  • il faut aussi qu'il ait une adresse locale publiée pour pouvoir être rejoint par des personnes venant d'un serveur d'accueil différent de celui du créateur du salon (et donc du salon). Pour ce réglage : paramètre de salon → adresses locales → en savoir plus → en ajouter une → adresses publiées → cliquer sur le menu déroulant et l'adresse locale devrait être sélectionnable.
  • les utilisateurs non-privilégiés ne pourront plus inviter d'autres personnes dans le salon. L'option passera en “restreint” dans les permissions du salon. Pour contourner ça et permettre à tous les utilisateurs d'inviter des gens : paramètre de salon → rôles et permissions → rôle par défaut → sélectionner “rang personnalisé” → entrer “0” → inviter des utilisateurs → sélectionner “rang personnalisé” → entrer “0” → répéter pour toutes les permissions nécessaires.

Attention Il n'est pas possible de modifier les permissions sur IRC, même en étant rang 90.

Par exemple :

kircheis2015:iiens.net cherche à rejoindre un salon de la communauté +cc:tedomum.net et dont les salons ont ont été créés par un utilisateur 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 publiée.

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 d'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.

Activer le chiffrement sur Element

Tout ce qui est au dessus est valable ici aussi.

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.

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

IRC et le chiffrement

Il ne faut jamais activer le chiffrement sur un salon bridgé vers IRC. Si c'est le cas, plus aucun messages ne circulera dans le sens Matrix vers IRC.

Les MP sont depuis les dernières versions chiffrés automatiquement de bout en bout, et casse donc la communication avec IRC. Pour créer un MP non chiffré, il faut créer un salon vide non chiffré et inviter l'utilisateur IRC.

Plusieurs contraintes

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.

Vérification des appareils

Lorsqu'un salon est chiffré, la première fois qu'une personne y envoie un message, elle devra avant vérifier les appareils de ses interlocuteurs (sauf si vous l'avez déjà fait dans un autre salon).

  • En théorie : il faut s'envoyer les id d'appareils par un autre moyen de communication (ou une conversation non chiffrée) et regarder à la main que les id correspondent.
  • 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 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ètresAppareils puis vous pouvez sélectionner les appareils à supprimer. Le mot de passe sera demandé avant la suppression.

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

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.

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

Deux méthodes :

  • Envoyer un message dans un salon chiffré et ce message apparaîtra.

 Exemple avertissement

Cliquez sur “Afficher les appareils” pour obtenir la liste d'appareils à vérifier. Il suffit de cliquer sur “Vérifier” pour chaque appareil.

 Exemple salons communauté

Il est désormais possible de vérifier avec des émojis les appareils en temps réel. L'intérêt étant que les gens ne faisant probablement pas réellement la vérification, il est maintenant bien plus facile pour un humain de vérifier pour de vrai des appareils.

 Exemple Vérification Emoji

  • Cliquer sur un utilisateur (son image de profil dans le chat ou sur lui sur la droite), la liste de ses appareils non vérifiés sera disponible.

 Exemple salons communauté

Nouvel appareil

Si une personne envoie un message depuis un nouvel appareil à quelqu'un qui se connecte sur un nouvel appareil, le destinataire va voir un message dont il n'a pas la clé de chiffrement.

Exemple : Alice possède deux appareils, A et B. Julia C et D.

Alice et Julia parlent pour la première fois dans un salon chiffré avec A et C. Julia se déconnecte pour aller sur D, mais Alice se déconnecte et envoie un message depuis B à Julia avant sa connexion sur D.

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 :

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

Note : il est possible de donner ses clés e2e à quelqu'un pour qu'il puisse déchiffrer une conversation que vous auriez pu avoir (en groupe ou non). Il est plutôt déconseillé de le faire, à moins que les deux comptes ne communiquent que sur les mêmes salons ou appartiennent à la même personne.

Déconnexion

Lors de la déconnexion d'un appareil, un avertissement apparaîtra, suggérant d'exporter les clés e2e. Utile seulement si le compte communique sur des salons chiffrés.

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 ou Coffre Secret

Attention : Cette fonctionnalité ne sert pas à éviter de devoir vérifier les appareils de vos interlocuteurs dans les conversations chiffrées, mais à pouvoir sauvegarder en ligne vos clés de chiffrement.

Depuis la version 0.8.22 de riot android (IOS aussi je suppose), il est possible d'ajouter un mot de passe dans ParamètresMessage Recovery.

Ce mot de passe permet de sauvegarder en ligne les clés de chiffrement de vos conversations chiffrées, en les chiffrant (ça fait beaucoup de chiffrement).

Une fois le mot de passe choisi, riot va générer une Recovery Key qu'il faut sauvegarder (il est possible de la sauvegarder sous forme de fichier), utilisable dans le cas où le mot de passe serait oublié.

Restaurer une sauvegarde de clés : ParamètresMessage RecoveryRestore

Là il va être demandé de saisir le mot de passe ou d'utiliser la Recovery Key.

L'opération prend un petit moment selon la quantité de clés sauvegardées, soyez donc un peu patient.

Note : Cette section a été écrite lors de la fraîche sortie de la mise à jour. Les termes utilisés sont donc en anglais et seront probablement traduits lors d'une mise à jour ultérieure de l'application.

Fonctionnalités expérimentales ou Laboratoire

Matrix et Riot étant plutôt en développement actif, certaines fonctionnalités sont encore expérimentales. Pour les activer, il faudra se rendre dans la section “Laboratoire” des paramètres et les cocher.

En revanche, la section ne sera pas toujours présente. En effet, tout dépend de votre client :

  • 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.
  • 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/

Pont Matrix-Discord

Il y a désormais un pont Matrix ↔ Discord hébergé par Arise. La procédure pour l'utiliser est la suivante :

  1. Ajouter cette app au serveur Discord (ne pas toucher les permissions) : https://discord.com/oauth2/authorize?client_id=765323616010633237&scope=bot&permissions=70379520 (il faut à priori être admin du serveur pour cela).
  2. Permissions côté Discord : sur le channel où sera le pont uniquement, donner la permission View Channel et Manage Webhooks au bot (i.e. au rôle “Arise matrix bridge”). Sur tous les autres channels du serveur que vous ne voulez pas bridge, il ne doit avoir ni la permission View Channel, ni Manage Webhooks.
  3. Permissions côté Matrix : le bot doit avoir la permission Invite users sur le salon.
  4. Inviter @_discord_bot:iiens.net dans le salon Matrix (/invite @_discord_bot:iiens.net).
  5. Taper !discord help (dans le salon Matrix) et suivre les instructions (il faut être OP, i.e. avoir le rang 50 minimum pour que ça fonctionne).
  6. Aller dans le channel associé sur Discord et accepter le pont (!matrix approve).

Notes diverses : le bot ne marche pas sur des chans chiffrés, et le chiffrement d'un chan ne peut pas être désactivé une fois activé, il faut donc créer un chan non chiffré dès le début. Il faut être OP (rang >= 50) sur le chan Matrix pour que les commandes fonctionnent. Si le bot est kick du chan Matrix, le réinviter risque de ne pas marcher, un workaround est de l'inviter depuis irc avec `/invite _discord_bot1` (dans le cas où le chan a été crée depuis irc).

[EDIT: Normalement le problème des deux paragraphes suivants a été fixé, le bot ne crée normalement plus de chan qu'il serait possible de rejoindre en connaissant le guild id et le chan id. On peut donc tout à fait bridge des chans privés d'un serveur Discord public sans problème !]

Attention : il est possible de rejoindre avec une simple commande n'importe quel chan bridgé en connaissant 1) le guild id du serveur Discord 2) l'id du chan bridgé. Mettre en place un pont entre un chan matrix et un chan privé d'un serveur Discord accessible au public n'est donc pas une bonne idée ! (car il serait possible de récupérer le guild id et le chan id facilement et donc accéder à ce chan privé depuis Matrix) ⇒ Ne mettre en place des ponts que sur des chans publics d'un serveur Discord public (i.e. à partir du moment où le pont est mis en place, accepter que n'importe qui puisse rejoindre ce chan depuis Matrix) OU sur des chans d'un serveur privé (i.e. sans lien d'invitation, puisque dans ce cas personne à part les membres du serveur ne pourront deviner le guild id et rejoindre depuis Matrix).

Ésotérisme, random et Devtools

Votre identifiant s'affiche à côté de votre pseudo ?

  • Il existe quelqu'un avec le même pseudo que vous dans le 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

Changer de pseudo (et/ou d'image) dans un salon seulement (possible que sur pc) : commande /myroomname dans Element.

Avoir un meilleur sticker picker et des sticker perso

Prérequis :

  • Avoir un site web. Tout les Iiens qui ont cotisés en ont un donc pas de souci pour le prérequis 🙂

OU BIEN

  • Avoir quelqu'un qui héberge ses packs de sticker sur son site web

Dans le premier cas : Aller voir le repository matrix-sticker se trouvant sur git.iiens.net

Dans le second cas: Aller voir le repository matrix-sticker se trouvant sur git.iiens.net. Si vous avez la flemme voici un résumé du tuto:

1. Demandez lui l'autorisation (ou non).
2. Récupérez l'adresse sur laquelle il héberge ses stickers. Cette adresse est de la forme :

https://nom.iiens.net/stickerpicker/web/?theme=$theme

3. Connectez vous à Element. Utilisez la commande /devtools

4. Cliquer sur Explorer les données du compte puis sur m.widgets. Si absent : 1. Activer le gestionnaire d'intégration. Tout les paramètres → général → Gérer les intégrations 2. Envoyer n'importe quel sticker.
5. Cliquer sur Modifier et remplacer tout par le code suivant en n'oubliant pas de modifier les champs “url” et “sender”:

{

  "stickerpicker": {
      "content": {
          "type": "m.stickerpicker",
          "url": "https://{% nom de domaine %}/stickerpicker/web/?theme=$theme",
          "name": "Stickerpicker",
          "data": {}
      },
      "sender": "@{% id %}:{% homeserver %}",
      "state_key": "stickerpicker",
      "type": "m.widget",
      "id": "stickerpicker"
  }

}
Il faut remplacer les données entre {%%} par ce qu'il correspond à votre compte / installation (si vous souhaitez utiliser mes packs de sticker, ils sont visibles en cliquant sur le lien suivant https://monarchiie.iiens.net/stickerpicker/web/index.html?theme=$theme)
6. Actualiser

Créer des packs de sticker

Voir le repo git matrix-sticker. Vous pourrez récupérer des packs de sticker faits par des iiens ou en proposer.

Quelques serveurs publiques et Installation

Le compte Matrix fournit par Arise utilisant l'identifiant Arise, et donc le nom de famille, on peut vouloir se créer un autre compte ailleurs.

Ces serveurs ont été choisis à l'aide du site https://www.hello-matrix.net/public_servers.php J'ai choisis de privilégier des serveurs ayant moins de 500ms ping, étant à jour sur Synapse, une bonne disponibilité et durables, c'est à dire gérés par une organisation, et ayant une bonne politique propice à l'esprit open source. Ce sont aussi des serveurs que j'ai testé.

D'autres serveurs sont disponibles sur le site mentionné plus haut, à chacun de voir.

Aide

Pour toute demande d'aide, vous pouvez poser vos questions dans le salon #matrix (sur irc) ou #matrix:iiens.net (sur Matrix).