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

Para colocar um servidor Synapse Matrix atrás do proxy padrão orange-cloud do Cloudflare, envie o tráfego da API do cliente e o tráfego de federação de entrada por HTTPS na porta 443. Mantenha o TLS habilitado do Cloudflare para sua origem com Full (strict), direcione os caminhos do Matrix inalterados para o Synapse, publique a descoberta de federação apontando para o seu hostname na porta 443 e ignore o cache nos caminhos da API. Não aponte um registro proxy normal para a porta de federação padrão do Matrix, 8448: o proxy padrão do Cloudflare não lista essa porta como compatível.

Verifique se a configuração da porta 443 é compatível com o seu servidor.

Este exemplo pressupõe que o Synapse esteja sendo executado atrás de um proxy reverso, como Nginx, Caddy ou Traefik. O Synapse pode permanecer em sua rede Docker privada na porta HTTP 8008; o proxy frontal lida com o TLS público. A federação pode usar HTTPS na porta 443 quando a descoberta apontar servidores remotos para ela. O Synapse oferece suporte à porta 443 como alternativa à porta padrão 8448, enquanto o Cloudflare lista a porta 443, mas não a 8448, entre suas portas de proxy padrão. Consulte as diretrizes de portas do Synapse e a lista de portas suportadas do Cloudflare .

Use essa abordagem quando clientes e federação precisarem compartilhar um nome de host HTTPS proxy. Se você precisar manter a federação na porta 8448, use um registro somente DNS ou um produto Cloudflare que suporte essa porta TCP. O exemplo usa example.orgIDs do Matrix como `< nome_do_usuário>` @alice:example.orge ` matrix.example.org<nome_do_usuário>` para o Synapse. Substitua os nomes de host pelos seus, mas mantenha o `<nome_do_usuário>` existente do Synapse server_name; alterá-lo modifica os IDs do Matrix dos usuários.

Configure o DNS, o TLS e o proxy reverso.

1. Faça o proxy apenas para os nomes de host HTTP(S)

No DNS da Cloudflare, configure o registro A/AAAA para matrix.example.orgo endereço público do seu proxy reverso e marque-o como "Proxyed" (Proxy). O example.orgnome do host também deve ser acessível por um servidor web para os arquivos de descoberta. Remova registros AAAA inutilizáveis. Mantenha os registros MX, somente para e-mail e não HTTP como "DNS only" (somente DNS). A Cloudflare encerra o TLS na borda da rede e abre uma conexão separada com o seu servidor de origem.

Uma tabela esquemática de registros DNS mostra os registros A proxy para example.org e matrix.example.org, com ícones de status em forma de nuvem laranja.
Utilize um proxy para o host web da Matrix e o nome de host que serve para a descoberta; mantenha os registros de e-mail somente em DNS.

Nas configurações de SSL/TLS do Cloudflare, selecione Completo (estrito). O proxy de origem deve aceitar HTTPS na porta 443 e apresentar um certificado válido correspondente , emitido por uma autoridade confiável ou pela Autoridade Certificadora de Origem do Cloudflare. Isso criptografa e valida ambas as partes da conexão; o modo Flexível pode deixar a conexão de origem sem criptografia ou causar loops de redirecionamento. Consulte o guia de configuração Completo (estrito)matrix.example.org do Cloudflare .

2. Encaminhe as solicitações do Matrix para o Synapse sem reescrevê-las.

Configure o host virtual HTTPS do proxy reverso para matrix.example.orgencaminhar caminhos que começam com `/` /_matrixe /_synapse/client`/` para o Synapse na rede privada, geralmente http://synapse:8008no Compose. Preserve o caminho completo da solicitação, encaminhe o Host original e defina `/` X-Forwarded-Fore ` X-Forwarded-Proto/`. Essas rotas incluem chamadas de API do cliente e endpoints de federação; evite enviar apenas a página inicial do navegador para o Synapse ou remover o prefixo do caminho.

Um editor de configuração de proxy reverso genérico mostra os caminhos da API Matrix encaminhados para o Synapse na porta 8008 e o cabeçalho X-Forwarded-Proto.
Encaminhe ambas as famílias de caminhos da API Matrix para o Synapse, preservando o caminho da solicitação e os cabeçalhos de encaminhamento.

No listener HTTP existente do Synapse, configure x_forwarded: true-o para ler o endereço e o esquema do cliente a partir do proxy. Não vincule um listener em contêiner a `http:// 127.0.0.1localhost:8008`, pois isso impede que outros contêineres o acessem. Mantenha a porta 8008 privada para o Compose. Consulte as instruções de proxy reverso do Synapse para obter a sintaxe do seu proxy específico.

