Desativar usuários inativos do Matrix sem excluir o histórico da sala.

Para remover uma conta Matrix local inativa do serviço, use POST /_synapse/admin/v1/deactivate/<user_id>o endpoint do Synapse após revisar a conta e seus dispositivos. O Synapse chama isso de desativação: revoga as credenciais e remove o usuário das salas, mas não exclui permanentemente o registro da conta nem as mensagens do usuário. A documentação atual do Synapse v1.157 também distingue a desativação do eraseparâmetro opcional, que tem efeitos mais restritos do que muitos administradores esperam. Consulte a documentação da API de Administração de Usuários do Synapse . Estas etapas seguem a referência da API do Synapse v1.157, verificada em 10 de outubro de 2026; confirme o comportamento com a documentação da sua versão implantada.

"Excluir" significa exclusão permanente da conta?

Não. A operação suportada pela API de administração é a desativação. Ela remove tokens de acesso ativos, dispositivos e chaves de criptografia de ponta a ponta, pushers, hash de senha, IDs de terceiros e as participações em salas do usuário. Convites pendentes são rejeitados e os dados da conta são removidos. Essa é uma alteração significativa mesmo quando ` eraseis` é falso.

Essa configuração "erase": trueremove adicionalmente o nome de exibição do usuário, o URL do avatar e os campos de perfil personalizados, além de marcar a conta como excluída. Ela não exclui mensagens enviadas ou recebidas, mídias carregadas, mapeamentos de ID de SSO ou qualquer outro registro que possa conter dados pessoais. Os membros existentes da sala ainda podem ver as mensagens do usuário; a documentação informa que essas mensagens ficam ocultas para pessoas que entrarem na sala posteriormente. Não considere essa opção da API como um processo completo de exclusão legal. Siga os procedimentos de retenção e privacidade da sua organização antes de usá-la. Analise os efeitos exatos da desativação e exclusão .

Se você precisar de uma restrição reversível enquanto uma conta está sendo investigada, considere usar o endpoint de suspensão do Synapse. A suspensão bloqueia ações como enviar mensagens, entrar em salas e enviar convites, mantendo um caminho para reativar a conta. A desativação é mais adequada para contas que já passaram pela sua política de desligamento ou inatividade.

Como posso confirmar que uma conta está realmente inativa?

Não existe um limite universal de inatividade. Defina um de acordo com a política da sua organização e, em seguida, verifique a atividade real do dispositivo em vez de considerar uma data de registro antiga como prova. Uma conta inativa pode pertencer a um serviço, a um cliente pouco utilizado ou a uma pessoa em licença. Exclua identidades de serviço e administradores de servidores domésticos da limpeza, a menos que um proprietário tenha aprovado a remoção.

  1. Use um token de administrador de servidor de um host confiável. Um token de administrador de sala não é suficiente. A Synapse recomenda evitar /_synapse/admin/o acesso público por meio de proxy reverso e fazer solicitações à API de administração a partir do host da Synapse sempre que possível. Envie o token em um cabeçalho de Autorização; não o cole em um script compartilhado nem o publique em logs. Consulte as diretrizes de autenticação e acesso à API de administração da Synapse .
  2. Liste as contas locais e revise o candidato. O endpoint de listagem v2 pagina os resultados com ; use o valor retornado como o valor next_tokenda próxima solicitação . O filtro opcional exclui convidados, mas a Synapse documenta que esse parâmetro não é compatível quando a integração com o Matrix Authentication Service está habilitada. Remova-o nessa configuração.fromguests=false
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users?from=0&limit=100&guests=false"

Examine os campos retornados name, como ` adminid`, user_type`name` e ` deactivatedvalue`. A listagem exclui contas desativadas por padrão. O exemplo abaixo mostra um único candidato; um servidor real pode retornar várias páginas.

Exemplo de resposta da API de administração do Synapse para a lista de usuários, mostrando @inactive:example.org como uma conta sem privilégios de administrador e que não está desativada.
Exemplo de saída da lista de usuários: verifique o ID exato da Matrix, o status de administrador e o estado atual de desativação antes de prosseguir.
  1. Verifique os dispositivos do candidato. Solicite informações GET /_synapse/admin/v2/users/<user_id>/devices. Compare o horário de cada dispositivo last_seen_tscom o horário limite definido em sua política; trata-se de um timestamp Unix-epoch em milissegundos e pode estar desatualizado em alguns minutos. Considere-o como evidência para revisão, não como uma decisão automática de exclusão.
curl -sS -H "Authorization: Bearer $SYNAPSE_ADMIN_TOKEN" \
  "$SYNAPSE_URL/_synapse/admin/v2/users/%40inactive%3Aexample.org/devices"

Substitua o ID da Matriz de exemplo pelo usuário local que você analisou. Se um dispositivo foi usado recentemente, pare e confirme com o proprietário. Se os registros de data e hora forem antigos, mas a conta for de administrador, bot, identidade de suporte ou usuário vinculado a SSO, verifique a propriedade e as dependências antes de continuar. Consulte a documentação da API do dispositivo last_seen_tse suas unidades .

Exemplo de resposta de lista de dispositivos para @inactive:example.org com um dispositivo Web e seu timestamp last_seen_ts.
Exemplo de saída do dispositivo: verifique o último horário de visualização (last_seen_ts) em todos os dispositivos da conta em relação ao seu período de inatividade aprovado.

