Matrix Room-beheerdersrechtenfouten oplossen via actie
Traceer M_FORBIDDEN naar het stroomniveau van de ruimte, het lidmaatschap of de Synapse-serverbeheerderstoegang en herstel vervolgens alleen de machtiging die de geblokkeerde actie nodig heeft.
Wanneer Matrix Synapse-logboeken SSL: CERTIFICATE_VERIFY_FAILEDtijdens de federatie problemen vertonen, kan een verbinding vastlopen, kan een externe server de verbinding weigeren of kunnen berichten niet aankomen. Bepaal eerst welk certificaat niet werkt: het certificaat van een externe server tijdens een uitgaand verzoek, of het certificaat van uw eigen federatie-eindpunt wanneer een andere server verbinding maakt. Herstel vervolgens de certificaatketen, de hostnaam of de vertrouwensconfiguratie die in het logboek en tijdens een federatietest aan het licht zijn gekomen. Schakel TLS-verificatie niet uit als algemene oplossing.
Matrix-serververkeer maakt gebruik van HTTPS en de Matrix-specificatie vereist dat de bestemming een TLS-certificaat presenteert dat is ondertekend door een erkende certificeringsinstantie. Een verificatiefout betekent meestal dat het gepresenteerde certificaat is verlopen, onvolledig is, is uitgegeven voor een andere hostnaam of is ondertekend door een CA die de verbindende server niet vertrouwt. Een reverse proxy kan ook een verkeerd certificaat aanbieden, zelfs als de configuratie van Synapse zelf correct lijkt.
Controleer de Synapse-logboekvermelding rond de fout en noteer de naam van de externe server en de exacte certificaatfout. Als Synapse de fout meldt tijdens een verzoek aan een andere homeserver, ligt het probleem bij het certificaat van de externe server of de CA-vertrouwensrelatie die door uw Synapse-proces wordt gebruikt. Als andere servers geen federatie met uw domein kunnen tot stand brengen, controleer dan uw openbare TLS-eindpunt en serverdetectie.
Controleer de naam van uw Matrix-server, met homeserver.yamlname de domeinnaam server_name. Dit is het domeingedeelte van lokale Matrix-ID's en bepaalt hoe andere homeservers u kunnen bereiken. Verwar dit niet met de interne hostnaam van de machine of container. De huidige Synapse-installatiedocumentatie legt uit dat de servernaam een federatie-identiteit is en adviseert om deze vóór de installatie te kiezen.
Gebruik de Matrix Federation Tester met de naam van uw Matrix-server. Deze tool controleert de federatiedetectie en connectiviteit en kan aantonen of het extern zichtbare certificaat of de routering niet goed werkt. Los het probleem op voordat u de uitgaande vertrouwensinstellingen van Synapse aanpast.
Controleer het TLS-certificaat vanaf een machine die uw federatie-eindpunt kan bereiken. Vervang dit matrix.example.orgdoor de hostnaam die het certificaat zou moeten presenteren en gebruik uw daadwerkelijke federatiepoort. Poort 8448 is gebruikelijk, maar een reverse proxy of gedelegeerde server kan een andere poort gebruiken.
openssl s_client -connect matrix.example.org:8448 \
-servername matrix.example.org -showcerts </dev/null
Deze -servernameoptie verzendt SNI (Server Name Indication), waardoor een virtueel gehoste proxy het certificaat voor de gevraagde naam kan selecteren. Controleer de uitvoer op een succesvol verificatieresultaat en inspecteer vervolgens het onderwerp en de geldigheidsdatum van het certificaat.
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
De naam die door Matrix Federation wordt gebruikt, moet overeenkomen met een DNS-naam in de Subject Alternative Name (SAN) van het certificaat. Controleer ook of het certificaat geldig is en of het eindpunt de bijbehorende tussenliggende certificaten verzendt. Als u een reverse proxy gebruikt, test dan het openbare proxyadres: een correct certificaatbestand op de Synapse-host is niet voldoende als de proxy een verouderd of irrelevant certificaat aanbiedt.
Als de tester een certificaatprobleem voor uw server meldt, vernieuw of heruitgeef dan het certificaat voor de federatiehostnaam en configureer het openbare TLS-eindpunt om de volledige certificaatketen te bedienen. De huidige configuratiehandleiding van Synapse specificeert dat tls_certificate_pathmoet verwijzen naar een PEM-certificaat dat tussenliggende certificaten bevat; voor Certbot gebruikt u fullchain.pem, niet cert.pem. Bewaar de privésleutel in een apart tls_private_key_pathbestand en bescherm deze tegen openbare toegang.
Wanneer TLS eindigt bij Nginx, Caddy of een andere reverse proxy, moet u het certificaat en de certificaatketen in de configuratie van die proxy bijwerken en vervolgens de proxy herladen met de methode die geschikt is voor uw installatie. De eigen TLS-certificaatpaden van Synapse bepalen mogelijk niet welk certificaat door federatiepartners wordt gezien in deze configuratie. Raadpleeg de officiële Synapse reverse proxy-documentatie voor de listener- en proxy-configuratie die u gebruikt.
Controleer ook de DNS- en Matrix-serverdetectie. Federatie kan uw servernaam rechtstreeks oplossen of een /.well-known/matrix/serverdelegatie naar een andere hostnaam en poort volgen. Het certificaat moet geldig zijn voor de hostnaam die via die detectieroute wordt bereikt. Een verouderd DNS-record of een onjuiste delegatie kan peers doorverwijzen naar een eindpunt met een niet-gerelateerd certificaat.
Als het certificaat dat niet werkt, toebehoort aan een externe thuisserver op een privénetwerk, controleer dan eerst of het certificaat opzettelijk is uitgegeven door uw eigen certificeringsinstantie (CA). Installeer en onderhoud die CA indien mogelijk op de Synapse-host. Synapse biedt ook de mogelijkheid federation_custom_ca_listom aangepaste CA-certificaten te gebruiken voor federatie. Deze optie verwacht PEM-bestanden en vervangt de door het besturingssysteem geleverde CA-lijst. Voeg daarom alle CA's toe die uw implementatie nodig heeft, in plaats van blindelings slechts één privé-CA toe te voegen.
federation_custom_ca_list:
- /etc/matrix-synapse/certs/private-root-ca.pem
Stel het pad naar een CA-certificaat in, niet naar de privésleutel van de server. Zorg ervoor dat het Synapse-proces het certificaat kan lezen, valideer de inspringing van het YAML-bestand en herstart of herlaad Synapse volgens uw implementatiemethode. Volgens de configuratiehandleiding van Synapse is deze optie normaal gesproken bedoeld voor privé-servernetwerken thuis.
Stel deze optie niet in federation_verify_certificates: falseom een openbare federatiefout te onderdrukken. De standaardinstelling is true; door deze uit te schakelen wordt de certificaatverificatie voor uitgaande federatie verwijderd en de bescherming tegen identiteitsfraude verzwakt. Deze aparte optie federation_certificate_verification_whitelistis bedoeld voor specifieke gevallen zoals Tor hidden services of gecontroleerde privé-omgevingen, en niet als vervanging voor het herstellen van een openbaar certificaat. Voor privé-infrastructuren is een vertrouwde privé-CA over het algemeen de voorkeur.
Als de datums op het certificaat ongeldig lijken, terwijl het certificaat wel geldig is, controleer dan de systeemklok en de tijdsynchronisatie op de Synapse-host en eventuele proxy's. Een klok die aanzienlijk afwijkt, kan ervoor zorgen dat een geldig certificaat ongeldig of verlopen lijkt. Controleer ook of de automatische verlenging het publiekelijk aangeboden bestand daadwerkelijk heeft bijgewerkt; certificaatvernieuwing op schijf garandeert niet dat een proxy het bestand opnieuw heeft geladen.
Na de correctie voert u de Federation Tester opnieuw uit en herhaalt u de verbinding die mislukte. Controleer of de tester de verwachte hostnaam, geldige datums en een vertrouwde keten ziet en controleer de Synapse-logboeken op nieuwe federatiepogingen zonder de certificaatverificatiefout. Als de tester slaagt, maar één externe server nog steeds niet werkt, noteer dan de naam van die server, het tijdstempel en de relevante geanonimiseerde logboekvermelding: het eigen certificaat of de vertrouwensomgeving van die server kan het resterende probleem zijn. Deel geen privésleutels, toegangstokens of de inhoud van gebruikersberichten tijdens het oplossen van problemen.
Traceer M_FORBIDDEN naar het stroomniveau van de ruimte, het lidmaatschap of de Synapse-serverbeheerderstoegang en herstel vervolgens alleen de machtiging die de geblokkeerde actie nodig heeft.
Configureer Synapse discovery, HTTPS en proxy routing zodat andere Matrix homeservers uw server kunnen vinden en ermee in contact kunnen komen.
Configureer een Keycloak OIDC-client en een Synapse-provider zodat Element Web-gebruikers zich kunnen aanmelden via uw identiteitsserver zonder clientgeheimen prijs te geven.
Sla een herstelsleutel op, verifieer uw Element-sessies en controleer of versleutelde berichtsleutels kunnen worden hersteld zonder de back-up te verwarren met uw accountwachtwoord.
Diagnoseer geheugenproblemen bij Synapse tijdens synchronisatie, pas de caching veilig aan, identificeer achterstanden in aanvragen en controleer of het geheugengebruik stabiel is.
Traceer Matrix-federatiecertificaatfouten naar de juiste server, herstel de TLS-keten of het CA-vertrouwen en verifieer de oplossing zonder de beveiligingscontroles uit te schakelen.
Routeer Matrix-clients en federatie via Cloudflare op HTTPS 443, behoud Synapse-ontdekking en voorkom cachen van API-verkeer of problemen met media-uploads.
Maak een back-up van Synapse met pg_dump, bescherm de ondertekeningssleutel en de media, en herstel de back-up in een schone PostgreSQL-database zonder verouderde eenmalige sleutels opnieuw te gebruiken.
Configureer Mjölnir met een speciaal Matrix-account, een versleutelde beheerruimte, Docker Compose, een beleidslijst en toegangsrechtencontroles.
Sla de verouderde proxy over en configureer Synapse's ingebouwde Sliding Sync. Controleer de clientdetectie en meet vervolgens het laadgedrag van de kamerlijst en het herverbindingsgedrag op een compatibele telefoon.