Posizionare un server Synapse Matrix dietro Cloudflare in modo sicuro

Per posizionare un server Synapse Matrix dietro il proxy standard orange-cloud di Cloudflare, è necessario instradare sia il traffico API client che quello di federazione in entrata tramite HTTPS sulla porta 443. Mantenere TLS abilitato da Cloudflare verso il server di origine con autenticazione Full (rigorosa), instradare i percorsi di Matrix a Synapse senza modifiche, pubblicare il rilevamento della federazione che punta al nome host sulla porta 443 e ignorare la cache sui percorsi API. Non puntare un normale record proxy alla porta di federazione predefinita di Matrix, la 8448: il proxy standard di Cloudflare non elenca tale porta tra quelle supportate.

Verifica che la configurazione 443 sia compatibile con il tuo server.

Questo esempio presuppone che Synapse sia in esecuzione dietro un reverse proxy come Nginx, Caddy o Traefik. Synapse può rimanere sulla sua rete Docker privata sulla porta HTTP 8008; il proxy front-end gestisce il TLS pubblico. La federazione può utilizzare HTTPS sulla porta 443 quando il rilevamento indirizza i server remoti a tale porta. Synapse supporta la porta 443 come alternativa alla porta predefinita 8448, mentre Cloudflare elenca la 443 ma non la 8448 tra le sue porte proxy standard. Consultare le linee guida sulle porte di Synapse e l'elenco delle porte supportate da Cloudflare .

Utilizza questo approccio quando i client e la federazione devono condividere un nome host HTTPS con proxy. Se devi mantenere la federazione sulla porta 8448, utilizza un record solo DNS o un prodotto Cloudflare che supporti tale porta TCP. L'esempio utilizza example.orgper ID Matrix come @alice:example.orge matrix.example.orgper Synapse. Sostituisci i tuoi nomi host, ma mantieni quello esistente per Synapse server_name; la sua modifica modifica gli ID Matrix degli utenti.

Configurare DNS, TLS e il proxy inverso

1. Eseguire il proxy solo per i nomi host HTTP(S)

In Cloudflare DNS, imposta il record A/AAAA matrix.example.orgsull'indirizzo pubblico del tuo proxy inverso e contrassegnalo come Proxied. Il example.orgnome host deve inoltre raggiungere un server web per i file di discovery. Rimuovi i record AAAA inutilizzabili. Mantieni i record MX, mail-only e non-HTTP come solo DNS. Cloudflare termina la connessione TLS al suo confine e apre una connessione separata al tuo server di origine.

Una tabella schematica dei record DNS mostra i record A proxy per example.org e matrix.example.org, con icone di stato a forma di nuvola arancione.
Fungere da proxy per l'host web Matrix e per il nome host utilizzato per il discovery; conservare i record di posta solo tramite DNS.

Nelle impostazioni SSL/TLS di Cloudflare, seleziona "Completo (rigoroso)". Il proxy di origine deve accettare HTTPS sulla porta 443 e presentare un certificato valido e corrispondente , rilasciato da un'autorità di certificazione attendibile o dalla CA di origine di Cloudflare. Questo crittografa e convalida entrambe le connessioni; la modalità "Flessibile" può lasciare la connessione di origine non crittografata o causare loop di reindirizzamento. Consulta la guida alla configurazione "Completo (rigoroso)"matrix.example.org di Cloudflare .

2. Invia le richieste Matrix a Synapse senza riscriverle

Configura l'host virtuale HTTPS del proxy inverso per matrix.example.orginoltrare i percorsi che iniziano con /_matrixe /_synapse/clienta Synapse sulla rete privata, solitamente http://synapse:8008in Compose. Mantieni il percorso completo della richiesta, inoltra l'Host originale e imposta X-Forwarded-Fore X-Forwarded-Proto. Queste route includono le chiamate API del client e gli endpoint di federazione; evita di inviare solo la home page del browser a Synapse o di rimuovere il prefisso del percorso.

