Dezaktywuj nieaktywnych użytkowników Matrix bez usuwania historii pokoju

Aby usunąć nieaktywne lokalne konto Matrix z usługi, należy użyć POST /_synapse/admin/v1/deactivate/<user_id>punktu końcowego Synapse po sprawdzeniu konta i jego urządzeń. Synapse wywołuje tę dezaktywację: unieważnia dane uwierzytelniające i usuwa użytkownika z pokoi, ale nie usuwa trwale rekordu konta ani wiadomości użytkownika. Aktualna dokumentacja Synapse w wersji 1.157 odróżnia również dezaktywację od opcjonalnej eraseflagi, która ma węższy zakres skutków, niż oczekuje wielu administratorów. Dokumentacja interfejsu API administratora użytkowników Synapse . Te kroki są zgodne z dokumentacją interfejsu API Synapse w wersji 1.157, sprawdzoną 10 października 2026 r.; należy potwierdzić działanie z dokumentacją wdrożonej wersji.

Czy „usuń” oznacza trwałe usunięcie konta?

Nie. Obsługiwaną operacją interfejsu API administratora jest dezaktywacja. Usuwa ona aktywne tokeny dostępu, urządzenia i klucze szyfrowania end-to-end, pushery, skróty haseł, identyfikatory stron trzecich oraz członkostwa w pokojach użytkownika. Oczekujące zaproszenia są odrzucane, a dane konta usuwane. Ta zmiana ma istotne znaczenie, nawet jeśli erasema wartość false.

Ustawienie "erase": truedodatkowo usuwa wyświetlaną nazwę użytkownika, adres URL awatara i pola profilu niestandardowego oraz oznacza konto jako usunięte. Nie usuwa wysłanych ani odebranych wiadomości, przesłanych multimediów, mapowań identyfikatorów SSO ani żadnych innych rekordów, które mogą zawierać dane osobowe. Obecni członkowie pokoju nadal mogą widzieć wiadomości użytkownika; dokumentacja informuje, że wiadomości te są ukryte przed osobami, które dołączą do pokoju później. Nie należy traktować tej flagi API jako kompletnego, prawnego procesu usuwania danych. Przed jej użyciem należy przestrzegać procedur dotyczących przechowywania i ochrony prywatności obowiązujących w organizacji. Należy zapoznać się z dokładnymi skutkami dezaktywacji i usuwania danych .

Jeśli potrzebujesz odwracalnego ograniczenia podczas sprawdzania konta, rozważ zamiast tego punkt końcowy zawieszenia Synapse. Zawieszenie blokuje takie czynności, jak wysyłanie wiadomości, dołączanie do pokojów i wysyłanie zaproszeń, zachowując jednocześnie ścieżkę do odwieszenia konta. Dezaktywacja jest lepszym rozwiązaniem w przypadku konta, które przeszło Twoją politykę dotyczącą odwieszania lub braku aktywności.

Jak można potwierdzić, że konto jest rzeczywiście nieaktywne?

Nie ma uniwersalnego progu bezczynności. Ustaw go na podstawie zasad obowiązujących w organizacji, a następnie sprawdź rzeczywistą aktywność urządzenia, zamiast traktować starą datę rejestracji jako dowód. Uśpione konto może należeć do usługi, rzadko używanego klienta lub osoby na urlopie. Wyklucz tożsamości usług i administratorów serwera domowego z czyszczenia, chyba że właściciel zatwierdził ich usunięcie.

  1. Użyj tokena administratora serwera od zaufanego hosta. Administrator pokoju nie wystarczy. Synapse zaleca unikanie /_synapse/admin/publicznego dostępu przez odwrotny serwer proxy i, gdy jest to możliwe, wysyłanie żądań do interfejsu API administratora z hosta Synapse. Wyślij token w nagłówku autoryzacji; nie wklejaj go do współdzielonego skryptu ani nie publikuj w logach. Wskazówki dotyczące uwierzytelniania i dostępu do interfejsu API administratora Synapse .
  2. Wyświetl listę kont lokalnych i przejrzyj kandydata. Punkt końcowy listy v2 dzieli wyniki na strony za pomocą next_token; użyj zwróconej wartości jako wartości następnego żądania from. Opcjonalny guests=falsefiltr wyklucza gości, ale Synapse dokumentuje, że ten parametr nie jest obsługiwany, gdy włączona jest integracja z usługą uwierzytelniania Matrix. Usuń go w tej konfiguracji.
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users?from=0&limit=100&guests=false"

