Resolver erros de certificado TLS da Synapse Federation

Quando os registros do Matrix Synapse mostram que SSL: CERTIFICATE_VERIFY_FAILED, durante a federação, uma junção pode travar, um servidor remoto pode rejeitar sua conexão ou as mensagens podem não chegar, primeiro determine qual certificado está falhando: o certificado de um servidor remoto durante uma solicitação de saída ou o certificado do seu próprio endpoint de federação quando outro servidor se conecta. Em seguida, corrija a cadeia de certificados, o nome do host ou a configuração de confiança identificada pelo registro e por um teste de federação. Não desative a verificação TLS como uma solução geral.

O tráfego entre servidores do Matrix utiliza HTTPS, e a especificação do Matrix exige que o destino apresente um certificado TLS assinado por uma autoridade certificadora reconhecida. Um erro de verificação geralmente significa que o certificado apresentado está expirado, incompleto, emitido para um nome de host diferente ou assinado por uma AC na qual o servidor de conexão não confia. Um proxy reverso também pode fornecer o certificado errado, mesmo quando a configuração do Synapse parece correta.

1. Identifique o lado com falha antes de alterar a configuração.

Verifique a entrada de log do Synapse relacionada à falha e anote o nome do servidor remoto e o erro exato do certificado. Se o Synapse reportar a falha ao fazer uma requisição para outro servidor doméstico, o certificado do servidor remoto ou a confiança da Autoridade Certificadora (CA) usada pelo seu processo do Synapse está implicado. Se outros servidores não conseguirem se federar com o seu domínio, inspecione seu endpoint TLS público e a descoberta de servidores.

Confirme o nome do seu servidor Matrix em homeserver.yaml, especialmente server_name. Esta é a parte do domínio dos IDs locais do Matrix e determina como outros servidores domésticos podem acessar você. Não confunda com o nome de host interno da máquina ou do contêiner. A documentação de instalação atual do Synapse explica que o nome do servidor é uma identidade de federação e recomenda escolhê-lo antes da instalação.

2. Teste o certificado público e a rota de federação.

Use o Matrix Federation Tester com o nome do seu servidor Matrix. Ele verifica a descoberta e a conectividade da federação e pode revelar se o certificado ou o roteamento visível externamente está com problemas. Corrija o item identificado antes de ajustar as configurações de confiança de saída do Synapse.

A partir de uma máquina que consiga acessar o seu ponto de extremidade de federação, inspecione o certificado TLS. Substitua ` matrix.example.org<hostname>` pelo nome do host que deve apresentar o certificado e utilize a sua porta de federação real. A porta 8448 é comum, mas um proxy reverso ou um servidor delegado pode usar outra porta.

openssl s_client -connect matrix.example.org:8448 \
  -servername matrix.example.org -showcerts </dev/null

Essa -servernameopção envia SNI (Server Name Indication), permitindo que um proxy virtual escolha o certificado para o nome solicitado. Verifique a saída para confirmar se a verificação foi bem-sucedida e, em seguida, inspecione o assunto e as datas de validade do certificado.

openssl s_client -connect matrix.example.org:8448 \
  -servername matrix.example.org </dev/null 2>/dev/null | \
  openssl x509 -noout -subject -issuer -dates -ext subjectAltName

O nome usado pela federação Matrix deve corresponder a um nome DNS no Nome Alternativo do Assunto (SAN) do certificado. Verifique também se o certificado está válido e se o endpoint está enviando seus certificados intermediários. Se você usa um proxy reverso, teste o endereço público do proxy: um arquivo de certificado correto no host do Synapse não adianta se o proxy estiver servindo um certificado desatualizado ou inválido.

3. Corrija o certificado que o Synapse fornece.

Se o testador reportar um problema de certificado para o seu servidor, renove ou emita um novo certificado para o nome de host da federação e configure o endpoint TLS público para servir a cadeia completa. O manual de configuração atual do Synapse especifica que o tls_certificate_pathendereço IP deve apontar para um certificado PEM que inclua certificados intermediários; para o Certbot, use `<nome_do_certificado>` fullchain.pem, e não `<nome_do_certificado> cert.pem`. Mantenha a chave privada em um tls_private_key_patharquivo separado e proteja-a contra acesso público.

Quando o TLS for encerrado no Nginx, Caddy ou outro proxy reverso, atualize o certificado e a cadeia de certificados na configuração desse proxy e, em seguida, recarregue o proxy usando o método apropriado para sua instalação. Os caminhos de certificado TLS do próprio Synapse podem não controlar o certificado visto pelos pares da federação nessa configuração. Siga a documentação oficial do proxy reverso do Synapse para a configuração do listener e do proxy que você utiliza.

Verifique também a descoberta de servidores DNS e Matrix. A federação pode resolver o nome do seu servidor diretamente ou seguir uma /.well-known/matrix/serverdelegação para um nome de host e porta diferentes. O certificado deve ser válido para o nome de host alcançado por essa rota de descoberta. Um registro DNS desatualizado ou uma delegação incorreta podem direcionar os pares para um endpoint que apresenta um certificado não relacionado.

4. Reparar a confiança de saída para uma federação privada