Un editor generico di configurazione del reverse proxy mostra i percorsi API di Matrix inoltrati a Synapse sulla porta 8008 e l'intestazione X-Forwarded-Proto.
Inoltra entrambe le famiglie di percorsi API Matrix a Synapse e conserva il percorso della richiesta e le intestazioni di inoltro.

Nel listener HTTP esistente di Synapse, impostalo x_forwarded: truein modo che legga l'indirizzo e lo schema del client dal proxy. Non associare un listener containerizzato a , poiché ciò impedisce ad altri container di raggiungerlo. Mantieni la porta 8008 privata per Compose. Consulta le istruzioni per il reverse proxy127.0.0.1 di Synapse per la sintassi del tuo proxy specifico.

Pubblica Discovery e impedisci la memorizzazione nella cache delle API

3. Indica agli altri server domestici di utilizzare la porta 443

Poiché gli ID Matrix degli utenti vengono utilizzati example.orgquando Synapse viene raggiunto all'indirizzo matrix.example.org, viene fornito un file di rilevamento della federazione all'indirizzo https://example.org/.well-known/matrix/server. Restituisce lo stato 200, il contenuto JSON e questo valore:

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

L'opzione esplicita :443invia i server remoti alla porta proxy supportata. La specifica della federazione Matrix definisce questa m.serverdelega. Se il nome del server Synapse è matrix.example.org, servi il file noto corrispondente su tale server oppure utilizza serve_server_wellknownl'opzione di Synapse quando tale nome host instrada a Synapse sulla porta 443.

Per il rilevamento automatico dei client, utilizzare https://example.org/.well-known/matrix/client. {"m.homeserver":{"base_url":"https://matrix.example.org"}}I client browser necessitano anche delle intestazioni CORS richieste dalla specifica client-server Matrix . Impostare Synapse public_baseurlsull'URL HTTPS che gli utenti devono inserire. Consultare la specifica di rilevamento del server Matrix e il riferimento alla configurazione di Synapse .

Un editor JSON visualizza la delega del m.server di federazione a matrix.example.org sulla porta 443 e l'URL di base del server home del client.
Eseguire la delega di federazione sul dominio Matrix ID e indirizzare i client all'URL del server principale HTTPS.

4. Ignora la cache ed evita le richieste di assistenza del browser sui percorsi di protocollo

Crea una regola di cache per matrix.example.orgi percorsi corrispondenti che iniziano con /_matrix/o /_synapse/client/e seleziona "Ignora cache" . Questo protegge le API di login, sincronizzazione, federazione e multimediali dalle regole personalizzate che memorizzano tutto nella cache. Controlla anche le regole WAF, bot e di reindirizzamento: i client Matrix non possono risolvere le sfide interstitial del browser. Mantieni le protezioni abilitate e limita l'ambito di qualsiasi eccezione ai percorsi del protocollo. Cloudflare descrive l'opzione di ignorare la cache nelle istruzioni del suo pannello di controllo .

Verifica dall'esterno della tua rete

Esegui questi controlli da una macchina esterna alla LAN del server, in modo che la richiesta segua i DNS pubblici e Cloudflare:

Un terminale mostra i controlli curl per il file noto della federazione Matrix e l'endpoint delle versioni del client Synapse.
Verifica la scoperta pubblica della federazione e l'API client tramite il nome host di 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

Conferma che la prima richiesta restituisca JSON con m.serverimpostato su matrix.example.org:443, che il file client nomini l'URL base HTTPS e che le ultime due restituiscano JSON valido anziché una pagina di verifica di Cloudflare, un errore 404 o un errore 502. Quindi accedi da un client e testa la sincronizzazione di una stanza, carica un file e federati con una stanza su un altro homeserver. I server Matrix memorizzano nella cache le risposte di rilevamento della federazione, quindi i server remoti potrebbero conservare un valore precedente per un certo periodo di tempo dopo la modifica; utilizza le intestazioni della cache della risposta e attendi che i record memorizzati nella cache scadano.

