Quando Element mostra un errore M_FORBIDDEN: You do not have permission, identifica innanzitutto l'azione esatta che non è riuscita. La maggior parte degli errori di gestione delle stanze è causata dal livello di autorizzazione o dall'appartenenza alla stanza dell'account; un errore dell'API Synapse Admin, invece, richiede un account amministratore del server homeserver. Chiedi all'amministratore della stanza corrente di concedere solo l'autorizzazione necessaria oppure utilizza l'API Synapse Admin solo quando l'operazione negata è effettivamente un'attività di amministrazione del server.
Esempio ipotetico: Alex aiuta a moderare una stanza Matrix e può rimuovere lo spam, ma riceve un errore M_FORBIDDENquando cambia chi può invitare persone. Alex è un moderatore in quella stanza, non un amministratore. L'esempio è puramente illustrativo; non si tratta di un'affermazione su un account o un server testato.
Identifica quale sistema di autorizzazioni ha negato la richiesta
Matrix utilizza M_FORBIDDENquesto errore come generico di accesso negato. Il codice da solo non specifica se il problema riguarda i livelli di potenza della stanza, l'appartenenza alla stanza, una restrizione dell'account o l'autorizzazione per un'API amministrativa. Leggi l'errore completo e prendi nota di cosa stava facendo Alex: modificare un'impostazione della stanza, invitare o bannare qualcuno, entrare in una stanza o aprire uno strumento di amministrazione di Synapse.
Le autorizzazioni di una stanza sono memorizzate nel suo m.room.power_levelsevento di stato. I ruoli di Element, come Predefinito, Moderatore e Amministratore, rappresentano un modo per l'utente di esaminare questi valori, ma la stanza può impostare livelli personalizzati. L'amministratore del server HomeServer è un ruolo separato; non rende automaticamente quell'utente un amministratore della stanza. Azione: classificare l'azione non riuscita prima di cambiare ruolo e verificare se l'errore proviene dalle impostazioni della stanza di Element o da un /_synapse/admin/endpoint.
Correggi un'azione della stanza con i livelli di potenza della stanza
Se Alex non riesce a modificare un'impostazione in Element, chiedi a un amministratore della stanza di verificare i ruoli e le autorizzazioni della stanza. In Element Web o Desktop, apri la stanza, apri Informazioni stanza o il menu della stanza, scegli Impostazioni stanza e vai a Ruoli e autorizzazioni. Verifica la voce di Alex sotto Utenti privilegiati e il ruolo richiesto per l'azione specifica. Le etichette e il layout possono variare a seconda della versione del client.
Per l'attività di autorizzazione agli inviti di Alex, l'amministratore dovrebbe verificare sia il livello di autorizzazione di Alex stesso sia il livello richiesto per modificare tale autorizzazione. La specifica Matrix definisce questi due aspetti in modo indipendente: la invitesoglia controlla gli inviti, mentre la modifica dell'evento relativo al livello di autorizzazione richiede l'autorità per inviare tale evento di stato. Un membro potrebbe essere autorizzato a invitare utenti ma non avere l'autorizzazione per modificare la soglia di autorizzazione agli inviti. L'amministratore corrente può promuovere Alex al livello più basso appropriato o apportare direttamente la modifica specifica all'autorizzazione.
Nella configurazione predefinita documentata di Element, l'Amministratore ha in genere livello 100 e il Moderatore livello 50, ma le stanze possono personalizzare i requisiti. Non dare per scontato che tutte le stanze utilizzino queste impostazioni predefinite. Evita inoltre di declassare l'unico amministratore: Element avverte che in tal caso la stanza potrebbe rimanere senza nessuno in grado di gestirla. Azione: chiedi all'amministratore attuale di confermare che un altro amministratore fidato rimanga tale prima di salvare una modifica di ruolo.
Se nessun membro del team può amministrare la stanza, verificare se un amministratore della stanza è disponibile su un altro account o dispositivo. Per le stanze ospitate su Synapse, un amministratore del server homeserver potrebbe essere in grado di utilizzare l'API Make Room Admin di Synapse per concedere i massimi privilegi disponibili a un utente locale presente nella stanza. Questa è una procedura di ripristino per l'operatore del server homeserver, non una normale elusione dei permessi lato client; l'endpoint richiede le credenziali di un amministratore del server e potrebbe non essere applicabile alle stanze ospitate altrove. Consultare la documentazione aggiornata dell'endpoint di Synapse e mantenere privata l'API Admin, impedendone l'accesso pubblico.
Se l'errore proviene dall'API di amministrazione di Synapse
Se la richiesta non riuscita è indirizzata a /_synapse/admin/..., l'amministratore della stanza in Element non è sufficiente. Synapse richiede un token di accesso valido appartenente a un amministratore del server per molte chiamate API di amministrazione. Verificare che il token appartenga all'account previsto, che non sia stato revocato o digitato in modo errato e che venga inviato utilizzando l'intestazione di autorizzazione documentata. Non incollare i token di accesso in un problema pubblico, in uno screenshot del browser o in un log condiviso; trattarli come password.
Synapse consiglia di nascondere l'API di amministrazione dall'accesso pubblico tramite un proxy inverso e di effettuare le richieste in genere dalla macchina su cui è in esecuzione Synapse. Un amministratore dovrebbe utilizzare l'API corrispondente alla versione di Synapse installata. Come prima cosa, è sconsigliabile modificare direttamente il database per ottenere privilegi elevati: le attuali linee guida di Synapse indirizzano gli operatori verso i comandi e le API di amministrazione una volta ottenuto un account di amministratore del server.
Verifica l'iscrizione, lo stato dell'account e il risultato
Se l'azione non riuscita riguardava l'adesione o l'invio di un evento, verifica che Alex sia effettivamente connesso alla stanza e non sia stato bannato. Essere invitati non è la stessa cosa che esserne effettivamente connessi e le regole di appartenenza possono bloccare l'accesso anche quando l'account ha un livello di privilegio elevato. Se l'errore si verifica in stanze non correlate o durante l'accesso, potrebbe non trattarsi di un problema dell'amministratore della stanza; controlla la risposta di errore completa e verifica se l'account è bloccato, sospeso o altrimenti limitato dal server principale.
Dopo che l'amministratore competente ha modificato l'autorizzazione, chiedi ad Alex di riprovare la stessa operazione nella stessa stanza. Verifica il risultato atteso, ad esempio che l'invito o la modifica delle impostazioni vadano a buon fine, e controlla la sezione Ruoli e autorizzazioni della stanza per assicurarti che il livello desiderato sia presente. Se l'operazione continua a fallire, annota l'azione esatta, l'ID della stanza, la data e l'ora, lo stato HTTP e il testo dell'errore (opportunamente oscurato) da comunicare all'amministratore del server. Non includere il token di accesso.
Per il significato dei codici di errore standard e le regole relative al livello di potenza della stanza, consultare le specifiche dell'API client-server di Matrix. Per il flusso di lavoro relativo alle impostazioni della stanza, consultare le pagine di aiuto e supporto di Element . Per le operazioni di autenticazione server-amministratore e di ripristino della stanza, consultare la documentazione dell'API di amministrazione di Synapse . Il testo esatto del messaggio e i relativi controlli dipendono dal client, dal server principale, dalla versione della stanza e dai livelli di potenza personalizzati.