Résoudre les erreurs d'autorisation d'administrateur de la salle Matrix par action

Lorsqu'Element affiche une erreur M_FORBIDDEN: You do not have permission, commencez par identifier l'action exacte qui a échoué. La plupart des échecs de gestion de salle sont dus au niveau d'accès ou à l'appartenance du compte à la salle ; un échec de l'API d'administration Synapse nécessite un compte d'administrateur du serveur d'accueil. Demandez à un administrateur de salle actuel d'accorder uniquement les autorisations nécessaires, ou utilisez l'API d'administration Synapse uniquement lorsque l'opération refusée est réellement une tâche d'administration du serveur.

Exemple hypothétique : Alex participe à la modération d'une salle Matrix et peut supprimer les spams, mais rencontre M_FORBIDDENdes difficultés pour modifier les personnes autorisées à inviter des personnes. Alex est modérateur de cette salle, et non administrateur. Cet exemple est purement illustratif ; il ne constitue en aucun cas une affirmation concernant un compte ou un serveur testé.

Identifiez le système d'autorisation qui a refusé la demande.

Matrix utilise M_FORBIDDENune erreur d'accès interdit générique. Le code seul ne précise pas si le problème provient du niveau de puissance de la salle, de l'appartenance à une salle, d'une restriction de compte ou d'une autorisation d'accès à une API d'administration. Veuillez lire l'erreur complète et noter les actions effectuées par Alex : modification des paramètres d'une salle, invitation ou exclusion d'un utilisateur, participation à une salle ou ouverture d'un outil d'administration Synapse.

Les permissions d'une salle sont enregistrées dans son m.room.power_levelsétat. Les rôles Element, tels que Par défaut, Modérateur et Administrateur, permettent aux utilisateurs de consulter ces permissions, mais la salle peut définir des niveaux personnalisés. Un administrateur du serveur HomeServer possède un rôle distinct ; il ne devient pas automatiquement administrateur de la salle. Action : avant de modifier les rôles, il est recommandé d'analyser l'action ayant échoué et de vérifier si l'erreur provient des paramètres de la salle Element ou d'un /_synapse/admin/point de terminaison.

Corrigez une action dans une pièce en fonction des niveaux de puissance de la pièce

Si Alex ne parvient pas à modifier un paramètre dans Element, demandez à un administrateur de la salle de vérifier les rôles et les permissions. Dans Element Web ou Desktop, ouvrez la salle, puis « Infos salle » ou le menu de la salle, sélectionnez « Paramètres de la salle » et accédez à « Rôles et permissions ». Vérifiez l'entrée d'Alex dans la liste des utilisateurs privilégiés ainsi que le rôle requis pour l'action en question. Les libellés et la mise en page peuvent varier selon la version du client.

Pour la tâche d'Alex concernant l'autorisation d'inviter des utilisateurs, l'administrateur doit vérifier à la fois le niveau de puissance d'Alex et le niveau requis pour modifier cette autorisation. La spécification Matrix définit ces deux éléments indépendamment : le inviteseuil contrôle les invitations, tandis que la modification du niveau de puissance requiert l'autorisation d'envoyer cet événement. Un membre peut être autorisé à inviter des utilisateurs sans pour autant disposer de l'autorisation de modifier le seuil d'invitation. L'administrateur actuel peut promouvoir Alex au niveau approprié le plus bas ou modifier lui-même l'autorisation.

Dans la configuration par défaut documentée d'Element, l'administrateur a généralement le niveau 100 et le modérateur le niveau 50, mais les salles peuvent personnaliser ces exigences. Ne présumez pas que toutes les salles utilisent ces valeurs par défaut. Évitez également de rétrograder le seul administrateur : Element avertit que cela peut laisser la salle sans personne pour la gérer. Action : demandez à l'administrateur actuel de confirmer qu'un autre administrateur de confiance est toujours présent avant d'enregistrer une modification de rôle.

Si aucun membre de l'équipe ne peut administrer la salle, vérifiez si un administrateur de salle est disponible sur un autre compte ou appareil. Pour les salles hébergées sur Synapse, l'administrateur du serveur principal peut utiliser l'API « Make Room Admin » de Synapse pour accorder les droits d'administrateur les plus élevés à un utilisateur local présent dans la salle. Il s'agit d'une procédure de récupération pour l'administrateur du serveur principal, et non d'une simple dérogation aux permissions côté client ; ce point de terminaison requiert des identifiants d'administrateur serveur et peut ne pas s'appliquer aux salles hébergées ailleurs. Consultez la documentation Synapse relative à ce point de terminaison et assurez-vous que son API d'administration reste privée.

Si l'erreur provient de l'API d'administration Synapse

Si la requête échoue /_synapse/admin/..., l'accès à la salle Admin dans Element ne suffit pas. Synapse exige un jeton d'accès valide appartenant à un administrateur du serveur pour de nombreux appels à l'API d'administration. Vérifiez que le jeton appartient bien au compte prévu, qu'il n'a pas été révoqué, qu'il est correct et qu'il est envoyé avec l'en-tête d'autorisation documenté. Ne publiez jamais de jetons d'accès dans un ticket public, une capture d'écran de navigateur ou un journal partagé ; traitez-les comme des mots de passe.

