Rozwiązywanie błędów certyfikatu TLS federacji Synapse

Gdy logi Matrix Synapse wyświetlają się SSL: CERTIFICATE_VERIFY_FAILEDpodczas federacji, dołączanie może się zatrzymać, serwer zdalny może odrzucić połączenie lub wiadomości mogą nie dotrzeć. Najpierw określ, który certyfikat jest nieaktualny: certyfikat serwera zdalnego podczas żądania wychodzącego, czy certyfikat Twojego punktu końcowego federacji podczas łączenia się z innym serwerem. Następnie napraw łańcuch certyfikatów, nazwę hosta lub konfigurację zaufania, które identyfikują logi i test federacji. Nie wyłączaj weryfikacji TLS jako ogólnego rozwiązania.

Ruch między serwerami w sieci Matrix wykorzystuje protokół HTTPS, a specyfikacja Matrix wymaga, aby odbiorca przedstawił certyfikat TLS podpisany przez uznany urząd certyfikacji. Błąd weryfikacji zazwyczaj oznacza, że ​​przedstawiony certyfikat jest wygasły, niekompletny, wydany dla innej nazwy hosta lub podpisany przez urząd certyfikacji, któremu serwer łączący się z serwerem nie ufa. Odwrotny serwer proxy może również dostarczyć niewłaściwy certyfikat, nawet jeśli konfiguracja Synapse wydaje się poprawna.

1. Przed zmianą konfiguracji zidentyfikuj stronę powodującą awarię

Sprawdź wpis w dzienniku Synapse dotyczący awarii i zanotuj nazwę serwera zdalnego oraz dokładny błąd certyfikatu. Jeśli Synapse zgłosi awarię podczas wysyłania żądania do innego serwera domowego, problem dotyczy certyfikatu serwera zdalnego lub zaufania CA używanego przez proces Synapse. Jeśli inne serwery nie mogą połączyć się z Twoją domeną, sprawdź zamiast tego publiczny punkt końcowy TLS i wykrywanie serwerów.

Potwierdź nazwę serwera Matrix homeserver.yaml, zwłaszcza server_name. Jest to część domeny lokalnych identyfikatorów Matrix, która określa sposób, w jaki inne serwery domowe mogą się z Tobą połączyć. Nie należy jej mylić z wewnętrzną nazwą hosta komputera lub kontenera. Aktualna dokumentacja instalacji Synapse wyjaśnia, że ​​nazwa serwera jest tożsamością federacyjną i zaleca jej wybranie przed instalacją.

2. Przetestuj certyfikat publiczny i trasę federacyjną

Użyj narzędzia Matrix Federation Tester z nazwą serwera Matrix. Narzędzie to sprawdza wykrywanie federacji i łączność oraz może wykryć, czy widoczny zewnętrznie certyfikat lub routing nie działają. Napraw zidentyfikowany element przed dostosowaniem ustawień zaufania wychodzącego w Synapse.

Z komputera, który może połączyć się z punktem końcowym federacji, sprawdź certyfikat TLS. Zastąp go matrix.example.orgnazwą hosta, która powinna wyświetlić certyfikat, i użyj rzeczywistego portu federacji. Port 8448 jest powszechny, ale odwrotny serwer proxy lub serwer delegowany może używać innego portu.

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

Opcja -servernamewysyła SNI (Server Name Indication), dzięki czemu wirtualny serwer proxy może wybrać certyfikat dla żądanej nazwy. Sprawdź wynik weryfikacji pod kątem pomyślnego wyniku, a następnie sprawdź temat i datę ważności certyfikatu:

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

Nazwa używana przez federację Matrix musi być zgodna z nazwą DNS w alternatywnej nazwie podmiotu certyfikatu. Sprawdź również, czy certyfikat jest obecnie ważny i czy punkt końcowy wysyła swoje certyfikaty pośrednie. Jeśli używasz odwrotnego serwera proxy, przetestuj publiczny adres proxy: poprawny plik certyfikatu na hoście Synapse nie pomoże, jeśli serwer proxy obsługuje nieaktualny lub niepowiązany certyfikat.

3. Napraw certyfikat obsługiwany przez Synapse

