Encerrar cadastros na Matrix ou exigir tokens de convite no Synapse

Para impedir cadastros públicos em um servidor doméstico Matrix auto-hospedado executando o Synapse, defina as configurações necessárias enable_registration: falsee homeserver.yamlreinicie o Synapse. Se você quiser que as pessoas convidadas criem contas por conta própria, mantenha o registro habilitado, mas exija tokens de registro. Verifique a registration_shared_secretconfiguração separada: qualquer pessoa que a conheça ainda poderá criar contas, incluindo administradores do servidor, mesmo quando o registro comum estiver desabilitado.

Escolha a política de inscrição correta

A configuração correta depende de como as novas contas devem ser criadas:

  • Servidor privado, contas provisionadas por um administrador: desative o registro público. Crie usuários com register_new_matrix_usero comando do Synapse ou outro processo administrativo aprovado.
  • Servidor somente para convidados, usuários se registram pelo Element ou outro cliente: habilite o registro e exija um token. Forneça a cada pessoa um token de uso limitado por meio de um canal privado.
  • Servidor público: tokens de registro, CAPTCHA ou e-mail/telefone verificados podem reduzir o abuso automatizado, mas não garantem que todas as contas sejam confiáveis.

Este artigo aborda o Synapse, a implementação de servidor doméstico Matrix autohospedada mais amplamente utilizada. Outros softwares de servidor doméstico possuem suas próprias configurações. A documentação de configuração atual do Synapse indica que o registro está desativado por padrão e que os tokens de registro só funcionam quando o próprio registro está ativado. Se você utiliza o Matrix Authentication Service (MAS), consulte a documentação dele para obter informações sobre os controles de registro correspondentes; a API de administração de tokens de registro do Synapse é desativada quando a integração com o MAS está ativada.

Desativar o cadastro público no Synapse

  1. Localize o arquivo de configuração ativo. Instalações de pacotes comuns usam `/etc /etc/matrix-synapse/homeserver.yaml/config.conf`; instalações de contêineres geralmente montam o arquivo em `/etc/config.conf` /data/homeserver.yaml. Use o caminho configurado para o seu serviço em vez de assumir um local específico.
  2. Faça backup do arquivo e, em seguida, defina o sinalizador de registro. Na configuração YAML de nível superior, adicione ou altere a configuração para:
    enable_registration: false
    Se a chave já existir, edite essa entrada em vez de adicionar uma duplicada. A indentação do YAML e chaves duplicadas podem causar confusão, portanto, mantenha a configuração no nível superior e preserve a estrutura existente do arquivo.
  3. Analise o segredo de registro compartilhado. O Synapse registration_shared_secret(ou o registration_shared_secret_path) suporta o script de registro administrativo. O guia de instalação do Synapse alerta que alguém com esse segredo pode criar contas padrão ou de administrador, mesmo com o registro público desativado. Mantenha-o em sigilo, restrinja o acesso ao arquivo correspondente e não o inclua em um repositório público, na configuração do cliente ou em mensagens para convidados. Se você não utiliza o registro com segredo compartilhado, remova a configuração somente após confirmar que nenhuma automação depende dela. Você pode, em vez disso, criar contas usando outro fluxo de trabalho administrativo compatível.
  4. Valide e reinicie o Synapse. Use o gerenciador de serviços, a orquestração de contêineres ou o método de implantação que executa seu servidor. Para um serviço systemd geralmente chamado de `systemd` matrix-synapse, um administrador pode executar o seguinte comando:
    sudo systemctl restart matrix-synapse
    sudo systemctl status matrix-synapse --no-pager
    O nome exato do serviço varia entre as implantações de pacotes e contêineres. Verifique os logs se o serviço não iniciar; não continue editando um arquivo de configuração repetidamente sem resolver um erro de YAML ou de configuração relatado.

Contas existentes e acesso à sala não são removidos ao desativar o registro. Essa configuração impede novos registros regulares por meio do fluxo de registro do cliente; não se trata de um controle de exclusão de usuário ou desativação do servidor.

Permitir cadastros somente com tokens de registro.

Use esta opção quando quiser que os convidados concluam o cadastro por conta própria, mas não queira uma página de registro aberta. Em homeserver.yaml, configure ambas as opções:

enable_registration: true
registration_requires_token: true