Synapse recommande de masquer l'API d'administration au public à l'aide d'un proxy inverse et d'effectuer les requêtes depuis la machine exécutant Synapse. Un administrateur doit utiliser l'API correspondant à la version de Synapse installée. Il est déconseillé de modifier directement la base de données pour obtenir des privilèges d'administrateur : les recommandations actuelles de Synapse incitent les opérateurs à utiliser les commandes et API d'administration une fois qu'ils disposent d'un compte d'administrateur serveur.

Vérifier l'adhésion, l'état du compte et le résultat

Si l'action ayant échoué était la tentative de rejoindre ou l'envoi d'un événement, vérifiez qu'Alex est bien connecté à la salle et qu'il n'est pas banni. Être invité ne signifie pas être connecté, et les règles d'adhésion peuvent bloquer l'accès même si le compte possède un niveau d'autorisation élevé. Si l'erreur se produit dans des salles différentes ou lors de la connexion, il ne s'agit peut-être pas d'un problème lié à l'administration de la salle ; consultez le message d'erreur complet et vérifiez si le compte est verrouillé, suspendu ou soumis à d'autres restrictions par le serveur.

Une fois que l'administrateur compétent a modifié l'autorisation, demandez à Alex de réessayer l'opération dans la même salle. Vérifiez le résultat attendu (par exemple, que l'invitation ou la modification des paramètres a réussi) et consultez la section « Rôles et autorisations » de la salle pour vous assurer que le niveau d'accès souhaité est bien présent. Si l'opération échoue toujours, notez l'action exacte, l'identifiant de la salle, l'horodatage, le statut HTTP et le texte d'erreur (masqué) pour l'administrateur du serveur. Ne fournissez pas de jeton d'accès.

Consultez la spécification de l'API client-serveur Matrix pour connaître la signification des codes d'erreur standard et les règles de puissance des salles, les pages d'aide et d'assistance d'Element pour la configuration des salles, et la documentation de l'API d'administration Synapse pour l'authentification de l'administrateur du serveur et les opérations de récupération des salles. Le texte exact des messages et les commandes dépendent du client, du serveur d'accueil, de la version de la salle et des niveaux de puissance personnalisés.

Laisser un commentaire

Résoudre les erreurs d'autorisation d'administrateur de la salle Matrix par action

Identifiez l'origine de M_FORBIDDEN en fonction des niveaux de puissance de la salle, des membres ou de l'accès administrateur du serveur Synapse, puis rétablissez uniquement l'autorisation nécessaire à l'action bloquée.

Rendez votre serveur Matrix Synapse accessible pour la fédération

Rendez votre serveur Matrix Synapse accessible pour la fédération

Configurez la découverte Synapse, le protocole HTTPS et le routage proxy pour que les autres serveurs domotiques Matrix puissent trouver votre serveur et le contacter.

Connectez Element Web à Keycloak via Synapse OIDC

Configurez un client Keycloak OIDC et un fournisseur Synapse afin que les utilisateurs d'Element Web puissent se connecter via votre serveur d'identité sans exposer les secrets du client.

Configurez la sauvegarde des clés et la signature croisée en toute sécurité

Configurez la sauvegarde des clés et la signature croisée en toute sécurité

Sauvegardez une clé de récupération, vérifiez vos sessions Element et assurez-vous que les clés de messages chiffrés peuvent être restaurées sans confondre la sauvegarde avec le mot de passe de votre compte.

Résolution des problèmes de mémoire de Matrix Synapse lors de la synchronisation du client

Diagnostiquer les échecs de synchronisation de Synapse (faute de mémoire), ajuster la mise en cache en toute sécurité, identifier les arriérés de requêtes et vérifier une utilisation stable de la mémoire.

Résoudre les erreurs de certificat TLS de la fédération Synapse

En cas de défaillance du certificat de fédération Trace Matrix, remontez jusqu'au serveur approprié, réparez la chaîne TLS ou la confiance de l'autorité de certification et vérifiez la correction sans désactiver les contrôles de sécurité.

Installez un serveur Synapse Matrix derrière Cloudflare en toute sécurité

Installez un serveur Synapse Matrix derrière Cloudflare en toute sécurité

Les clients Route Matrix et la fédération via Cloudflare sur HTTPS 443 préservent la découverte Synapse et évitent la mise en cache du trafic API ou l'interruption des chargements de médias.

Restaurez Matrix Synapse en toute sécurité à l'aide d'une sauvegarde PostgreSQL.

Sauvegardez Synapse avec pg_dump, protégez sa clé de signature et son support, et restaurez-le dans une base de données PostgreSQL propre sans réutiliser de clés à usage unique obsolètes.

Exécutez Mjölnir comme bot de modération de salle Matrix avec Docker

Exécutez Mjölnir comme bot de modération de salle Matrix avec Docker

Configurez Mjölnir avec un compte Matrix dédié, une salle de gestion chiffrée, Docker Compose, une liste de politiques et des contrôles d'autorisation.

Activez la synchronisation matricielle native pour un chargement mobile plus rapide

Activez la synchronisation matricielle native pour un chargement mobile plus rapide

Ignorez le proxy obsolète et configurez la synchronisation glissante intégrée de Synapse. Vérifiez la détection des clients, puis mesurez le chargement de la liste des salons et le comportement de reconnexion sur un téléphone compatible.