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.