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.
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.
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ą.
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.
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_pathmusi 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.
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.
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.
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.
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.
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.
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.
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.
Ś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.
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.
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.
Skonfiguruj Mjölnir przy użyciu dedykowanego konta Matrix, szyfrowanego pokoju zarządzania, Docker Compose, listy zasad i kontroli uprawnień.
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.