Se il caricamento dei file fallisce con HTTP 413, confronta la dimensione del file con il limite di caricamento corrente della zona Cloudflare e con quello di Synapse max_upload_size; anche il reverse proxy ha un proprio limite per il corpo della richiesta. Il valore predefinito documentato di Synapse è di 50 MB, mentre il limite predefinito di Nginx può essere inferiore. I limiti di Cloudflare variano a seconda del piano e possono essere modificati all'interno delle regole del piano, quindi controlla la documentazione relativa al limite di caricamento corrente prima di aumentare il limite di Synapse. Se l'API funziona ma la federazione fallisce, verifica innanzitutto che l'URL noto del server sia pubblico, che il certificato del nome host sia valido e che la porta delegata sia esplicitamente la 443. Se mantieni intenzionalmente la porta 8448, interrompi il proxy di quel record tramite il proxy DNS standard di Cloudflare e utilizza invece un nome host di federazione diretto solo DNS.

Lascia un commento

Risolvi gli errori di autorizzazione amministrativa della stanza Matrix tramite azione

Individuare la causa di M_FORBIDDEN, che può essere ricondotta ai livelli di alimentazione della stanza, all'iscrizione dei membri o all'accesso di amministratore al server Synapse, quindi ripristinare solo l'autorizzazione necessaria per l'azione bloccata.

Rendi il tuo server Matrix Synapse raggiungibile per la federazione

Rendi il tuo server Matrix Synapse raggiungibile per la federazione

Configura il rilevamento Synapse, HTTPS e il routing proxy in modo che gli altri homeserver Matrix possano trovare e contattare il tuo server.

Connetti Element Web a Keycloak tramite Synapse OIDC

Configura un client OIDC Keycloak e un provider Synapse in modo che gli utenti di Element Web possano accedere tramite il tuo server di identità senza esporre le credenziali del client.

Configura in modo sicuro il backup e la firma incrociata delle chiavi Element.

Configura in modo sicuro il backup e la firma incrociata delle chiavi Element.

Salva una chiave di ripristino, verifica le tue sessioni Element e controlla che le chiavi dei messaggi crittografati possano essere ripristinate senza confondere il backup con la password del tuo account.

Rimuovi i crash di memoria di Matrix Synapse durante la sincronizzazione del client

Diagnostica gli errori di memoria insufficiente di Synapse durante la sincronizzazione, regola la cache in modo sicuro, identifica i ritardi nelle richieste e verifica un utilizzo stabile della memoria.

Risolvere gli errori del certificato TLS di Synapse Federation

Individuare gli errori del certificato di federazione Matrix sul server corretto, riparare la catena TLS o la relazione di fiducia con la CA e verificare la correzione senza disabilitare i controlli di sicurezza.

Posizionare un server Synapse Matrix dietro Cloudflare in modo sicuro

Posizionare un server Synapse Matrix dietro Cloudflare in modo sicuro

Instrada i client Matrix e la federazione tramite Cloudflare su HTTPS 443, preserva il rilevamento di Synapse ed evita la memorizzazione nella cache del traffico API o l'interruzione del caricamento dei file multimediali.

Ripristinare Matrix Synapse in modo sicuro con un dump di PostgreSQL

Esegui il backup di Synapse con pg_dump, proteggi la chiave di firma e i supporti di memorizzazione e ripristina il tutto in un database PostgreSQL pulito senza riutilizzare chiavi monouso obsolete.

Esegui Mjölnir come bot di moderazione per le stanze Matrix con Docker

Esegui Mjölnir come bot di moderazione per le stanze Matrix con Docker

Configura Mjölnir con un account Matrix dedicato, una sala di gestione crittografata, Docker Compose, un elenco di policy e controlli di autorizzazione.

Attiva la sincronizzazione nativa dello scorrimento della matrice per un caricamento più rapido sui dispositivi mobili.

Attiva la sincronizzazione nativa dello scorrimento della matrice per un caricamento più rapido sui dispositivi mobili.

Ignora il proxy obsoleto e configura Sliding Sync, la funzione integrata di Synapse. Verifica il rilevamento dei client, quindi misura il caricamento dell'elenco delle stanze e il comportamento di riconnessione su un telefono compatibile.