Risolvi gli errori di autorizzazione amministrativa della stanza Matrix tramite azione

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.

Lascia un commento

Risolvi gli errori di autorizzazione amministrativa della stanza Matrix tramite azione

Individuare la causa di M_FORBIDDEN, che può essere ricondotta ai livelli di alimentazione della stanza, all'iscrizione dei membri o all'accesso di amministratore al server Synapse, quindi ripristinare solo l'autorizzazione necessaria per l'azione bloccata.

Rendi il tuo server Matrix Synapse raggiungibile per la federazione

Rendi il tuo server Matrix Synapse raggiungibile per la federazione

Configura il rilevamento Synapse, HTTPS e il routing proxy in modo che gli altri homeserver Matrix possano trovare e contattare il tuo server.

Connetti Element Web a Keycloak tramite Synapse OIDC

Configura un client OIDC Keycloak e un provider Synapse in modo che gli utenti di Element Web possano accedere tramite il tuo server di identità senza esporre le credenziali del client.

Configura in modo sicuro il backup e la firma incrociata delle chiavi Element.

Configura in modo sicuro il backup e la firma incrociata delle chiavi Element.

Salva una chiave di ripristino, verifica le tue sessioni Element e controlla che le chiavi dei messaggi crittografati possano essere ripristinate senza confondere il backup con la password del tuo account.

Rimuovi i crash di memoria di Matrix Synapse durante la sincronizzazione del client

Diagnostica gli errori di memoria insufficiente di Synapse durante la sincronizzazione, regola la cache in modo sicuro, identifica i ritardi nelle richieste e verifica un utilizzo stabile della memoria.

Risolvere gli errori del certificato TLS di Synapse Federation

Individuare gli errori del certificato di federazione Matrix sul server corretto, riparare la catena TLS o la relazione di fiducia con la CA e verificare la correzione senza disabilitare i controlli di sicurezza.

Posizionare un server Synapse Matrix dietro Cloudflare in modo sicuro

Posizionare un server Synapse Matrix dietro Cloudflare in modo sicuro

Instrada i client Matrix e la federazione tramite Cloudflare su HTTPS 443, preserva il rilevamento di Synapse ed evita la memorizzazione nella cache del traffico API o l'interruzione del caricamento dei file multimediali.

Ripristinare Matrix Synapse in modo sicuro con un dump di PostgreSQL

Esegui il backup di Synapse con pg_dump, proteggi la chiave di firma e i supporti di memorizzazione e ripristina il tutto in un database PostgreSQL pulito senza riutilizzare chiavi monouso obsolete.

Esegui Mjölnir come bot di moderazione per le stanze Matrix con Docker

Esegui Mjölnir come bot di moderazione per le stanze Matrix con Docker

Configura Mjölnir con un account Matrix dedicato, una sala di gestione crittografata, Docker Compose, un elenco di policy e controlli di autorizzazione.

Attiva la sincronizzazione nativa dello scorrimento della matrice per un caricamento più rapido sui dispositivi mobili.

Attiva la sincronizzazione nativa dello scorrimento della matrice per un caricamento più rapido sui dispositivi mobili.

Ignora il proxy obsoleto e configura Sliding Sync, la funzione integrata di Synapse. Verifica il rilevamento dei client, quindi misura il caricamento dell'elenco delle stanze e il comportamento di riconnessione su un telefono compatibile.