Como desativar uma conta aprovada?

Use o ID Matrix local totalmente qualificado, não um nome de exibição. O endpoint de desativação aceita um objeto JSON opcional com erase; o padrão é falso. Manter o padrão preserva os campos de perfil, mas remove sessões, dispositivos, associações a salas e outros dados de desativação descritos acima.

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"

Execute este procedimento para um usuário revisado por vez. Uma resposta positiva não substitui a verificação de que você selecionou a conta correta. Não transforme uma lista de registros de data e hora antigos em um loop POST em massa até que cada conta tenha passado pela sua revisão e verificações de retenção.

Exemplo de requisição POST com curl para o endpoint de desativação do Synapse com a opção `erase` definida como `false`.
O corpo da requisição de exemplo usa erase=false, evitando as ações adicionais de remoção de perfil e de marcador apagado.

Como você verifica o resultado e escolhe apagar?

Consulte a conta novamente com GET /_synapse/admin/v2/users/<user_id>. Confirme se a resposta identifica o ID da Matrix esperado e relata "deactivated": true. A conta não deve mais ter tokens de acesso, dispositivos ou assinaturas de sala ativos. Mantenha o horário da solicitação e o ID da conta em seu registro administrativo, mas nunca armazene o token de portador nesse registro.

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

Defina esta configuração apenas "erase": truequando sua decisão de retenção ou privacidade exigir especificamente a remoção do marcador apagado e dos campos de perfil do Synapse. Essa configuração ainda não remove o histórico de mensagens nem as mídias enviadas. Se precisar que esses dados sejam tratados, use os procedimentos documentados separadamente para redação de eventos e gerenciamento de mídia e verifique seus efeitos independentemente. Além disso, planeje cuidadosamente antes de desativar a conta: a reativação pode exigir a definição de uma nova senha para contas com senha local, e as chaves de criptografia de dispositivos excluídas não podem ser restauradas simplesmente reativando a conta.

Exemplo de resposta de consulta de usuário do Synapse com o parâmetro `deactivated` definido como `true` para `@inactive:example.org`.
Exemplo de resposta de verificação: confirme que a desativação é verdadeira para o ID de usuário exato após a solicitação POST.

Para a conta específica que você selecionou, confirme se a consulta subsequente retorna o valor correto "deactivated": true. Se o resultado for diferente ou se a solicitação apresentar erros, interrompa o processo e investigue a resposta antes de repetir o POST.

Deixar um comentário

Desativar usuários inativos do Matrix sem excluir o histórico da sala.

Desativar usuários inativos do Matrix sem excluir o histórico da sala.

Analise a atividade do dispositivo, desative contas Synapse inativas confirmadas por meio da API de administração e saiba o que a opção de apagar realmente remove.

Reduza a pressão de memória do PostgreSQL no Matrix Synapse

Descubra se a memória usada pelo PostgreSQL provém de consultas, buffers compartilhados, conexões ou manutenção e, em seguida, faça alterações direcionadas e seguras para o Synapse.

Por que as conexões entre salas do Matrix Synapse estão lentas — e o que verificar

Por que as conexões entre salas do Matrix Synapse estão lentas — e o que verificar

Antes de alterar as configurações do Synapse, verifique se a lentidão na entrada de salas Matrix em um servidor remoto, o recuo da federação, a carga do banco de dados local ou a fila de remetentes de saída estão sendo afetados.

Encerrar cadastros na Matrix ou exigir tokens de convite no Synapse

Impeça a criação de contas abertas em um servidor Synapse auto-hospedado ou mantenha os cadastros apenas por convite com tokens de registro de uso limitado.

Aviso de identidade da sessão do Element: verifique seu login com segurança.

Elimine o aviso de sessão não verificada do Element usando um dispositivo confiável ou uma chave de recuperação, com verificações que protegem seu histórico de bate-papo criptografado.

Elimine os timeouts de bloqueio de arquivos do ownCloud com o backend correto.

Diferencie a disputa de bloqueio de banco de dados dos bloqueios WebDAV expirados e, em seguida, escolha e configure a correção adequada para o ownCloud 10.

O que verificar quando o site ownCloud abre em uma página em branco

O que verificar quando o site ownCloud abre em uma página em branco

Rastreie uma tela em branco do ownCloud Web até a causa, como cache do navegador, recursos da web ausentes, erros de serviço ou configurações de URL de proxy reverso, com verificações direcionadas.

Limpar o aviso de memória PHP do ownCloud no ambiente de execução correto

Defina o limite de memória PHP da web do ownCloud, reinicie o serviço correspondente e verifique o valor ativo sem confundi-lo com as configurações da CLI ou os limites de upload.

Solução de problemas de falhas de conexão MySQL no ownCloud 10

Descubra se o MySQL, o PHP, as configurações de socket ou as permissões do banco de dados estão bloqueando o ownCloud 10 e, em seguida, verifique se há uma solução segura.

Defina um prazo de expiração fixo para os links públicos do ownCloud.

Defina um prazo de expiração fixo para os links públicos do ownCloud.

Torne obrigatória a expiração de links públicos no ownCloud Classic, defina um tempo de vida máximo e verifique os compartilhamentos existentes que podem precisar de limpeza separada.