Jeśli tester zgłosi problem z certyfikatem dla Twojego serwera, odnów lub ponownie wydaj certyfikat dla nazwy hosta federacji i skonfiguruj publiczny punkt końcowy TLS tak, aby obsługiwał cały łańcuch. Aktualny podręcznik konfiguracji Synapse określa, że tls_certificate_path​​musi on wskazywać na certyfikat PEM, który zawiera certyfikaty pośrednie; w przypadku Certbota należy użyć fullchain.pem, a nie cert.pem. Przechowuj klucz prywatny w osobnym tls_private_key_pathpliku i chroń go przed dostępem publicznym.

Gdy protokół TLS zostanie zakończony na serwerze Nginx, Caddy lub innym odwrotnym serwerze proxy, zaktualizuj certyfikat i łańcuch w konfiguracji tego serwera proxy, a następnie przeładuj serwer proxy, używając metody odpowiedniej dla instalacji. Własne ścieżki certyfikatów TLS Synapse mogą nie kontrolować certyfikatu widocznego dla równorzędnych serwerów federacji w tym układzie. Postępuj zgodnie z oficjalną dokumentacją odwrotnego serwera proxy Synapse dotyczącą używanego programu nasłuchującego i konfiguracji serwera proxy.

Sprawdź również wykrywanie serwerów DNS i Matrix. Federacja może rozwiązać nazwę serwera bezpośrednio lub skorzystać z /.well-known/matrix/serverdelegacji do innej nazwy hosta i portu. Certyfikat musi być ważny dla nazwy hosta, do której dotarto tą ścieżką wykrywania. Nieaktualny rekord DNS lub nieprawidłowa delegacja mogą kierować komputery do punktu końcowego prezentującego niepowiązany certyfikat.

4. Naprawa zaufania wychodzącego dla federacji prywatnej

Jeśli wadliwy certyfikat należy do zdalnego serwera domowego w sieci prywatnej, należy najpierw upewnić się, że został on celowo wydany przez prywatny urząd certyfikacji (CA). Zainstaluj i utrzymuj ten urząd certyfikacji na hoście Synapse, gdy tylko jest to możliwe. Synapse obsługuje również federation_custom_ca_listniestandardowe certyfikaty CA używane w federacji. Opcja ta wymaga plików PEM i zastępuje listę urzędów certyfikacji dostarczoną przez system operacyjny, dlatego należy uwzględnić wszystkie potrzebne urzędy certyfikacji, zamiast bezmyślnie dodawać tylko jeden prywatny urząd certyfikacji.

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

Ustaw ścieżkę do certyfikatu CA, a nie do klucza prywatnego serwera. Upewnij się, że proces Synapse może go odczytać, sprawdź wcięcie YAML i uruchom ponownie lub przeładuj Synapse zgodnie z metodą wdrożenia. W podręczniku konfiguracji Synapse podano, że ta opcja jest zazwyczaj przeznaczona dla prywatnych sieci serwerów domowych.

Nie ustawiaj federation_verify_certificates: falsewyciszania publicznego błędu federacji. Domyślnie jest to true; wyłączenie tej opcji usuwa weryfikację certyfikatu dla federacji wychodzącej i osłabia ochronę przed podszywaniem się. Oddzielne ustawienie federation_certificate_verification_whitelististnieje w wąskich, specyficznych przypadkach, takich jak ukryte usługi Tor lub kontrolowane konfiguracje prywatne, a nie jako substytut naprawy publicznego certyfikatu. W przypadku infrastruktury prywatnej zazwyczaj preferowany jest zaufany prywatny urząd certyfikacji.

5. Sprawdź czas i powtórz test

Jeśli daty certyfikatu wydają się nieprawidłowe, mimo że certyfikat jest aktualny, należy sprawdzić zegar systemowy i synchronizację czasu na hoście Synapse oraz na dowolnym serwerze proxy. Znacznie błędny zegar może sprawić, że ważny certyfikat będzie wyglądał na nieważny lub wygasły. Należy również sprawdzić, czy automatyzacja odnawiania faktycznie zaktualizowała plik udostępniany publicznie; odnowienie certyfikatu na dysku nie gwarantuje, że serwer proxy go ponownie wczytał.

