Wenn ein Element angezeigt wird M_FORBIDDEN: You do not have permission, ermitteln Sie zunächst die genaue fehlgeschlagene Aktion. Die meisten Fehler bei der Raumverwaltung werden durch die Berechtigungsstufe oder die Mitgliedschaft des Raums verursacht; ein Fehler der Synapse Admin API erfordert hingegen ein Serveradministrator-Konto auf dem Homeserver. Bitten Sie einen aktuellen Raumadministrator, nur die benötigte Raumberechtigung zu erteilen, oder verwenden Sie die Synapse Admin API nur dann, wenn die verweigerte Operation tatsächlich eine Serveradministrator-Aufgabe ist.
Hypothetisches Beispiel: Alex moderiert einen Matrix-Raum und kann Spam entfernen, erhält aber Probleme M_FORBIDDENbeim Ändern der Einladungsberechtigungen. Alex ist Moderator, aber kein Administrator des Raums. Das Beispiel dient der Veranschaulichung und stellt keine Aussage über einen getesteten Account oder Server dar.
Ermitteln Sie, welches Berechtigungssystem die Anfrage abgelehnt hat.
Matrix verwendet M_FORBIDDENdiese Fehlermeldung als allgemeinen Zugriffsfehler. Der Code allein gibt nicht an, ob das Problem mit der Raumleistung, der Raumzugehörigkeit, einer Kontobeschränkung oder der Autorisierung für eine administrative API zusammenhängt. Lesen Sie die vollständige Fehlermeldung und notieren Sie, was Alex getan hat: eine Raumeinstellung bearbeitet, jemanden eingeladen oder gesperrt, einem Raum beigetreten oder ein Synapse-Verwaltungstool geöffnet.
Die Berechtigungen eines Raums werden in seinem m.room.power_levelsStatusereignis gespeichert. Elementrollen wie „Standard“, „Moderator“ und „Administrator“ ermöglichen es Benutzern, diese Werte einzusehen. Der Raum kann jedoch benutzerdefinierte Berechtigungen festlegen. Ein Homeserver-Serveradministrator ist eine separate Rolle; er wird dadurch nicht automatisch zum Raumadministrator. Maßnahme: Klassifizieren Sie die fehlgeschlagene Aktion, bevor Sie die Rolle ändern, und prüfen Sie, ob der Fehler in den Raumeinstellungen des Elements oder an einem /_synapse/admin/Endpunkt aufgetreten ist.
Korrigiere eine Raumaktion anhand der Raumstrompegel
Kann Alex eine Einstellung in Element nicht ändern, bitten Sie einen vorhandenen Raumadministrator, die Rollen und Berechtigungen des Raums zu überprüfen. Öffnen Sie in Element Web oder Desktop den Raum, dann „Rauminformationen“ oder das Raummenü, wählen Sie „Raumeinstellungen“ und anschließend „Rollen & Berechtigungen“. Überprüfen Sie Alex’ Eintrag unter „Privilegierte Benutzer“ und die für die jeweilige Aktion erforderliche Rolle. Bezeichnungen und Layout können je nach Clientversion variieren.
Für Alex' Aufgabe zur Einladungsberechtigung sollte der Administrator sowohl Alex' eigene Berechtigungsstufe als auch die für die Änderung dieser Berechtigung erforderliche Stufe überprüfen. Die Matrix-Spezifikation definiert diese unabhängig voneinander: Der inviteSchwellenwert steuert Einladungen, während die Änderung der Berechtigungsstufe selbst die Berechtigung zum Senden dieses Statusereignisses erfordert. Ein Mitglied kann zwar Benutzer einladen dürfen, aber nicht die Berechtigung haben, den Einladungsschwellenwert zu ändern. Der aktuelle Administrator kann Alex auf die niedrigste geeignete Stufe hochstufen oder die spezifische Berechtigungsänderung selbst vornehmen.
In der dokumentierten Standardkonfiguration von Element hat der Administrator üblicherweise Stufe 100 und der Moderator Stufe 50. Räume können diese Anforderungen jedoch individuell anpassen. Gehen Sie nicht davon aus, dass jeder Raum diese Standardeinstellungen verwendet. Vermeiden Sie es außerdem, den einzigen Administrator herabzustufen: Element warnt davor, dass der Raum dadurch unbesetzt bleiben kann. Empfehlung: Lassen Sie den aktuellen Administrator bestätigen, dass ein weiterer vertrauenswürdiger Administrator vorhanden ist, bevor Sie eine Rollenänderung speichern.
Wenn niemand im Team den Raum verwalten kann, prüfen Sie, ob ein aktueller Raumadministrator auf einem anderen Konto oder Gerät verfügbar ist. Bei Räumen, die auf Synapse gehostet werden, kann ein Administrator des Homeservers möglicherweise die Synapse-API „Raumadministrator werden“ verwenden, um einem lokalen Benutzer im Raum die höchsten verfügbaren Berechtigungen zu erteilen. Dies ist ein Wiederherstellungspfad für den Homeserver-Betreiber und keine gewöhnliche clientseitige Berechtigungsumgehung. Der Endpunkt erfordert Serveradministratorrechte und ist möglicherweise nicht auf Räume anwendbar, die extern gehostet werden. Verwenden Sie die aktuelle Synapse-Endpunktdokumentation und stellen Sie sicher, dass die Admin-API nicht öffentlich zugänglich ist.
Wenn der Fehler von der Synapse Admin API stammt.
Wenn die Anfrage an den Raumadministrator in Element gerichtet ist /_synapse/admin/..., reicht dies nicht aus. Synapse benötigt für viele Admin-API-Aufrufe ein gültiges Zugriffstoken eines Serveradministrators. Stellen Sie sicher, dass das Token zum gewünschten Konto gehört, nicht widerrufen oder falsch eingegeben wurde und mit dem dokumentierten Autorisierungsheader gesendet wird. Fügen Sie Zugriffstoken niemals in ein öffentliches Problem, einen Browser-Screenshot oder ein geteiltes Protokoll ein; behandeln Sie sie wie Passwörter.
Synapse empfiehlt, die Admin-API mithilfe eines Reverse-Proxys vor der Öffentlichkeit zu verbergen und Anfragen üblicherweise von dem Rechner aus zu stellen, auf dem Synapse ausgeführt wird. Administratoren sollten die API verwenden, die zur installierten Synapse-Version passt. Vermeiden Sie es, die Datenbank direkt zu bearbeiten, um einem Benutzer Rechte zu verschaffen: Synapses aktuelle Empfehlungen verweisen Administratoren mit einem Server-Administratorkonto auf die entsprechenden Befehle und APIs.
Mitgliedschaft, Kontostatus und Ergebnis prüfen
Falls die fehlgeschlagene Aktion das Beitreten oder Senden eines Ereignisses betraf, überprüfen Sie, ob Alex tatsächlich dem Raum beigetreten und nicht gesperrt ist. Eine Einladung ist nicht dasselbe wie ein Beitritt, und die Mitgliedschaftsregeln können den Zugriff selbst bei hohem Berechtigungslevel blockieren. Tritt der Fehler in verschiedenen Räumen oder beim Anmelden auf, liegt das Problem möglicherweise nicht am Raumadministrator. Überprüfen Sie die vollständige Fehlermeldung und ob das Konto vom Homeserver gesperrt, suspendiert oder anderweitig eingeschränkt ist.
Nachdem der zuständige Administrator die Berechtigung geändert hat, soll Alex den Vorgang im selben Raum wiederholen. Bestätigen Sie das erwartete Ergebnis – beispielsweise, dass die Einladung oder die Einstellungsänderung erfolgreich war – und prüfen Sie in der Ansicht „Rollen & Berechtigungen“ des Raums, ob die gewünschte Berechtigungsstufe vorhanden ist. Falls der Vorgang weiterhin fehlschlägt, erfassen Sie die genaue Aktion, die Raum-ID, den Zeitstempel, den HTTP-Status und den geschwärzten Fehlertext für den Administrator des Homeservers. Fügen Sie kein Zugriffstoken hinzu.
Die Bedeutung von Standardfehlercodes und Regeln für die Raumleistungsstufe finden Sie in der Matrix Client-Server API-Spezifikation. Informationen zum Workflow der Raumeinstellungen finden Sie in der Hilfe- und Supportseite von Element . Die Serveradministrator-Authentifizierung und die Wiederherstellung von Räumen werden in der Synapse Admin API-Dokumentation beschrieben. Der genaue Nachrichtentext und die Steuerelemente hängen vom Client, dem Homeserver, der Raumversion und den benutzerdefinierten Leistungsstufen ab.