Деактивация неактивных пользователей матрицы без удаления истории комнат.

Чтобы удалить неактивную локальную учетную запись Matrix из сервиса, используйте конечную точку Synapse POST /_synapse/admin/v1/deactivate/<user_id>после проверки учетной записи и ее устройств. Synapse называет это деактивацией: она аннулирует учетные данные и удаляет пользователя из комнат, но не удаляет запись учетной записи или сообщения пользователя. В текущей документации Synapse v1.157 также различается деактивация и необязательный eraseфлаг, который имеет более узкий эффект, чем ожидают многие администраторы. Документация по API администрирования пользователей Synapse . Эти шаги соответствуют справочнику API Synapse v1.157, проверенному 10 октября 2026 г.; подтвердите поведение, сверившись с документацией для вашей развернутой версии.

Означает ли «удалить» окончательное удаление учетной записи?

Нет. Поддерживаемая операция API администратора — деактивация. Она удаляет активные токены доступа, устройства и ключи сквозного шифрования, отправителей, хэши паролей, идентификаторы третьих лиц и членство пользователя в комнатах. Ожидающие приглашения отклоняются, а данные учетной записи удаляются. Это существенное изменение, даже если eraseзначение параметра равно false.

Эта настройка "erase": trueдополнительно удаляет отображаемое имя пользователя, URL-адрес аватара и пользовательские поля профиля, а также помечает учетную запись как удаленную. Она не удаляет отправленные или полученные сообщения, загруженные медиафайлы, сопоставления идентификаторов SSO или любые другие записи, которые могут содержать персональные данные. Существующие участники комнаты по-прежнему могут видеть сообщения пользователя; в документации указано, что эти сообщения скрыты от тех, кто присоединится к комнате позже. Не рассматривайте этот флаг API как полный юридически обоснованный процесс удаления. Перед использованием следуйте процессу хранения и обеспечения конфиденциальности вашей организации. Ознакомьтесь с точными последствиями деактивации и удаления .

Если вам необходимо отменить ограничение на время проверки учетной записи, рассмотрите вместо этого конечную точку приостановки Synapse. Приостановка блокирует такие действия, как отправка сообщений, присоединение к комнатам и отправка приглашений, сохраняя при этом возможность разблокировки учетной записи. Деактивация лучше подходит для учетной записи, которая прошла проверку на удаление или неактивность.

Как можно убедиться, что учетная запись действительно неактивна?

Универсального порога неактивности не существует. Установите его в соответствии с политикой вашей организации, а затем проверяйте фактическую активность устройства, а не используйте старую дату регистрации в качестве доказательства. Неактивная учетная запись может принадлежать службе, редко используемому клиенту или сотруднику, находящемуся в отпуске. Исключите учетные записи служб и администраторов домашних серверов из процесса очистки, если владелец не одобрил их удаление.

  1. Используйте токен администратора сервера от доверенного хоста. Одного администратора комнаты недостаточно. Synapse рекомендует избегать /_synapse/admin/доступа через публичный обратный прокси и по возможности отправлять запросы к Admin API с хоста Synapse. Отправляйте токен в заголовке Authorization; не вставляйте его в общий скрипт и не публикуйте в логах. Руководство по аутентификации и доступу к Synapse Admin API .
  2. Список локальных учетных записей и проверка кандидата. Конечная точка списка v2 выполняет постраничную обработку результатов с помощью параметра next_token; используйте его возвращенное значение в качестве значения следующего запроса from. Дополнительный guests=falseфильтр исключает гостей, но в документации Synapse указано, что этот параметр не поддерживается при включенной интеграции со службой аутентификации Matrix. Удалите его в этой конфигурации.
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users?from=0&limit=100&guests=false"

Проверьте возвращенные поля name, admin, user_type, и deactivated. В списке по умолчанию отсутствуют деактивированные учетные записи. Пример ниже показывает одного кандидата; реальный сервер может вернуть несколько страниц.

Пример ответа Synapse Admin API на запрос списка пользователей, показывающий @inactive:example.org как учетную запись, не являющуюся администраторской, но не деактивированную.
Пример вывода списка пользователей: перед продолжением проверьте точный идентификатор матрицы, статус администратора и текущее состояние деактивации.
  1. Проверьте устройства кандидата. Запросите данные GET /_synapse/admin/v2/users/<user_id>/devices. Сравните данные каждого устройства last_seen_tsс установленным вами порогом; это метка времени Unix-epoch в миллисекундах, которая может быть устаревшей на несколько минут. Рассматривайте это как доказательство для проверки, а не как основание для автоматического удаления.
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users/%40inactive%3Aexample.org/devices"

Замените указанный в примере идентификатор матрицы на имя локального пользователя, которого вы проверяли. Если устройство использовалось недавно, остановите его и подтвердите использование с владельцем. Если метки времени устарели, но учетная запись является администратором, ботом, учетной записью поддержки или пользователем, связанным с SSO, проверьте права собственности и зависимости, прежде чем продолжить. Документация по API устройства last_seen_tsи его модулям .

Пример ответа device-list для @inactive:example.org с веб-устройством и его меткой времени last_seen_ts.
Пример вывода с устройства: проверьте самые последние значения last_seen_ts на всех устройствах учетной записи на соответствие разрешенному периоду неактивности.

Как деактивировать одобренный аккаунт?

