Disattivare gli utenti Matrix inattivi senza eliminare la cronologia delle stanze

Per rimuovere un account Matrix locale inattivo dal servizio, utilizzare POST /_synapse/admin/v1/deactivate/<user_id>l'endpoint di Synapse dopo aver esaminato l'account e i relativi dispositivi. Synapse definisce questa operazione "disattivazione": revoca le credenziali e rimuove l'utente dalle stanze, ma non elimina definitivamente il record dell'account o i messaggi dell'utente. La documentazione corrente di Synapse v1.157 distingue inoltre la disattivazione dal eraseflag opzionale, che ha effetti più limitati di quanto molti amministratori si aspettino. Consultare la documentazione dell'API di amministrazione utenti di Synapse . Questi passaggi seguono il riferimento API di Synapse v1.157, verificato il 10 ottobre 2026; verificare il comportamento con la documentazione per la versione in uso.

Con "eliminare" si intende la cancellazione definitiva dell'account?

No. L'operazione supportata dall'API di amministrazione è la disattivazione. Rimuove i token di accesso attivi, i dispositivi e le chiavi di crittografia end-to-end, i pusher, l'hash della password, gli ID di terze parti e le iscrizioni alle stanze dell'utente. Gli inviti in sospeso vengono rifiutati e i dati dell'account vengono rimossi. Si tratta di una modifica consequenziale anche quando eraseè falso.

Questa impostazione "erase": truerimuove inoltre il nome visualizzato dell'utente, l'URL dell'avatar e i campi del profilo personalizzati, e contrassegna l'account come cancellato. Non elimina i messaggi inviati o ricevuti, i file multimediali caricati, le mappature degli ID SSO o qualsiasi altro record che possa contenere dati personali. I membri esistenti della stanza possono ancora visualizzare i messaggi dell'utente; la documentazione afferma che tali messaggi sono nascosti agli utenti che si uniscono alla stanza in un secondo momento. Non considerare questo flag API come un flusso di lavoro di cancellazione legale completo. Segui le procedure di conservazione e privacy della tua organizzazione prima di utilizzarlo. Esamina gli effetti esatti di disattivazione e cancellazione .

Se hai bisogno di una restrizione reversibile durante un'indagine su un account, considera l'endpoint di sospensione di Synapse. La sospensione blocca azioni come l'invio di messaggi, l'accesso alle stanze e l'invio di inviti, pur mantenendo la possibilità di riattivare l'account. La disattivazione è più adatta per un account che ha superato la procedura di offboarding o di inattività.

Come si può verificare che un account sia effettivamente inattivo?

Non esiste una soglia di inattività universale. Impostane una in base alle policy della tua organizzazione, quindi verifica l'attività effettiva del dispositivo anziché considerare una vecchia data di registrazione come prova. Un account inattivo potrebbe appartenere a un servizio, a un client utilizzato raramente o a una persona in congedo. Escludi le identità di servizio e gli amministratori di homeserver dalla pulizia, a meno che il proprietario non ne abbia approvato la rimozione.

  1. Utilizza un token di amministratore del server proveniente da un host attendibile. Un token di amministratore di sala non è sufficiente. Synapse consiglia di evitare /_synapse/admin/l'accesso tramite reverse proxy pubblico e di effettuare le richieste API di amministrazione dall'host Synapse, quando possibile. Invia il token nell'intestazione Authorization; non incollarlo in uno script condiviso né pubblicarlo nei log. Consulta le linee guida per l'autenticazione e l'accesso all'API di amministrazione di Synapse .
  2. Elenca gli account locali e rivedi il candidato. L'endpoint di elenco v2 impagina i risultati con ; usa il valore restituito come valore next_tokendella richiesta successiva . Il filtro opzionale esclude gli ospiti, ma Synapse documenta che questo parametro non è supportato quando è abilitata l'integrazione con Matrix Authentication Service. Rimuovilo in tale configurazione.fromguests=false
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users?from=0&limit=100&guests=false"

nameEsamina i campi , admin, user_type, e restituiti deactivated. L'elenco esclude per impostazione predefinita gli account disattivati. L'esempio seguente mostra un singolo candidato; un server reale potrebbe restituire più pagine.

Esempio di risposta dell'API di amministrazione di Synapse per la richiesta di elenco utenti, che mostra @inactive:example.org come un account non amministratore non disattivato.
Esempio di output dell'elenco utenti: verificare l'ID Matrix esatto, lo stato di amministratore e lo stato di disattivazione corrente prima di procedere.
  1. Controlla i dispositivi del candidato. Richiedi GET /_synapse/admin/v2/users/<user_id>/devices. Confronta l'ora di ciascun dispositivo last_seen_tscon la data limite definita dalla tua policy; si tratta di un timestamp in millisecondi, in formato Unix-epoch, che può essere obsoleto di qualche minuto. Consideralo come una prova da esaminare, non come una decisione di eliminazione automatica.
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users/%40inactive%3Aexample.org/devices"

Sostituisci l'ID matrice di esempio con l'utente locale che hai esaminato. Se un dispositivo è stato utilizzato di recente, interrompi e conferma con il proprietario. Se i timestamp sono vecchi ma l'account è un amministratore, un bot, un'identità di supporto o un utente collegato a SSO, verifica la proprietà e le dipendenze prima di continuare. La documentazione API del dispositivo last_seen_tse le relative unità .

Esempio di risposta device-list per @inactive:example.org con un dispositivo Web e il relativo timestamp last_seen_ts
Esempio di output del dispositivo: verifica il valore più recente di last_seen_ts su tutti i dispositivi dell'account rispetto al periodo di inattività approvato.

Come si disattiva un account approvato?

