# Vertrauenswürdige Zertifikate

CA- oder selbstsignierte Zertifikate hinzufügen, damit die Plattform Ihrem Mail-Relay, SMS-Gateway oder Provisionierungsziel per TLS vertraut.

Wenn die Plattform über TLS eine ausgehende Verbindung zu einem Ihrer eigenen Server aufbaut, prüft sie dessen Zertifikat. Unter **Vertrauenswürdige Zertifikate** hinterlegen Sie die Zertifizierungsstelle (CA) oder das selbstsignierte Zertifikat, das dieser Server vorweist, damit die Verbindung als vertrauenswürdig gilt und nicht abgelehnt wird.

Dieses Vertrauen gilt ausschließlich für **ausgehende** Verbindungen (die Plattform tritt als Client auf und prüft das Zertifikat des *entfernten Servers*). Betroffen sind:

- Ihr **Mail-Relay** (ein eigener SMTP-Server),
- Ihr **eigenes SMS-Gateway**,
- die **ausgehende Provisionierung** an ein SCIM-Ziel,
- einen selbst gehosteten **privacyIDEA**-Multi-Faktor-Server.

Endpunkte mit einem öffentlich vertrauenswürdigen Zertifikat (etwa eine kommerzielle E-Mail- oder SMS-API) funktionieren ohne Eintrag an dieser Stelle.

> **Hinweis:** Die Multi-Faktor-Authentifizierung über Duo wird von diesem Vertrauensspeicher nicht abgedeckt. Die Duo-Integration prüft das Cloud-Zertifikat von Duo direkt und lässt sich nicht auf eine andere Zertifizierungsstelle umleiten. Wenn Ihr Netzwerk ausgehenden Datenverkehr per TLS-Inspektion (SSL-Entschlüsselung) aufbricht, müssen Sie die **Duo-Dienst-Hosts (`*.duosecurity.com`) von der Inspektion ausnehmen**, andernfalls schlägt die Duo-Anmeldung fehl.

## Wann Sie das benötigen

Fügen Sie ein Zertifikat hinzu, wenn der Zielserver Folgendes verwendet:

- ein **selbstsigniertes Zertifikat** oder
- ein Zertifikat einer **internen / privaten Zertifizierungsstelle**, der nicht öffentlich vertraut wird.

Ohne diesen Eintrag schlägt die Verbindung mit einer Meldung wie `self-signed certificate in certificate chain` fehl.

## Bevor Sie beginnen

- Halten Sie das Zertifikat im **PEM**-Format bereit (ein Textblock, der mit `-----BEGIN CERTIFICATE-----` beginnt).
- Bei einem Zertifikat einer internen CA fügen Sie das **CA-Zertifikat** (und etwaige Zwischenzertifikate) hinzu, nicht das eigene Leaf-Zertifikat des Servers. Fügen Sie im Zweifel die vollständige Kette hinzu.

## Ein vertrauenswürdiges Zertifikat hinzufügen

1. Öffnen Sie **Settings → Trusted Certificates**.
2. Wählen Sie **Add certificate**.
3. Vergeben Sie einen **Namen** zur späteren Wiedererkennung (zum Beispiel `Interne Mail-Relay-CA`).
4. Fügen Sie das Zertifikat in das Textfeld ein oder ziehen Sie eine `.pem`- / `.crt`-Datei auf den Upload-Bereich.
5. Wählen Sie **Add certificate**. Antragsteller, Aussteller, Ablaufdatum und Fingerabdruck werden aus dem Zertifikat gelesen und in der Liste angezeigt.

Sie können eine vollständige Kette oder ein Bündel einfügen (mehrere Zertifikate in einem Block); jedes Zertifikat wird als eigener Eintrag gespeichert.

## Ein vertrauenswürdiges Zertifikat entfernen

Wählen Sie in der Liste das Löschsymbol in der Zeile und bestätigen Sie. Dem Zertifikat wird dann nicht mehr vertraut; Verbindungen zu Servern, die darauf beruhen, können danach fehlschlagen.

> **Hinweis:** Eine Änderung kann einige Minuten dauern, bis sie auf allen Knoten der Instanz wirksam ist.

## Referenz

| Feld | Hinweise |
|---|---|
| Format | PEM (`-----BEGIN CERTIFICATE-----`). Ein Zertifikat, eine Kette oder ein Bündel. |
| Angezeigte Metadaten | Name, Antragsteller, Typ (Stamm- / Zwischenzertifizierungsstelle oder Zertifikat), Ablaufdatum, Fingerabdruck (SHA-256) |
| Ablauf | Ein abgelaufenes Zertifikat wird beim Hochladen abgelehnt; Einträge kurz vor Ablauf werden in der Liste markiert |
| Geltungsbereich | Ein vertrauenswürdiges Zertifikat gilt für alle oben genannten ausgehenden TLS-Verbindungen |

## Fehlerbehebung

- **`self-signed certificate in certificate chain`**: der Zertifikatskette des Servers wird nicht vollständig vertraut. Fügen Sie das ausstellende CA-Zertifikat inklusive etwaiger Zwischenzertifikate und des Stammzertifikats hinzu.
- **Zertifikat ist abgelaufen**: das Zertifikat hat sein Gültigkeitsdatum überschritten. Beziehen Sie ein aktuelles vom Betreiber des Servers und fügen Sie es hinzu.
- **Hostname stimmt nicht überein**: das Vertrauen in das Zertifikat überspringt die Hostnamen-Prüfung nicht. Das Zertifikat des Servers muss weiterhin zum verbundenen Hostnamen passen.
- **Hinzugefügt, aber die Verbindung schlägt weiterhin fehl**: prüfen Sie, ob Sie das CA-Zertifikat (nicht nur das Leaf-Zertifikat des Servers) hinzugefügt haben und die vollständige Kette vorhanden ist.

## Siehe auch

- [E-Mail-Anbieter](https://dts-identity.com/de/docs/branding/email.md)
- [Telefon / SMS-Anbieter](https://dts-identity.com/de/docs/branding/phone-sms.md)