Se o certificado com falha pertencer a um servidor doméstico remoto em uma rede privada, confirme primeiro se o certificado foi emitido intencionalmente por sua autoridade de certificação (CA) privada. Instale e mantenha essa CA no host do Synapse, sempre que possível. O Synapse também oferece federation_custom_ca_listsuporte a certificados de CA personalizados usados ​​para federação. Essa opção espera arquivos PEM e substitui a lista de CAs fornecida pelo sistema operacional; portanto, inclua todas as CAs necessárias para sua implementação, em vez de adicionar apenas uma CA privada indiscriminadamente.

federation_custom_ca_list:
  - /etc/matrix-synapse/certs/private-root-ca.pem

Defina o caminho para um certificado de CA, não para a chave privada do servidor. Certifique-se de que o processo do Synapse possa lê-lo, valide a indentação do YAML e reinicie ou recarregue o Synapse de acordo com o seu método de implantação. O manual de configuração do Synapse indica que esta opção normalmente se destina a redes domésticas privadas.

Não configure federation_verify_certificates: falsepara silenciar um erro de federação pública. O padrão é desativado true; desativá-lo remove a verificação de certificado para federação de saída e enfraquece a proteção contra falsificação de identidade. O recurso separado federation_certificate_verification_whitelistexiste para casos específicos e restritos, como serviços ocultos do Tor ou configurações privadas controladas, e não como um substituto para reparar um certificado público. Para infraestrutura privada, uma Autoridade Certificadora (CA) privada confiável é geralmente preferível.

5. Verifique o tempo e repita o teste.

Se as datas dos certificados parecerem inválidas mesmo que o certificado esteja vigente, verifique o relógio do sistema e a sincronização de horário no host do Synapse e em qualquer proxy. Um relógio significativamente desatualizado pode fazer com que um certificado válido pareça inválido ou expirado. Confirme também se a renovação automática realmente atualizou o arquivo disponibilizado publicamente; a renovação do certificado em disco não garante que um proxy o tenha recarregado.

Após a correção, execute novamente o Federation Tester e repita a conexão que falhou. Confirme se o testador reconhece o nome do host esperado, datas válidas e uma cadeia de confiança, e verifique os logs do Synapse em busca de novas tentativas de federação sem o erro de verificação de certificado. Se o testador for aprovado, mas um servidor remoto ainda falhar, capture o nome desse servidor, o carimbo de data/hora e a entrada de log relevante (com informações sensíveis removidas): o certificado ou o ambiente de confiança do servidor podem ser a causa do problema. Não compartilhe chaves privadas, tokens de acesso ou conteúdo de mensagens de usuários durante a solução de problemas.

Deixar um comentário

Resolver erros de permissão de administrador de salas Matrix por meio de ação

Rastreie a variável de ambiente M_FORBIDDEN até os níveis de poder da sala, a associação ou o acesso de administrador do servidor Synapse e, em seguida, restaure apenas a permissão necessária para a ação bloqueada.

Torne seu servidor Matrix Synapse acessível para federação.

Torne seu servidor Matrix Synapse acessível para federação.

Configure a descoberta do Synapse, o HTTPS e o roteamento de proxy para que outros servidores domésticos Matrix possam encontrar e contatar o seu servidor.

Conecte o Element Web ao Keycloak por meio do OIDC do Synapse.

Configure um cliente OIDC Keycloak e um provedor Synapse para que os usuários do Element Web possam fazer login por meio do seu servidor de identidade sem expor segredos do cliente.

Configure o backup e a assinatura cruzada da chave do elemento com segurança.

Configure o backup e a assinatura cruzada da chave do elemento com segurança.

Salve uma chave de recuperação, verifique suas sessões do Element e certifique-se de que as chaves de mensagens criptografadas possam ser restauradas sem confundir o backup com a senha da sua conta.

Pare as falhas de memória do Matrix Synapse durante a sincronização do cliente.

Diagnosticar falhas de falta de memória do Synapse durante a sincronização, ajustar o cache com segurança, identificar atrasos nas solicitações e verificar o uso estável da memória.

Resolver erros de certificado TLS da Synapse Federation

Rastreie falhas de certificado de federação do Trace Matrix para o servidor correto, repare a cadeia TLS ou a confiança da CA e verifique a correção sem desativar as verificações de segurança.

Coloque um servidor Synapse Matrix atrás do Cloudflare com segurança.

Coloque um servidor Synapse Matrix atrás do Cloudflare com segurança.

Os clientes do Route Matrix e a federação através do Cloudflare em HTTPS 443 preservam a descoberta do Synapse e evitam o armazenamento em cache do tráfego da API ou a interrupção de uploads de mídia.

Restaure o Matrix Synapse com segurança usando um dump do PostgreSQL.

Faça backup do Synapse com pg_dump, proteja sua chave de assinatura e mídia e restaure-o em um banco de dados PostgreSQL limpo, sem reutilizar chaves de uso único obsoletas.

Execute o Mjölnir como um bot de moderação de salas Matrix com Docker.

Execute o Mjölnir como um bot de moderação de salas Matrix com Docker.

Configure o Mjölnir com uma conta Matrix dedicada, sala de gerenciamento criptografada, Docker Compose, lista de políticas e verificações de permissão.

Ative a sincronização deslizante nativa da matriz para um carregamento mais rápido em dispositivos móveis.

Ative a sincronização deslizante nativa da matriz para um carregamento mais rápido em dispositivos móveis.

Ignore o proxy descontinuado e configure a Sincronização Deslizante integrada do Synapse. Verifique a descoberta de clientes e, em seguida, meça o carregamento da lista de salas e o comportamento de reconexão em um telefone compatível.