Utilizzare l'ID Matrix locale completo, non un nome visualizzato. L'endpoint di disattivazione accetta un oggetto JSON facoltativo con erase; il valore predefinito è false. Lasciando il valore predefinito, i campi del profilo vengono conservati, ma vengono comunque rimossi sessioni, dispositivi, appartenenze alle stanze e altri dati di disattivazione descritti in precedenza.

curl -sS -X POST \
  -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"erase": false}' \
  "$SYNAPSE_URL/_synapse/admin/v1/deactivate/%40inactive%3Aexample.org"

Eseguite questa procedura per un utente alla volta. Una risposta positiva non sostituisce la verifica di aver indirizzato correttamente l'account desiderato. Non trasformate un elenco di vecchi timestamp in un ciclo POST di massa finché ogni account non avrà superato i controlli di revisione e conservazione.

Esempio di richiesta POST tramite curl all'endpoint di disattivazione di Synapse con l'opzione "erase" impostata su "false".
Il corpo della richiesta di esempio utilizza erase=false, evitando le azioni aggiuntive di rimozione del profilo e del marcatore cancellato.

Come si verifica il risultato e si sceglie di cancellare?

Interroga nuovamente l'account con GET /_synapse/admin/v2/users/<user_id>. Verifica che la risposta identifichi l'ID Matrix previsto e riporti "deactivated": true. L'account non dovrebbe più avere token di accesso attivi, dispositivi o iscrizioni a stanze. Conserva l'ora della richiesta e l'ID dell'account nel tuo record amministrativo, ma non memorizzare mai il token bearer in tale record.

curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users/%40inactive%3Aexample.org"

Imposta questa opzione solo "erase": truese la tua decisione in materia di conservazione o privacy richiede espressamente la rimozione del marcatore di cancellazione e dei campi del profilo da parte di Synapse. Tale impostazione non rimuove comunque la cronologia dei messaggi o i file multimediali caricati. Se hai bisogno di gestirli, utilizza le procedure separate documentate per la redazione degli eventi e la gestione dei file multimediali e verificane gli effetti in modo indipendente. Pianifica attentamente anche prima della disattivazione: la riattivazione potrebbe richiedere l'impostazione di una nuova password per gli account con password locale e le chiavi di crittografia del dispositivo eliminate non possono essere ripristinate semplicemente riattivando l'account.

Esempio di risposta alla query utente di Synapse con l'opzione "disattivato" impostata su true per @inactive:example.org
Esempio di risposta di verifica: conferma che lo stato disattivato sia vero per l'ID utente specifico dopo la richiesta POST.

Per l'account specifico a cui hai fatto riferimento, verifica che la query di follow-up restituisca un risultato "deactivated": true. Se il risultato è diverso o la richiesta presenta un errore, interrompi e analizza la risposta prima di ripetere la POST.

Lascia un commento

Disattivare gli utenti Matrix inattivi senza eliminare la cronologia delle stanze

Disattivare gli utenti Matrix inattivi senza eliminare la cronologia delle stanze

Esamina l'attività del dispositivo, disattiva gli account Synapse inattivi confermati tramite l'API di amministrazione e scopri cosa rimuove effettivamente il flag di cancellazione opzionale.

Ridurre la pressione sulla memoria di PostgreSQL in Matrix Synapse

Scopri se l'utilizzo della memoria PostgreSQL deriva da query, buffer condivisi, connessioni o operazioni di manutenzione, quindi apporta modifiche mirate e compatibili con Synapse.

Perché le connessioni tra le stanze di sinapsi di Matrix sono lente e cosa controllare

Perché le connessioni tra le stanze di sinapsi di Matrix sono lente e cosa controllare

Traccia le connessioni lente alle stanze Matrix verso un homeserver remoto, il backoff della federazione, il caricamento del database locale o una coda di invio in uscita prima di modificare le impostazioni di Synapse.

Chiudere le iscrizioni a Matrix o richiedere token di invito su Synapse

Impedisci la creazione di account aperti su un server Synapse self-hosted oppure mantieni le registrazioni accessibili solo su invito con token di registrazione a utilizzo limitato.

Avviso di identità della sessione Element: verifica le tue credenziali di accesso in modo sicuro

Clear Element offre un sistema di avviso per sessioni non verificate utilizzando un dispositivo attendibile o una chiave di ripristino, con controlli che proteggono la cronologia delle chat crittografate.

Evita i timeout di blocco dei file di ownCloud con il backend giusto

Distingui i conflitti di blocco del database dai blocchi WebDAV scaduti, quindi scegli e configura la soluzione ownCloud 10 più adatta.

Cosa controllare quando ownCloud Web si apre su una pagina vuota

Cosa controllare quando ownCloud Web si apre su una pagina vuota

Individua le cause di una schermata web ownCloud vuota, come la cache del browser, la mancanza di risorse web, errori di servizio o impostazioni URL del proxy inverso, tramite controlli mirati.

Rimuovi l'avviso di memoria PHP di ownCloud nel runtime corretto

Imposta il limite di memoria PHP web di ownCloud, riavvia il servizio corrispondente e verifica il valore attivo senza confonderlo con le impostazioni della CLI o i limiti di caricamento.

Risoluzione dei problemi di connessione MySQL di ownCloud 10

Scopri se MySQL, PHP, le impostazioni dei socket o i permessi del database stanno bloccando ownCloud 10, quindi verifica una soluzione sicura.

Imposta un limite di scadenza preciso per i link pubblici di ownCloud.

Imposta un limite di scadenza preciso per i link pubblici di ownCloud.

Rendi obbligatoria la scadenza dei link pubblici in ownCloud Classic, imposta una durata massima e verifica le condivisioni esistenti che potrebbero richiedere una pulizia separata.