Comment configurer la modération des salles Matrix avec le bot Mjolnir

Mjolnir est un bot de modération Matrix capable d'appliquer des politiques de bannissement partagées, de masquer des messages, de surveiller les salons protégés et d'aider les modérateurs à agir sans utiliser leurs comptes personnels. Une configuration sécurisée repose sur trois points : l'emplacement d'exécution du bot, les personnes autorisées à lui donner des commandes et les permissions dont il dispose dans chaque salon protégé. Il est recommandé de garder la salle de contrôle privée, de ne protéger que les salons souhaités et de vérifier les permissions avant de faire appel au bot en cas d'incident.

Ce guide suit la documentation officielle de Mjolnir concernant l'installation et la modération, ainsi que les recommandations de modération de la communauté Matrix (consultées le 6 octobre 2026). La page des versions du projet indique que la version 1.12.1 est la plus récente au moment de cette évaluation. Veuillez consulter à nouveau la page des versions et l'exemple de configuration officiels lors de l'installation, car les étiquettes de conteneur et les options prises en charge peuvent avoir changé.

Mjolnir est-il adapté à votre communauté Matrix ?

Utilisez Mjolnir lorsque les modérateurs doivent partager des règles de modération entre plusieurs salons, s'abonner à des listes de règles communes ou appliquer des actions répétitives de manière cohérente. Les permissions des salons déterminent toujours les actions autorisées au bot ; Mjolnir n'acquiert pas d'autorité simplement en rejoignant un salon. Pour la modération de petits salons courants, les outils intégrés peuvent suffire. Mjolnir est particulièrement utile lorsqu'une même communauté gère plusieurs salons ou a besoin d'un flux de travail partagé et contrôlé.

La modération des salons et l'administration du serveur principal sont deux choses distinctes. Mjolnir peut gérer les bannissements et les suppressions au niveau des salons, en fonction des permissions appropriées. Les commandes plus importantes affectant l'ensemble du serveur (comme la désactivation d'utilisateurs, le déplacement d'alias ou la fermeture de salons) nécessitent que Mjolnir soit administrateur du serveur Synapse. N'accordez pas d'accès administrateur au serveur principal, sauf si les modérateurs en ont un besoin spécifique.

Que devez-vous préparer avant de l'installer ?

• Un compte serveur Matrix dédié au bot, tel que @mjolnir:example.org.
• Une salle de gestion privée où les modérateurs autorisés peuvent donner des ordres et recevoir des messages d'état.
• Un répertoire ou volume persistant pour la configuration et l'état de Mjolnir.
• Plan pour les salles chiffrées. La configuration actuelle de Mjolnir prend en charge le chiffrement natif ; Pantalaimon est également documenté comme une option distincte et obsolète. N'activez pas les deux simultanément.
• Une salle de test où vous pouvez confirmer les invitations, les autorisations et le comportement des listes avant de protéger les salles de production très sollicitées.

Comment installer Mjolnir ?