Используйте полный локальный идентификатор Matrix ID, а не отображаемое имя. Конечная точка деактивации принимает необязательный JSON-объект с параметром erase`--`; по умолчанию он имеет значение `false`. Если оставить значение по умолчанию, поля профиля сохранятся, но при этом будут удалены сессии, устройства, членство в комнатах и ​​другие данные деактивации, описанные выше.

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"

Выполняйте этот запрос для каждого проверенного пользователя по отдельности. Успешный ответ не заменяет проверку того, что вы выбрали нужную учетную запись. Не превращайте список старых временных меток в цикл массовых POST-запросов, пока каждая учетная запись не пройдет проверку и проверку на хранение.

Пример POST-запроса curl к конечной точке деактивации Synapse с параметром erase, установленным в значение false.
В примере тела запроса используется параметр erase=false, что позволяет избежать дополнительных действий по удалению профиля и удалению маркера.

Как проверить результат и выбрать опцию «стереть»?

Повторите запрос к учетной записи с помощью команды ` GET /_synapse/admin/v2/users/<user_id>.`. Убедитесь, что ответ идентифицирует ожидаемый идентификатор Matrix ID и сообщает об ошибке "deactivated": true. У учетной записи больше не должно быть активных токенов доступа, устройств или членства в комнатах. Сохраните время запроса и идентификатор учетной записи в административной записи, но никогда не сохраняйте токен носителя в этой записи.

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

Устанавливайте этот параметр только "erase": trueв том случае, если ваше решение о хранении данных или конфиденциальности специально требует удаления маркера удаления и поля профиля в Synapse. Этот параметр по-прежнему не удаляет историю сообщений или загруженные медиафайлы. Если вам необходимо обработать эти данные, используйте отдельные описанные процедуры удаления событий и управления медиафайлами и проверьте их действие независимо друг от друга. Также тщательно спланируйте все действия перед деактивацией: повторная активация может потребовать установки нового пароля для локальных учетных записей, а удаленные ключи шифрования устройства нельзя восстановить простой повторной активацией учетной записи.

Пример ответа на пользовательский запрос Synapse, в котором параметр deactivated установлен в значение true для @inactive:example.org
Пример ответа на запрос проверки: подтверждение деактивации имеет значение true для точного идентификатора пользователя после POST-запроса.

Чтобы проверить правильность ответа на ваш запрос, подтвердите, что он возвращает именно ту учетную запись, на которую вы ориентировались "deactivated": true. Если результат отличается или запрос содержит ошибку, остановитесь и изучите ответ, прежде чем повторять POST-запрос.

Оставить комментарий

Деактивация неактивных пользователей матрицы без удаления истории комнат.

Деактивация неактивных пользователей матрицы без удаления истории комнат.

Просматривайте активность устройства, деактивируйте подтвержденные неактивные учетные записи Synapse через Admin API и узнайте, что именно удаляет необязательный флаг удаления.

Снижение нагрузки на память PostgreSQL в Matrix Synapse

Определите, связана ли нехватка памяти в PostgreSQL с выполнением запросов, использованием общих буферов, соединениями или обслуживанием, а затем внесите целенаправленные изменения, безопасные для Synapse.

Почему соединение комнат в Matrix Synapse происходит медленно — и что следует проверить

Почему соединение комнат в Matrix Synapse происходит медленно — и что следует проверить

Перед изменением настроек Synapse отследите медленные подключения к комнатам Matrix до одного из удаленных домашних серверов, задержки федерации, загрузки локальной базы данных или исходящей очереди отправителя.

Закройте регистрацию в Matrix или требуйте токены приглашения в Synapse.

Прекратите создание новых учетных записей на собственном сервере Synapse или сделайте регистрацию доступной только по приглашениям с использованием регистрационных токенов ограниченного действия.

Предупреждение о проверке подлинности сессии элемента: проверьте свои данные для входа в систему безопасно.

Предупреждение Clear Element о непроверенной сессии при использовании доверенного устройства или ключа восстановления, а также проверки, защищающие вашу зашифрованную историю чата.

Предотвратите тайм-ауты блокировки файлов в ownCloud с помощью подходящей серверной части.

Различите конфликты блокировок базы данных от истекших блокировок WebDAV, затем выберите и настройте подходящее решение для ownCloud 10.

Что проверить, если при открытии веб-страницы ownCloud отображается пустая страница?

Что проверить, если при открытии веб-страницы ownCloud отображается пустая страница?

С помощью целенаправленных проверок можно выявить причину появления пустого экрана ownCloud Web: кэш браузера, отсутствующие веб-ресурсы, ошибки сервиса или настройки URL-адреса обратного прокси-сервера.

Устраните предупреждение о нехватке памяти PHP в ownCloud в соответствующей среде выполнения.

Установите ограничение на использование памяти PHP в веб-версии ownCloud, перезапустите соответствующий сервис и проверьте активное значение, не путая его с настройками CLI или ограничениями на загрузку.

Устранение неполадок с подключением к MySQL в ownCloud 10

Выясните, блокируют ли ownCloud 10 MySQL, PHP, настройки сокетов или права доступа к базе данных, а затем проверьте, можно ли устранить проблему безопасным способом.

Установите жесткий лимит истечения срока действия для публичных ссылок ownCloud.

Установите жесткий лимит истечения срока действия для публичных ссылок ownCloud.

Сделайте обязательным истечение срока действия публичных ссылок в ownCloud Classic, установите максимальный срок действия и проверяйте существующие общие ресурсы, которые могут потребовать отдельной очистки.