Sprawdź zwrócone pola name, admin, user_typei deactivated. Lista domyślnie nie obejmuje kont dezaktywowanych. Poniższy przykład przedstawia pojedynczego kandydata; rzeczywisty serwer może zwrócić wiele stron.

Przykładowa odpowiedź na listę użytkowników interfejsu API administratora Synapse pokazująca @inactive:example.org jako konto niebędące kontem administratora, które nie zostało dezaktywowane
Przykładowe dane wyjściowe listy użytkowników: przed kontynuacją sprawdź dokładny identyfikator Matrix, status administratora i bieżący stan dezaktywacji.
  1. Sprawdź urządzenia kandydata. Poproś GET /_synapse/admin/v2/users/<user_id>/devices. Porównaj każde urządzenie last_seen_tsz punktem odcięcia Twojej polityki; jest to znacznik czasu epoki Unix w milisekundach, który może być nieaktualny nawet o kilka minut. Potraktuj to jako dowód do weryfikacji, a nie jako automatyczną decyzję o usunięciu.
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users/%40inactive%3Aexample.org/devices"

Zastąp przykładowy identyfikator Matrix sprawdzanym lokalnym użytkownikiem. Jeśli urządzenie było ostatnio używane, zatrzymaj się i potwierdź u jego właściciela. Jeśli znaczniki czasu są stare, ale konto jest kontem administratora, bota, użytkownika pomocy technicznej lub użytkownika powiązanego z SSO, przed kontynuowaniem sprawdź własność i zależności. Dokumenty API urządzenia last_seen_tsi jego jednostki .

Przykładowa odpowiedź listy urządzeń dla @inactive:example.org zawierająca urządzenie internetowe i jego znacznik czasu last_seen_ts
Przykładowe dane wyjściowe urządzenia: sprawdź ostatnie „last_seen_ts” na urządzeniach konta w kontekście zatwierdzonego okresu braku aktywności.

Jak dezaktywować zatwierdzone konto?

Użyj w pełni kwalifikowanego lokalnego identyfikatora Matrix, a nie nazwy wyświetlanej. Punkt końcowy dezaktywacji akceptuje opcjonalny obiekt JSON z erasewartością domyślną false. Pozostawienie wartości domyślnej powoduje zachowanie pól profilu przy jednoczesnym usunięciu sesji, urządzeń, członkostwa w pokojach i innych danych dezaktywacyjnych opisanych powyżej.

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"

Uruchom to dla jednego zweryfikowanego użytkownika na raz. Pomyślna odpowiedź nie zastępuje sprawdzenia, czy Twoje konto zostało wybrane. Nie zamieniaj listy starych znaczników czasu w zbiorczą pętlę POST, dopóki każde konto nie przejdzie pozytywnie weryfikacji i kontroli retencji.

Przykładowe żądanie POST curl do punktu końcowego dezaktywacji Synapse z opcją era ustawioną na false
Przykładowa treść żądania używa parametru erase=false, co pozwala uniknąć dodatkowych działań usuwania profilu i znacznika wymazanego.

Jak sprawdzić wynik i wybrać opcję usunięcia?

Ponownie wyślij zapytanie do konta za pomocą GET /_synapse/admin/v2/users/<user_id>. Potwierdź, że odpowiedź identyfikuje oczekiwany identyfikator Matrix i raportuje "deactivated": true. Konto nie powinno już mieć aktywnych tokenów dostępu, urządzeń ani członkostwa w pokojach. Zachowaj czas żądania i identyfikator konta w swoim rekordzie administracyjnym, ale nigdy nie przechowuj w nim tokena okaziciela.

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

Ustaw tylko "erase": truewtedy, gdy Twoja decyzja dotycząca przechowywania lub prywatności wyraźnie wymaga usunięcia znacznika wymazanego przez Synapse i pola profilu. To ustawienie nadal nie usuwa historii wiadomości ani przesłanych multimediów. Jeśli potrzebujesz ich usunąć, skorzystaj z oddzielnych, udokumentowanych procedur redagowania zdarzeń i zarządzania multimediami , a następnie niezależnie sprawdź ich skutki. Zaplanuj również dezaktywację z rozwagą: ponowna aktywacja może wymagać ustawienia nowego hasła dla kont z hasłem lokalnym, a usuniętych kluczy szyfrowania urządzenia nie da się przywrócić poprzez ponowną aktywację konta.

