Matrix Room-beheerdersrechtenfouten oplossen via actie
Traceer M_FORBIDDEN naar het stroomniveau van de ruimte, het lidmaatschap of de Synapse-serverbeheerderstoegang en herstel vervolgens alleen de machtiging die de geblokkeerde actie nodig heeft.
Wanneer Element een foutmelding geeft M_FORBIDDEN: You do not have permission, moet u eerst de exacte actie identificeren die is mislukt. De meeste fouten in het beheer van ruimtes worden veroorzaakt door het machtsniveau of lidmaatschap van het account; een fout in de Synapse Admin API vereist daarentegen een serverbeheerdersaccount op de homeserver. Vraag een huidige ruimtebeheerder om alleen de benodigde ruimterechten te verlenen, of gebruik de Synapse Admin API alleen wanneer de geweigerde bewerking daadwerkelijk een taak van de serverbeheerder is.
Hypothetisch voorbeeld: Alex helpt bij het modereren van een Matrix-chatroom en kan spam verwijderen, maar krijgt problemen M_FORBIDDENwanneer hij wijzigt wie mensen mag uitnodigen. Alex is moderator in die chatroom, geen beheerder. Dit voorbeeld dient ter illustratie; het is geen bewering over een getest account of server.
Matrix geeft M_FORBIDDENeen algemene foutmelding voor verboden toegang. De code zelf zegt niet of het probleem te maken heeft met het stroomniveau van de chatroom, het chatroomlidmaatschap, een accountbeperking of de autorisatie voor een administratieve API. Lees de volledige foutmelding en let op wat Alex aan het doen was: een chatroominstelling bewerken, iemand uitnodigen of blokkeren, deelnemen aan een chatroom of een Synapse-beheertool openen.
De machtigingen van een ruimte worden opgeslagen in de m.room.power_levelsstatusgebeurtenis. Elementrollen zoals Standaard, Moderator en Beheerder bieden gebruikers een manier om deze waarden te bekijken, maar de ruimte kan aangepaste niveaus instellen. Een beheerder van een homeserver is een aparte rol; dit maakt die gebruiker niet automatisch een ruimtebeheerder. Actie: classificeer de mislukte actie voordat de rollen worden gewijzigd en controleer of de fout afkomstig is van de Element-ruimte-instellingen of een /_synapse/admin/eindpunt.
Als Alex een instelling in Element niet kan wijzigen, vraag dan een bestaande ruimtebeheerder om de rollen en machtigingen van de ruimte te controleren. Open in Element Web of Desktop de ruimte, ga naar Ruimte-info of het ruimtemenu, kies Ruimte-instellingen en vervolgens naar Rollen en machtigingen. Controleer Alex' vermelding onder bevoegde gebruikers en de vereiste rol voor de specifieke actie. Labels en lay-out kunnen per clientversie verschillen.
Voor Alex' taak om uitnodigingsrechten te verlenen, moet de beheerder zowel Alex' eigen machtsniveau als het niveau dat nodig is om die rechten te wijzigen, controleren. De Matrix-specificatie definieert deze twee niveaus onafhankelijk van elkaar: de invitedrempelwaarde bepaalt of iemand mag uitnodigen, terwijl het wijzigen van de gebeurtenis die het machtsniveau wijzigt, de bevoegdheid vereist om die statusgebeurtenis te verzenden. Een lid kan weliswaar gebruikers mogen uitnodigen, maar geen toestemming hebben om de uitnodigingsdrempel te wijzigen. De huidige beheerder kan Alex promoveren naar het laagst mogelijke niveau of de specifieke wijziging van de rechten zelf doorvoeren.
In de standaardinstellingen van Element is de beheerder doorgaans niveau 100 en de moderator niveau 50, maar kamers kunnen de vereisten aanpassen. Ga er niet vanuit dat elke kamer deze standaardinstellingen gebruikt. Vermijd ook het degraderen van de enige beheerder: Element waarschuwt dat dit ertoe kan leiden dat er niemand meer is die de kamer kan beheren. Actie: laat de huidige beheerder bevestigen dat er nog een andere vertrouwde beheerder overblijft voordat een rolwijziging wordt opgeslagen.
Als niemand in het team de ruimte kan beheren, controleer dan of er een huidige ruimtebeheerder beschikbaar is op een ander account of apparaat. Voor ruimtes die op Synapse worden gehost, kan een serverbeheerder van de thuisserver mogelijk de Make Room Admin API van Synapse gebruiken om de hoogst beschikbare rechten toe te kennen aan een lokale gebruiker die zich in de ruimte bevindt. Dit is een herstelprocedure voor de beheerder van de thuisserver, geen gewone manier om de clienttoegang te omzeilen; het eindpunt vereist beheerdersrechten van de server en is mogelijk niet van toepassing op ruimtes die elders worden gehost. Raadpleeg de actuele documentatie van het Synapse-eindpunt en houd de Admin API ervan privé, zodat deze niet openbaar toegankelijk is.
Als het mislukte verzoek betrekking heeft op /_synapse/admin/...de kamerbeheerder in Element, is dat niet voldoende. Synapse vereist een geldig toegangstoken van een serverbeheerder voor veel API-aanroepen naar beheerders. Controleer of het token bij het beoogde account hoort, niet is ingetrokken of verkeerd is ingevoerd, en of het wordt verzonden met de gedocumenteerde autorisatieheader. Plak geen toegangstokens in een openbaar probleem, een schermafbeelding van een browser of een gedeeld logboek; behandel ze als wachtwoorden.
Synapse raadt aan de Admin API te verbergen voor het publiek met behulp van een reverse proxy en verzoeken doorgaans te doen vanaf de machine waarop Synapse draait. Een beheerder dient de API te gebruiken die overeenkomt met de geïnstalleerde Synapse-versie. Vermijd het rechtstreeks bewerken van de database om een gebruiker beheerdersrechten te geven als eerste reactie: de huidige richtlijnen van Synapse verwijzen beheerders naar beheerdersopdrachten en -API's zodra ze een serverbeheerdersaccount hebben.
Als de mislukte actie het deelnemen aan of verzenden van een evenement betrof, controleer dan of Alex daadwerkelijk lid is van de chatroom en niet is geblokkeerd. Een uitnodiging ontvangen is niet hetzelfde als lid worden, en lidmaatschapsregels kunnen de toegang blokkeren, zelfs als het account een hoog machtsniveau heeft. Als de fout zich voordoet in verschillende chatrooms of tijdens het inloggen, is het mogelijk dat het geen probleem van de chatroombeheerder is; controleer de volledige foutmelding en of het account is geblokkeerd, opgeschort of anderszins beperkt door de server.
Nadat de juiste beheerder de machtiging heeft gewijzigd, laat Alex dezelfde bewerking opnieuw uitvoeren in dezelfde ruimte. Bevestig het verwachte resultaat – bijvoorbeeld dat de uitnodiging of de instellingswijziging is gelukt – en controleer in het overzicht Rollen en Machtigingen van de ruimte of het beoogde niveau aanwezig is. Als het nog steeds mislukt, leg dan de exacte actie, de ruimte-ID, het tijdstempel, de HTTP-status en de geanonimiseerde foutmelding vast voor de beheerder van de thuisserver. Voeg geen toegangstoken toe.
Raadpleeg de Matrix Client-Server API-specificatie voor de betekenis van standaardfoutcodes en regels voor het stroomniveau van ruimtes, de help- en ondersteuningspagina's van Element voor de workflow van de ruimte-instellingen en de Synapse Admin API-documentatie voor server-beheerderauthenticatie en herstelbewerkingen van ruimtes. De exacte berichttekst en besturingselementen zijn afhankelijk van de client, de thuisserver, de ruimteversie en de aangepaste stroomniveaus.
Traceer M_FORBIDDEN naar het stroomniveau van de ruimte, het lidmaatschap of de Synapse-serverbeheerderstoegang en herstel vervolgens alleen de machtiging die de geblokkeerde actie nodig heeft.
Configureer Synapse discovery, HTTPS en proxy routing zodat andere Matrix homeservers uw server kunnen vinden en ermee in contact kunnen komen.
Configureer een Keycloak OIDC-client en een Synapse-provider zodat Element Web-gebruikers zich kunnen aanmelden via uw identiteitsserver zonder clientgeheimen prijs te geven.
Sla een herstelsleutel op, verifieer uw Element-sessies en controleer of versleutelde berichtsleutels kunnen worden hersteld zonder de back-up te verwarren met uw accountwachtwoord.
Diagnoseer geheugenproblemen bij Synapse tijdens synchronisatie, pas de caching veilig aan, identificeer achterstanden in aanvragen en controleer of het geheugengebruik stabiel is.
Traceer Matrix-federatiecertificaatfouten naar de juiste server, herstel de TLS-keten of het CA-vertrouwen en verifieer de oplossing zonder de beveiligingscontroles uit te schakelen.
Routeer Matrix-clients en federatie via Cloudflare op HTTPS 443, behoud Synapse-ontdekking en voorkom cachen van API-verkeer of problemen met media-uploads.
Maak een back-up van Synapse met pg_dump, bescherm de ondertekeningssleutel en de media, en herstel de back-up in een schone PostgreSQL-database zonder verouderde eenmalige sleutels opnieuw te gebruiken.
Configureer Mjölnir met een speciaal Matrix-account, een versleutelde beheerruimte, Docker Compose, een beleidslijst en toegangsrechtencontroles.
Sla de verouderde proxy over en configureer Synapse's ingebouwde Sliding Sync. Controleer de clientdetectie en meet vervolgens het laadgedrag van de kamerlijst en het herverbindingsgedrag op een compatibele telefoon.