Element Web über Synapse OIDC mit Keycloak verbinden
Konfigurieren Sie einen Keycloak OIDC-Client und einen Synapse-Provider, damit sich Element Web-Benutzer über Ihren Identitätsserver anmelden können, ohne Client-Geheimnisse preiszugeben.
Wenn Matrix Synapse-Protokolle SSL: CERTIFICATE_VERIFY_FAILEDwährend der Föderation anzeigen, dass ein Beitritt hängen bleibt, ein Remote-Server Ihre Verbindung ablehnt oder Nachrichten nicht ankommen, ermitteln Sie zunächst, welches Zertifikat das Problem verursacht: das Zertifikat eines Remote-Servers bei einer ausgehenden Anfrage oder das Zertifikat Ihres eigenen Föderationsendpunkts bei der Verbindung eines anderen Servers. Reparieren Sie anschließend die Zertifikatskette, den Hostnamen oder die Vertrauenskonfiguration, die im Protokoll und bei einem Föderationstest identifiziert wurden. Deaktivieren Sie die TLS-Verifizierung nicht als allgemeine Lösung.
Der Server-zu-Server-Verkehr von Matrix verwendet HTTPS, und die Matrix-Spezifikation verlangt, dass das Ziel ein von einer anerkannten Zertifizierungsstelle signiertes TLS-Zertifikat vorlegt. Ein Verifizierungsfehler bedeutet in der Regel, dass das vorgelegte Zertifikat abgelaufen oder unvollständig ist, für einen anderen Hostnamen ausgestellt wurde oder von einer Zertifizierungsstelle signiert ist, der der verbindende Server nicht vertraut. Auch ein Reverse-Proxy kann das falsche Zertifikat verwenden, selbst wenn die Konfiguration von Synapse korrekt erscheint.
Prüfen Sie den Synapse-Protokolleintrag zum Zeitpunkt des Fehlers und notieren Sie sich den Namen des Remote-Servers und die genaue Zertifikatsfehlermeldung. Meldet Synapse den Fehler bei einer Anfrage an einen anderen Homeserver, liegt das Problem wahrscheinlich am Zertifikat des Remote-Servers oder an der von Ihrem Synapse-Prozess verwendeten Zertifizierungsstelle. Können andere Server keine Verbindung zu Ihrer Domäne herstellen, überprüfen Sie stattdessen Ihren öffentlichen TLS-Endpunkt und die Servererkennung.
Bestätigen Sie Ihren Matrix-Servernamen homeserver.yaml, insbesondere server_nameden Domänenteil der lokalen Matrix-IDs. Dieser bestimmt, wie andere Homeserver Sie erreichen. Verwechseln Sie ihn nicht mit dem internen Hostnamen des Rechners oder Containers. Die aktuelle Synapse-Installationsdokumentation erklärt, dass der Servername eine Verbundidentität ist und empfiehlt, ihn vor der Installation festzulegen.
Verwenden Sie den Matrix Federation Tester mit Ihrem Matrix-Servernamen. Er prüft die Verbundermittlung und -verbindung und kann aufdecken, ob das extern sichtbare Zertifikat oder das Routing fehlerhaft ist. Beheben Sie das identifizierte Problem, bevor Sie die ausgehenden Vertrauenseinstellungen von Synapse anpassen.
Prüfen Sie von einem Rechner aus, der Ihren Verbundendpunkt erreichen kann, das TLS-Zertifikat. Ersetzen Sie matrix.example.org<Hostname> durch den Hostnamen, der das Zertifikat präsentieren soll, und verwenden Sie Ihren tatsächlichen Verbundport. Port 8448 ist üblich, ein Reverse-Proxy oder ein delegierter Server kann jedoch einen anderen Port verwenden.
openssl s_client -connect matrix.example.org:8448 \
-servername matrix.example.org -showcerts </dev/null
Diese -servernameOption sendet SNI (Server Name Indication), sodass ein virtuell gehosteter Proxy das Zertifikat für den angeforderten Namen auswählen kann. Prüfen Sie die Ausgabe auf ein erfolgreiches Verifizierungsergebnis und überprüfen Sie anschließend den Betreff und die Gültigkeitsdauer des Zertifikats.
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
Der von der Matrix-Federation verwendete Name muss mit einem DNS-Namen im alternativen Antragstellernamen (Subject Alternative Name, SUDN) des Zertifikats übereinstimmen. Prüfen Sie außerdem, ob das Zertifikat aktuell gültig ist und der Endpunkt seine Zwischenzertifikate sendet. Wenn Sie einen Reverse-Proxy verwenden, testen Sie die öffentliche Proxy-Adresse: Eine korrekte Zertifikatsdatei auf dem Synapse-Host nützt nichts, wenn der Proxy ein veraltetes oder nicht zugehöriges Zertifikat ausgibt.
Meldet der Tester ein Zertifikatsproblem für Ihren Server, erneuern oder stellen Sie das Zertifikat für den Verbundhostnamen neu aus und konfigurieren Sie den öffentlichen TLS-Endpunkt so, dass er die vollständige Zertifikatskette bereitstellt. Laut Synapses aktuellem Konfigurationshandbuch tls_certificate_pathmuss dieser auf ein PEM-Zertifikat verweisen, das Zwischenzertifikate enthält. Verwenden Sie für Certbot `<PEM-Zertifikat>` fullchain.pem, nicht ` cert.pem<Certbot-Zertifikat>`. Bewahren Sie den privaten Schlüssel in einer separaten tls_private_key_pathDatei auf und schützen Sie ihn vor öffentlichem Zugriff.
Wenn die TLS-Verbindung bei Nginx, Caddy oder einem anderen Reverse-Proxy beendet wird, aktualisieren Sie das Zertifikat und die Zertifikatskette in der Konfiguration dieses Proxys und laden Sie ihn anschließend mit der für Ihre Installation geeigneten Methode neu. Die TLS-Zertifikatspfade von Synapse steuern in dieser Konfiguration möglicherweise nicht das Zertifikat, das von den Föderationspartnern verwendet wird. Beachten Sie die offizielle Synapse-Dokumentation für Reverse-Proxys hinsichtlich der von Ihnen verwendeten Listener- und Proxy-Konfiguration.
Prüfen Sie auch die DNS- und Matrix-Servererkennung. Die Föderation kann Ihren Servernamen direkt auflösen oder einer /.well-known/matrix/serverDelegierung zu einem anderen Hostnamen und Port folgen. Das Zertifikat muss für den über diesen Erkennungspfad erreichten Hostnamen gültig sein. Ein veralteter DNS-Eintrag oder eine fehlerhafte Delegierung kann dazu führen, dass Peers zu einem Endpunkt mit einem nicht zugehörigen Zertifikat geleitet werden.
Wenn das fehlerhafte Zertifikat zu einem entfernten Heimserver in einem privaten Netzwerk gehört, vergewissern Sie sich zunächst, dass es von Ihrer privaten Zertifizierungsstelle (CA) ausgestellt wurde. Installieren und pflegen Sie diese CA nach Möglichkeit auf dem Synapse-Host. Synapse bietet außerdem federation_custom_ca_listdie Möglichkeit, benutzerdefinierte CA-Zertifikate für die Föderation zu verwenden. Diese Option erwartet PEM-Dateien und ersetzt die vom Betriebssystem bereitgestellte CA-Liste. Fügen Sie daher alle für Ihre Bereitstellung benötigten CAs hinzu, anstatt nur eine einzige private CA blindlings zu verwenden.
federation_custom_ca_list:
- /etc/matrix-synapse/certs/private-root-ca.pem
Legen Sie den Pfad zu einem CA-Zertifikat fest, nicht zum privaten Schlüssel des Servers. Stellen Sie sicher, dass der Synapse-Prozess dieses lesen kann, überprüfen Sie die YAML-Einrückung und starten Sie Synapse entsprechend Ihrer Bereitstellungsmethode neu oder laden Sie es neu. Laut Synapse-Konfigurationshandbuch ist diese Option normalerweise für private Heimserver-Netzwerke vorgesehen.
Setzen Sie diese Option nicht federation_verify_certificates: false, um einen öffentlichen Föderationsfehler zu unterdrücken. Die Standardeinstellung ist truedeaktiviert; durch Deaktivierung wird die Zertifikatsprüfung für ausgehende Föderationsverbindungen entfernt und der Schutz vor Identitätsdiebstahl geschwächt. Diese separate Option federation_certificate_verification_whitelistist für spezielle Fälle wie Tor-Hidden-Services oder kontrollierte private Umgebungen vorgesehen und dient nicht als Ersatz für die Reparatur eines öffentlichen Zertifikats. Für private Infrastrukturen ist eine vertrauenswürdige private Zertifizierungsstelle (CA) im Allgemeinen vorzuziehen.
Wenn Zertifikatsdaten ungültig angezeigt werden, obwohl das Zertifikat gültig ist, überprüfen Sie die Systemuhr und die Zeitsynchronisierung auf dem Synapse-Host und allen Proxys. Eine stark abweichende Uhrzeit kann dazu führen, dass ein gültiges Zertifikat als ungültig oder abgelaufen erscheint. Stellen Sie außerdem sicher, dass die automatische Zertifikatserneuerung die öffentlich bereitgestellte Datei tatsächlich aktualisiert hat; eine Zertifikatserneuerung auf der Festplatte garantiert nicht, dass ein Proxy diese neu geladen hat.
Führen Sie nach der Korrektur den Federation Tester erneut aus und wiederholen Sie die fehlgeschlagene Verbindung. Prüfen Sie, ob der Tester den erwarteten Hostnamen, gültige Datumsangaben und eine vertrauenswürdige Zertifikatskette erkennt, und überprüfen Sie die Synapse-Protokolle auf neue Verbindungsversuche ohne Zertifikatsprüfungsfehler. Falls der Test erfolgreich ist, aber ein Remote-Server weiterhin fehlschlägt, erfassen Sie dessen Namen, den Zeitstempel und den entsprechenden anonymisierten Protokolleintrag: Möglicherweise liegt das Problem am Zertifikat oder der Vertrauensumgebung dieses Servers. Geben Sie während der Fehlerbehebung keine privaten Schlüssel, Zugriffstoken oder Benutzernachrichteninhalte weiter.
Konfigurieren Sie einen Keycloak OIDC-Client und einen Synapse-Provider, damit sich Element Web-Benutzer über Ihren Identitätsserver anmelden können, ohne Client-Geheimnisse preiszugeben.
Speichern Sie einen Wiederherstellungsschlüssel, überprüfen Sie Ihre Element-Sitzungen und stellen Sie sicher, dass verschlüsselte Nachrichtenschlüssel wiederhergestellt werden können, ohne die Sicherung mit Ihrem Kontopasswort zu verwechseln.
Synapse-Speicherfehler während der Synchronisierung diagnostizieren, Caching sicher anpassen, Anfragerückstände identifizieren und eine stabile Speichernutzung überprüfen.
Trace Matrix-Federationszertifikatfehler werden dem richtigen Server zugeordnet, die TLS-Kette oder die CA-Vertrauensstellung wird repariert und die Reparatur wird überprüft, ohne die Sicherheitsprüfungen zu deaktivieren.
Matrix-Clients und Föderation werden über Cloudflare auf HTTPS 443 geleitet, die Synapse-Erkennung bleibt erhalten und das Caching des API-Datenverkehrs sowie das Unterbrechen von Medien-Uploads werden vermieden.
Sichern Sie Synapse mit pg_dump, schützen Sie den Signaturschlüssel und die Speichermedien und stellen Sie die Daten in einer sauberen PostgreSQL-Datenbank wieder her, ohne veraltete Einmalschlüssel wiederzuverwenden.
Richten Sie Mjölnir mit einem dedizierten Matrix-Konto, einem verschlüsselten Verwaltungsraum, Docker Compose, einer Richtlinienliste und Berechtigungsprüfungen ein.
Überspringen Sie den veralteten Proxy und konfigurieren Sie die in Synapse integrierte Sliding-Sync-Funktion. Überprüfen Sie die Client-Erkennung und messen Sie anschließend das Ladeverhalten der Raumliste sowie das Verhalten bei der Wiederverbindung auf einem kompatiblen Telefon.
Stellen Sie Element Web als statische Website bereit, verweisen Sie es auf Ihren Matrix-Homeserver, fügen Sie HTTPS hinzu und konfigurieren Sie Nginx so, dass Aktualisierungen ohne veraltete Dateien bereitgestellt werden.
Conduit auf einem 64-Bit Raspberry Pi 4 mit persistenten Daten, HTTPS-Federation, geschützter Registrierung und Überprüfungen auf einen funktionierenden Homeserver einrichten.