Przykładowa odpowiedź użytkownika Synapse na zapytanie z ustawieniem deactivated na true dla @inactive:example.org
Przykładowa odpowiedź weryfikacyjna: confirm deactivated jest prawdą dla dokładnego identyfikatora użytkownika po żądaniu POST.

Sprawdź, czy dla konkretnego konta docelowego zapytanie zwraca wartość "deactivated": true. Jeśli wynik jest inny lub występują błędy w żądaniu, przerwij i sprawdź odpowiedź przed powtórzeniem testu POST.

Zostaw komentarz

Dezaktywuj nieaktywnych użytkowników Matrix bez usuwania historii pokoju

Dezaktywuj nieaktywnych użytkowników Matrix bez usuwania historii pokoju

Przejrzyj aktywność urządzenia, dezaktywuj potwierdzone nieaktywne konta Synapse za pomocą interfejsu API administratora i dowiedz się, co tak naprawdę usuwa opcjonalna flaga usuwania.

Zmniejsz obciążenie pamięci PostgreSQL w Matrix Synapse

Sprawdź, czy pamięć PostgreSQL pochodzi z obsługi zapytań, współdzielonych buforów, połączeń czy konserwacji, a następnie wprowadź ukierunkowane zmiany bezpieczne dla Synapse.

Dlaczego połączenia w pokoju Matrix Synapse są powolne i co należy sprawdzić

Dlaczego połączenia w pokoju Matrix Synapse są powolne i co należy sprawdzić

Śledź powolne dołączanie pokoju Matrix do jednego zdalnego serwera domowego, wycofywanie federacji, obciążenie lokalnej bazy danych lub kolejkę nadawcy wychodzącego przed zmianą ustawień Synapse.

Zamknij rejestrację w Matrix lub wymagaj tokenów zaproszeń w Synapse

Zatrzymaj możliwość tworzenia otwartych kont na samodzielnie hostowanym serwerze Synapse lub zachowaj możliwość rejestracji wyłącznie na zaproszenia, korzystając z tokenów rejestracyjnych o ograniczonym zastosowaniu.

Ostrzeżenie dotyczące tożsamości sesji elementu: Zweryfikuj bezpiecznie swoje logowanie

Ostrzeżenie Clear Element o niezweryfikowanej sesji korzystające z zaufanego urządzenia lub klucza odzyskiwania, z kontrolami chroniącymi historię szyfrowanych czatów.

Zatrzymaj przekroczenia limitu czasu blokady plików w chmurze ownCloud za pomocą odpowiedniego zaplecza

Rozróżnij konflikty blokad bazy danych od wygasłych blokad WebDAV, a następnie wybierz i skonfiguruj odpowiednią poprawkę ownCloud 10.

Co sprawdzić, gdy witryna ownCloud Web otwiera się na pustej stronie

Co sprawdzić, gdy witryna ownCloud Web otwiera się na pustej stronie

Śledź pusty ekran witryny ownCloud Web w kontekście pamięci podręcznej przeglądarki, brakujących zasobów sieciowych, błędów usług lub ustawień adresu URL serwera proxy odwrotnego za pomocą ukierunkowanych kontroli.

Wyczyść ostrzeżenie dotyczące pamięci PHP ownCloud w odpowiednim środowisku wykonawczym

Ustaw limit pamięci PHP dla witryny ownCloud, uruchom ponownie odpowiednią usługę i zweryfikuj aktywną wartość, nie myląc jej z ustawieniami CLI ani limitami przesyłania.

Rozwiązywanie problemów z połączeniem MySQL w chmurze ownCloud 10

Sprawdź, czy MySQL, PHP, ustawienia gniazd lub uprawnienia bazy danych blokują ownCloud 10, a następnie sprawdź, czy istnieje bezpieczne rozwiązanie.

Ustaw sztywny limit wygaśnięcia dla publicznych linków ownCloud

Ustaw sztywny limit wygaśnięcia dla publicznych linków ownCloud

Ustaw obowiązkowe wygasanie łączy publicznych w ownCloud Classic, ustaw maksymalny czas trwania i zaznacz istniejące udziały, które mogą wymagać osobnego czyszczenia.