La documentation du projet amont détaille l'installation de Docker et la procédure d'auto-construction. Pour la plupart des administrateurs utilisant déjà des conteneurs, Docker Compose est pratique car il permet de redémarrer le bot et d'afficher les journaux sans avoir à maintenir un terminal interactif ouvert. Suivez les instructions de configuration Docker du projet et utilisez une version validée en production plutôt que de vous fier indéfiniment à une latestétiquette non validée. L'image officielle est : [insérer l'image officielle ici matrixdotorg/mjolnir].

Préparez la configuration avant de démarrer le conteneur. Le guide Docker officiel exige que la configuration se trouve dans un répertoire de données persistant config/production.yaml. Ce répertoire doit rester accessible uniquement aux administrateurs et au service qui en a besoin. Le fichier peut contenir un jeton d'accès ou d'autres identifiants de connexion ; ne le publiez pas dans un dépôt public, ne le collez pas dans un forum d'assistance et ne l'incluez pas dans les journaux.

Utilisez la configuration par défaut actuelle du projet, commentaires inclus, comme référence pour les noms d'options. Au minimum, définissez l'URL du serveur principal et la salle d'administration, puis configurez l'authentification et le chiffrement pour votre déploiement. Si vous utilisez un système de jetons, traitez-le comme un mot de passe. Le guide d'installation d'origine explique comment l'obtenir en se connectant en tant que bot depuis un profil de navigateur distinct dans Element, puis en ouvrant Paramètres, Aide et À propos, et la section Jeton d'accès. Il est déconseillé de se déconnecter ensuite, car cela invaliderait le jeton ; fermez plutôt ce profil de navigateur. Pour une salle d'administration chiffrée, activez et testez la prise en charge du chiffrement de Mjolnir avant d'utiliser des commandes dans cette salle.

# Illustrative values only; use the exact keys and authentication method
# from the current upstream configuration sample. Never share real secrets.
homeserverUrl: https://matrix.example.org
managementRoom: '!privateRoomId:example.org'
accessToken: '[STORE A SECRET HERE, NOT IN PUBLIC]'

Ce court extrait ne constitue pas une configuration complète. En particulier, les paramètres de chiffrement et de connexion dépendent de l'utilisation du chiffrement natif ou de l'option Pantalaimon. Veuillez vous référer à l'exemple actuel plutôt que de copier un ancien blog ou fichier de configuration. Le guide d'installation de Mjolnir recommande également de placer le bot à proximité du serveur principal sur le réseau afin de réduire la latence de réponse.

Comment sécuriser la salle de direction ?

Créez une salle pour les modérateurs de confiance, invitez le compte du bot et rendez-la privée pour l'équipe de modération. Indiquez l'identifiant ou l'alias de la salle managementRoom. La configuration actuelle décrit cette salle comme la source des commandes et avertit que toute personne pouvant y envoyer des commandes peut contrôler Mjolnir ; elle ne propose pas de contrôle d'accès plus précis pour chaque commande. Il est donc essentiel de vérifier les membres. Supprimez rapidement les anciens modérateurs et n'utilisez pas la salle de contrôle du bot comme un espace de discussion général.

Le chiffrement est recommandé pour la salle d'administration. Si vous la chiffrez, vérifiez que Mjolnir peut lire et répondre aux messages avec la méthode de chiffrement configurée. Un bot ayant rejoint une salle chiffrée mais incapable de déchiffrer ses événements peut apparaître en ligne tout en ignorant les commandes. Pour diagnostiquer ce problème, utilisez la configuration de chiffrement en amont et les journaux plutôt que de désactiver le chiffrement de la salle dans un premier temps.

Quelles permissions Mjolnir devrait-il recevoir ?

Invitez le bot dans chaque salon qu'il doit protéger et attribuez-lui les pouvoirs nécessaires pour effectuer les actions de modération souhaitées. Matrix utilise les niveaux de puissance des salons pour des opérations telles que le bannissement, l'exclusion, la suppression des événements d'autres utilisateurs et la modification de l'état du salon. La valeur requise est définie par l'événement de niveau de puissance du salon ; par défaut, Matrix utilise généralement 50 pour le bannissement, l'exclusion et la suppression, mais ces valeurs peuvent être modifiées individuellement.

Le guide de la communauté Matrix indique que le niveau de puissance 100 est une configuration courante pour Mjolnir, lui permettant d'appliquer les décisions de modération. Cependant, ce niveau est considérable : toute personne contrôlant le compte Mjolnir dispose de cette autorité dans les salons protégés, et le bot peut en devenir le propriétaire de facto. Examinez les niveaux de puissance de chaque salon et choisissez un niveau autorisant les actions requises du bot tout en limitant les pouvoirs inutiles. Ne lui attribuez pas le statut d'administrateur du serveur principal pour la modération des salons ordinaires.

Dans Element, vous pouvez inviter le bot depuis le panneau des membres de la salle ou saisir une commande d'invitation /invite @mjolnir:example.org. Une fois qu'il a rejoint la salle, modifiez son rôle dans la liste des membres. Répétez l'opération pour chaque salle à protéger. Mjolnir ne peut pas protéger les salles auxquelles il n'a pas adhéré, conformément au modèle de permissions décentralisé de Matrix, qui gère les autorisations salle par salle.

Comment créer une liste de personnes interdites et ajouter des salons protégés ?

Une fois le bot démarré et son statut publié dans l'espace d'administration, créez-y une liste de règles. Le guide de démarrage rapide de Mjolnir utilise cet exemple :

!mjolnir list create COC code-of-conduct-ban-list
!mjolnir default COC
!mjolnir rooms add #community:example.org
!mjolnir verify
!mjolnir status

La première commande crée une salle de liste noire avec le code courtCOC ; la personne qui la crée est invitée afin qu'elle puisse en gérer la visibilité. La deuxième commande sélectionne cette liste comme liste par défaut pour les futures commandes de modération. La troisième ajoute une salle à l'ensemble des salles protégées de Mjolnir. La commande de vérification contrôle si le bot dispose des permissions requises dans les salles protégées, tandis que la commande d'état permet de confirmer son bon fonctionnement. Utilisez !mjolnir helpla commande appropriée pour afficher la syntaxe des commandes disponibles dans votre version installée.

Gardez une liste de règles privée si elle contient des notes internes ou si elle est destinée uniquement à votre équipe. Ne la rendez publique que si vous souhaitez que d'autres communautés puissent la découvrir et s'y abonner. Les règles de Mjolnir s'accumulent d'une liste à l'autre ; vérifiez donc les listes suivies avant de vous y fier. Une liste peut continuer à correspondre à un utilisateur ou un serveur même si vous supprimez une règle en double d'une autre liste.

Que devez-vous tester avant de l'utiliser lors d'un incident réel ?

• Vérifiez que le bot publie bien les messages de démarrage et d'état dans la salle de gestion configurée.
• Exécutez le test !mjolnir verifyaprès l'avoir invité dans la salle de test et lui avoir attribué le rôle choisi.
• Exécutez le programme !mjolnir roomset vérifiez que la pièce prévue apparaît bien, sans aucune pièce non liée.
• N'activez !mjolnir protectionsque les protections que vous comprenez ; les protections automatiques peuvent affecter les utilisateurs légitimes.
• Utilisez un compte de test et une salle jetable pour valider la procédure de bannissement, de débanissement et de suppression de l'équipe avant de l'appliquer aux membres réels.
• Consultez les journaux du conteneur et les messages de la salle de gestion de Mjolnir si le bot manque des commandes ou signale des autorisations manquantes.

Ne testez pas cette fonctionnalité en bannissant un membre réel de la communauté ni en utilisant un bannissement générique sur un serveur en production. Les bannissements génériques peuvent affecter de nombreux utilisateurs ; la configuration par défaut actuelle exige une confirmation supplémentaire pour leur utilisation. Consultez le guide du modérateur avant d'activer les protections automatisées et indiquez clairement qui est habilité à approuver une action à fort impact.

Quelles sont les erreurs de configuration courantes ?

• Attribuer les droits d'administrateur au serveur de bots par commodité : la modération au niveau de la salle nécessite généralement les pouvoirs de la salle, et non les droits d'administrateur Synapse.
• L'accès à la salle de gestion est largement ouvert : chaque membre habilité à donner des ordres se voit confier les commandes de modération du bot.
• Oubli des permissions des salles protégées : un bot peut être en ligne et pourtant ne pas parvenir à bannir ou à censurer si son niveau de puissance est trop faible.
• Utilisation de salons cryptés sans configurer le chiffrement : l’adhésion seule ne permet pas au bot de lire les commandes cryptées.
• Copie d'une ancienne recette d'installation : la configuration et la prise en charge du chiffrement de Mjolnir évoluent ; utilisez l'exemple par défaut actuel et la documentation d'installation.
• En supposant que la suppression d'une liste annule toutes les interdictions : une autre liste surveillée peut toujours appliquer la même règle.

Où pouvez-vous vérifier les informations actuelles ?

Commencez par consulter le guide d'installation , le guide du modérateur et l'historique des versions de Mjolnir . Pour les permissions des salles, consultez le guide de modération de la communauté Matrix et la spécification Matrix relative aux niveaux de puissance des salles . Les commandes d'installation et les paramètres de chiffrement exacts dépendent de votre serveur d'accueil, de la configuration de vos conteneurs et de la version de Mjolnir ; ces références officielles prévalent en cas de modification des instructions.