Publicar descoberta e impedir o cache da API

3. Configure outros servidores domésticos para usar a porta 443.

Como os IDs do Matrix dos usuários são usados example.org​​enquanto o Synapse é acessado em matrix.example.org, forneça um arquivo de descoberta de federação em https://example.org/.well-known/matrix/server. Retorne o status 200, o conteúdo JSON e este valor:

{"m.server":"matrix.example.org:443"}

O encaminhamento explícito :443direciona os servidores domésticos remotos para a porta proxy compatível. A especificação de federação Matrix define essa m.serverdelegação. Se o próprio nome do servidor Synapse for ` <nome_do_servidor> matrix.example.org`, sirva o arquivo conhecido correspondente nesse local ou use serve_server_wellknowna opção `<nome_do_servidor>` do Synapse quando esse nome de host rotear para o Synapse na porta 443.

Para a descoberta automática de clientes, utilize o parâmetro `--server- https://example.org/.well-known/matrix/clientaddress` {"m.homeserver":{"base_url":"https://matrix.example.org"}}. Os navegadores também precisam dos cabeçalhos CORS exigidos pela especificação cliente-servidor do Matrix . Defina o parâmetro `--server-address` do Synapse public_baseurlpara a URL HTTPS que os usuários devem inserir. Consulte a especificação de descoberta de servidor do Matrix e a referência de configuração do Synapse .

Um editor JSON exibe a delegação do servidor m.server da federação para matrix.example.org na porta 443 e a URL base do servidor doméstico do cliente.
Configure a delegação de federação no domínio do ID da Matrix e direcione os clientes para o URL do servidor HTTPS.

4. Ignorar o cache e evitar desafios do navegador nos caminhos do protocolo.

Crie uma regra de cache para matrix.example.orgcaminhos correspondentes que começam com ` /_matrix//` ou `/` /_synapse/client/, e selecione "Ignorar cache" . Isso protege as APIs de login, sincronização, federação e mídia de regras personalizadas que armazenam tudo em cache. Verifique também as regras de WAF, bot e redirecionamento: os clientes Matrix não conseguem resolver os desafios de intersticiais do navegador. Mantenha as proteções ativadas e limite qualquer exceção aos caminhos de protocolo. O Cloudflare descreve como ignorar o cache nas instruções do painel de controle .

Verifique de fora da sua rede.

Execute essas verificações a partir de uma máquina fora da LAN do servidor, para que a solicitação siga o DNS público e o Cloudflare:

Um terminal exibe verificações curl para o arquivo conhecido de federação Matrix e o endpoint de versões do cliente Synapse.
Verifique a descoberta de federação pública e a API do cliente por meio do nome de host do Cloudflare.
curl -i https://example.org/.well-known/matrix/server
curl -i https://example.org/.well-known/matrix/client
curl -i https://matrix.example.org/_matrix/client/versions
curl -i https://matrix.example.org/_matrix/federation/v1/version

Confirme se a primeira solicitação retorna JSON com m.server`set to` matrix.example.org:443, se o nome do arquivo do cliente contém a URL base HTTPS e se as duas últimas retornam JSON válido em vez de uma página de desafio do Cloudflare, erro 404 ou 502. Em seguida, faça login em um cliente e teste a sincronização de uma sala, carregue um arquivo e federe com uma sala em outro servidor doméstico. Os servidores Matrix armazenam em cache as respostas de descoberta de federação; portanto, os servidores remotos podem reter um valor anterior por algum tempo após a alteração. Use os cabeçalhos de cache da resposta e aguarde o tempo necessário para que os registros em cache expirem.

Se o envio de arquivos falhar com HTTP 413, compare o tamanho do arquivo com o limite de upload atual da zona do Cloudflare e com o do Synapse max_upload_size; o proxy reverso também tem seu próprio limite de corpo de requisição. O padrão documentado do Synapse é de 50 MB, e o limite padrão do corpo da requisição do Nginx pode ser menor. Os limites do Cloudflare variam de acordo com o plano e podem ser ajustados nas regras do plano, portanto, verifique a documentação atual sobre limites de upload antes de aumentar o limite do Synapse. Se a API funcionar, mas a federação falhar, verifique primeiro se a URL conhecida do servidor é pública, se o certificado do hostname é válido e se a porta delegada é explicitamente a 443. Se você mantiver intencionalmente a porta 8448, pare de usar o proxy DNS padrão do Cloudflare para esse registro e use um hostname de federação somente com DNS direto.

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.