Când jurnalele Matrix Synapse apar SSL: CERTIFICATE_VERIFY_FAILEDîn timpul federației, o asociere se poate bloca, un server la distanță poate respinge conexiunea sau mesajele pot să nu ajungă. Mai întâi, determinați ce certificat eșuează: certificatul unui server la distanță în timpul unei solicitări de ieșire sau certificatul propriului punct final de federație atunci când se conectează un alt server. Apoi, reparați lanțul de certificate, numele de gazdă sau configurația de încredere pe care le identifică jurnalul și un test de federație. Nu dezactivați verificarea TLS ca soluție generală.
Traficul Matrix de la server la server utilizează HTTPS, iar specificația Matrix impune ca destinația să prezinte un certificat TLS semnat de o autoritate de certificare recunoscută. O eroare de verificare înseamnă de obicei că certificatul prezentat este expirat, incomplet, emis pentru un nume de gazdă diferit sau semnat de o autoritate de certificare în care serverul de conectare nu are încredere. Un proxy invers poate, de asemenea, să ofere un certificat greșit, chiar și atunci când configurația proprie a Synapse pare corectă.
1. Identificați partea cu probleme înainte de a modifica configurația
Verificați intrarea din jurnalul Synapse legată de eroare și notați numele serverului la distanță și eroarea exactă a certificatului. Dacă Synapse raportează eroarea în timp ce face o solicitare către un alt server principal, certificatul serverului la distanță sau trustul CA utilizat de procesul Synapse este implicat. Dacă alte servere nu se pot federa cu domeniul dvs., inspectați în schimb endpoint-ul TLS public și descoperirea serverului.
Confirmați numele serverului Matrix de la homeserver.yaml, în special server_name. Aceasta este porțiunea de domeniu a ID-urilor Matrix locale și determină modul în care alte servere de acasă vă ajung. Nu îl confundați cu numele de gazdă intern al mașinii sau containerului. Documentația actuală de instalare Synapse explică faptul că numele serverului este o identitate de federație și recomandă alegerea acestuia înainte de instalare.
2. Testați certificatul public și ruta de federație
Folosește Matrix Federation Tester cu numele serverului tău Matrix. Acesta verifică descoperirea federației și conectivitatea și poate dezvălui dacă certificatul sau rutarea vizibilă extern eșuează. Remediază elementul pe care îl identifică înainte de a ajusta setările de încredere pentru ieșire ale Synapse.
De pe o mașină care poate ajunge la endpoint-ul federației, inspectați certificatul TLS. Înlocuiți-l matrix.example.orgcu numele de gazdă care ar trebui să prezinte certificatul și utilizați portul federației reale. Portul 8448 este comun, dar un proxy invers sau un server delegat poate utiliza un alt port.
openssl s_client -connect matrix.example.org:8448 \
-servername matrix.example.org -showcerts </dev/null
Opțiunea -servernametrimite SNI (Server Name Indication), astfel încât un proxy găzduit virtual poate alege certificatul pentru numele solicitat. Verificați rezultatul pentru o verificare reușită, apoi inspectați subiectul și datele de valabilitate ale certificatului:
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
Numele utilizat de federația Matrix trebuie să corespundă unui nume DNS din Numele alternativ al subiectului certificatului. De asemenea, verificați dacă certificatul este valid în prezent și dacă endpoint-ul trimite certificatele sale intermediare. Dacă utilizați un proxy invers, testați adresa proxy publică: un fișier de certificat corect pe gazda Synapse nu ajută dacă proxy-ul servește un certificat învechit sau fără legătură.
3. Remediați certificatul pe care Synapse îl servește
Dacă testerul raportează o problemă cu certificatul pentru serverul dvs., reînnoiți sau emiteți din nou certificatul pentru numele de gazdă al federației și configurați endpoint-ul public TLS pentru a deservi întregul lanț. Manualul de configurare actual al Synapse specifică faptul că tls_certificate_pathtrebuie să indice către un certificat PEM care include certificate intermediare; pentru Certbot, utilizați fullchain.pem, nu cert.pem. Păstrați cheia privată într-un tls_private_key_pathfișier separat și protejați-o de accesul public.
Când TLS se termină la Nginx, Caddy sau alt proxy invers, actualizați certificatul și lanțul în configurația proxy-ului respectiv, apoi reîncărcați proxy-ul folosind metoda corespunzătoare instalării dvs. Este posibil ca propriile căi de certificat TLS ale Synapse să nu controleze certificatul văzut de colegii de federație în acest aranjament. Urmați documentația oficială a proxy-ului invers Synapse pentru configurarea listener-ului și a proxy-ului pe care le utilizați.
Verificați și DNS și Matrix server discovery. Federarea poate rezolva direct numele serverului sau poate urma o /.well-known/matrix/serverdelegare către un nume de gazdă și un port diferit. Certificatul trebuie să fie valid pentru numele de gazdă atins de acea rută de descoperire. O înregistrare DNS învechită sau o delegare incorectă poate direcționa colegii către un endpoint care prezintă un certificat fără legătură.
4. Repararea încrederii de ieșire pentru o federație privată
Dacă certificatul defect aparține unui server de acasă la distanță dintr-o rețea privată, confirmați mai întâi că certificatul este emis intenționat de autoritatea de certificare (CA) privată. Instalați și întrețineți CA-ul respectiv pe gazda Synapse atunci când este posibil. Synapse oferă, de asemenea, federation_custom_ca_listcertificate CA personalizate utilizate pentru federație. Opțiunea așteaptă fișiere PEM și înlocuiește lista CA furnizată de sistemul de operare, așadar includeți fiecare CA de care are nevoie implementarea dvs., în loc să adăugați orbește un singur CA privat.
federation_custom_ca_list:
- /etc/matrix-synapse/certs/private-root-ca.pem
Setați calea către un certificat CA, nu cheia privată a serverului. Asigurați-vă că procesul Synapse îl poate citi, validați indentarea YAML și reporniți sau reîncărcați Synapse în funcție de metoda de implementare. Manualul de configurare Synapse precizează că această opțiune este destinată în mod normal rețelelor de servere private.
Nu setați federation_verify_certificates: falsepentru a silenționa o eroare de federație publică. Implicit este true; dezactivarea elimină verificarea certificatului pentru federația de ieșire și slăbește protecția împotriva uzurpării identității. Separarea federation_certificate_verification_whitelistexistă pentru cazuri specifice, restrânse, cum ar fi serviciile ascunse Tor sau configurațiile private controlate, nu ca un substitut pentru repararea unui certificat public. Pentru infrastructura privată, o CA privată de încredere este în general preferabilă.
5. Verificați timpul și retestați
Dacă datele certificatelor par invalide, chiar dacă certificatul este actual, verificați ceasul sistemului și sincronizarea orei pe gazda Synapse și pe orice proxy. Un ceas substanțial greșit poate face ca un certificat valid să pară nevalid sau expirat. De asemenea, confirmați că automatizarea reînnoirii a actualizat fișierul difuzat public; reînnoirea certificatului pe disc nu garantează că un proxy l-a reîncărcat.
După corecție, rulați din nou Federation Tester și repetați conexiunea care a eșuat. Confirmați că testerul vede numele de gazdă așteptat, datele valide și un lanț de încredere și verificați jurnalele Synapse pentru noi încercări de federare fără eroarea de verificare a certificatului. Dacă testerul reușește, dar un server la distanță încă eșuează, capturați numele serverului respectiv, marcajul temporal și intrarea relevantă din jurnal igienizată: propriul certificat sau mediul de încredere ar putea fi problema rămasă. Nu partajați chei private, token-uri de acces sau conținutul mesajelor utilizatorului în timpul depanării.