Reinicie o Synapse após salvar. Um token de acesso não é o mesmo que desabilitar o registro: pessoas com tokens válidos podem criar contas. O manual de configuração do Synapse recomenda controles antiabuso quando o registro estiver habilitado; escolha uma política adequada ao seu público e capacidade operacional.

Para versões do Synapse que suportam a API de Administração de Tokens de Registro documentada, um administrador pode criar um token de uso único. O exemplo a seguir usa um URL e um token de acesso fictícios; execute-o somente em um ambiente administrativo confiável, substitua o URL base público do seu servidor doméstico e o token de acesso de administrador, e proteja o histórico e os logs do shell:

curl -X POST "https://matrix.example.com/_synapse/admin/v1/registration_tokens/new" \
  -H "Authorization: Bearer YOUR_SERVER_ADMIN_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"uses_allowed":1}'

A resposta inclui o token gerado. Compartilhe esse valor de forma privada com o usuário pretendido. A API do Synapse também suporta um tempo de expiração, medido em milissegundos desde a época Unix; use a referência oficial da API para calcular e definir a expiração corretamente para sua implementação. Um token com limite de uso ou expiração omitidos terá usos ilimitados e nenhuma expiração por padrão, portanto, defina os limites deliberadamente. Os administradores podem listar, atualizar ou excluir tokens por meio da mesma API. Não cole um token de portador ou token de registro real em uma issue ou artigo público.

O gerenciamento de tokens possui limites de versão e implantação: consulte a documentação da API de administração correspondente à sua versão do Synapse instalada. A documentação atual observa que esta API do Synapse não está disponível quando a integração com o MAS está habilitada; use a API de administração do MAS ou a CLI nessa configuração.

Erros comuns de configuração

  • Alterar o arquivo errado: os contêineres podem ler um arquivo montado, enquanto o host possui uma cópia separada. Confirme o caminho usado pelo processo Synapse em execução.
  • Esqueça a reinicialização: as alterações de configuração são lidas pelo serviço, portanto, uma edição de texto bem-sucedida por si só não demonstra que a nova política está ativa.
  • Considerando que o registro desativado bloqueia todas as rotas: um segredo compartilhado configurado permanece como um caminho para criação de conta. Proteja-o ou remova-o conforme a necessidade da automação administrativa.
  • Habilitar tokens, mas desabilitar o registro, registration_requires_token não ativa o registro automaticamente. Ambas as opções devem permitir o fluxo pretendido.
  • Partindo do pressuposto de que tokens exclusivos para convidados impedem qualquer abuso: um token reutilizável vazado pode ser usado por pessoas não autorizadas. Limite o uso, defina um prazo de validade quando viável e distribua os tokens de forma privada.

Verifique o resultado

Após reiniciar o Synapse, abra o fluxo de registro do seu servidor doméstico em um cliente Matrix usando uma sessão não autenticada. Para um servidor fechado, o cliente não deve oferecer um cadastro público bem-sucedido, embora os usuários existentes ainda possam fazer login. Para registro com token, tente o fluxo sem token e confirme se ele solicita um; em seguida, use um token de teste em uma conta de teste controlada e confirme se o registro é bem-sucedido. Verifique os logs do Synapse e o status do token da API de administração se o resultado for diferente da política pretendida. Evite testar com o token de convite real se isso consumir o único uso permitido dele.

Referências oficiais

Deixar um comentário

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.

Adicione autenticação de dois fatores TOTP ao ownCloud escale infinitamente com o Keycloak.

Adicione autenticação de dois fatores TOTP ao ownCloud escale infinitamente com o Keycloak.

Habilite o TOTP por meio do Keycloak, inscreva usuários com segurança e entenda quando as configurações de MFA em nível de rota do Infinite Scale se aplicam.

Restaure a sincronização do ownCloud associando o cliente ao seu servidor.

Verifique se o problema é uma quebra de compatibilidade entre o OC10 e o 7.x ou um registro CSync corrompido e, em seguida, aplique a correção adequada sem excluir os arquivos sincronizados.

Coloque o ownCloud em HTTPS com Let's Encrypt e Nginx

Coloque o ownCloud em HTTPS com Let's Encrypt e Nginx

Escolha HTTP-01 ou DNS-01, configure um proxy reverso ownCloud e verifique se o Certbot renova os certificados HTTPS automaticamente.