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.