Po poprawieniu błędu uruchom ponownie narzędzie Federation Tester i powtórz połączenie, które się nie powiodło. Upewnij się, że tester widzi oczekiwaną nazwę hosta, prawidłowe daty i zaufany łańcuch, a następnie sprawdź logi Synapse pod kątem nowych prób federacji bez błędu weryfikacji certyfikatu. Jeśli tester przejdzie pomyślnie, ale jeden serwer zdalny nadal nie zostanie zweryfikowany, przechwyć nazwę tego serwera, znacznik czasu i odpowiedni, zdezynfekowany wpis w dzienniku: problem może nadal leżeć w jego własnym certyfikacie lub środowisku zaufania. Podczas rozwiązywania problemów nie udostępniaj kluczy prywatnych, tokenów dostępu ani treści komunikatów użytkownika.

Zostaw komentarz

Rozwiąż błędy uprawnień administratora pokoju Matrix za pomocą działania

Prześledź M_FORBIDDEN do poziomów mocy pokoju, członkostwa lub dostępu administratora serwera Synapse, a następnie przywróć tylko uprawnienia potrzebne do zablokowanej akcji.

Uczyń swój serwer Matrix Synapse dostępnym dla federacji

Uczyń swój serwer Matrix Synapse dostępnym dla federacji

Skonfiguruj wykrywanie Synapse, protokół HTTPS i routing proxy, aby inne serwery domowe Matrix mogły znaleźć Twój serwer i nawiązać z nim kontakt.

Połącz Element Web z Keycloak przez Synapse OIDC

Skonfiguruj klienta Keycloak OIDC i dostawcę Synapse, aby użytkownicy Element Web mogli logować się za pośrednictwem serwera tożsamości bez ujawniania tajnych danych klienta.

Bezpieczna konfiguracja kopii zapasowej klucza elementu i podpisywania krzyżowego

Bezpieczna konfiguracja kopii zapasowej klucza elementu i podpisywania krzyżowego

Zapisz klucz odzyskiwania, zweryfikuj sesje Element i sprawdź, czy zaszyfrowane klucze wiadomości można odzyskać, nie myląc kopii zapasowej z hasłem do konta.

Zatrzymaj awarię pamięci Matrix Synapse podczas synchronizacji klienta

Diagnozuj błędy braku pamięci w Synapse podczas synchronizacji, bezpiecznie dostosowuj buforowanie, identyfikuj zaległości w żądaniach i weryfikuj stabilne wykorzystanie pamięci.

Rozwiązywanie błędów certyfikatu TLS federacji Synapse

Śledź błędy certyfikatu federacji Matrix na właściwym serwerze, napraw łańcuch TLS lub zaufanie urzędu certyfikacji i zweryfikuj poprawkę bez wyłączania kontroli bezpieczeństwa.

Bezpiecznie umieść serwer Synapse Matrix za Cloudflare

Bezpiecznie umieść serwer Synapse Matrix za Cloudflare

Klienci i federacja Matrix korzystają z usługi Cloudflare na protokole HTTPS 443, zachowując wykrywanie Synapse i unikając buforowania ruchu API lub przerywania przesyłania multimediów.

Bezpieczne przywracanie Matrix Synapse za pomocą zrzutu PostgreSQL

Utwórz kopię zapasową Synapse za pomocą pg_dump, chroń jej klucz podpisu i nośnik, a następnie przywróć do czystej bazy danych PostgreSQL bez ponownego używania nieaktualnych kluczy jednorazowych.

Uruchom Mjölnir jako bota moderującego pokój Matrix za pomocą Dockera

Uruchom Mjölnir jako bota moderującego pokój Matrix za pomocą Dockera

Skonfiguruj Mjölnir przy użyciu dedykowanego konta Matrix, szyfrowanego pokoju zarządzania, Docker Compose, listy zasad i kontroli uprawnień.

Włącz natywną synchronizację Matrix Sliding, aby przyspieszyć ładowanie urządzeń mobilnych

Włącz natywną synchronizację Matrix Sliding, aby przyspieszyć ładowanie urządzeń mobilnych

Pomiń wycofany serwer proxy i skonfiguruj wbudowaną funkcję Sliding Sync w Synapse. Sprawdź wykrywanie klientów, a następnie zmierz ładowanie listy pokoi i zachowanie ponownego łączenia na kompatybilnym telefonie.