# Vertrouwde certificaten

CA- of zelfondertekende certificaten toevoegen, zodat het platform uw mailrelay, sms-gateway of provisioningdoel via TLS vertrouwt.

Wanneer het platform via TLS een uitgaande verbinding opbouwt naar een van uw eigen servers, valideert het het certificaat van die server. Onder **Vertrouwde certificaten** voegt u de certificeringsinstantie (CA) of het zelfondertekende certificaat toe dat die server presenteert, zodat de verbinding wordt vertrouwd in plaats van geweigerd.

Dit vertrouwen geldt uitsluitend voor **uitgaande** verbindingen (het platform treedt op als client en valideert het certificaat van de *externe server*). Het raakt:

- uw **mailrelay** (een eigen SMTP-server),
- uw **eigen sms-gateway**,
- de **uitgaande provisioning** naar een SCIM-doel,
- een zelfgehoste **privacyIDEA**-multifactorserver.

Endpoints die een publiek vertrouwd certificaat presenteren (bijvoorbeeld een commerciële e-mail- of sms-API) werken zonder enige vermelding hier.

> **Opmerking:** Multifactorauthenticatie via Duo valt niet onder deze vertrouwensopslag. De Duo-integratie valideert het eigen cloudcertificaat van Duo rechtstreeks en kan niet naar een andere certificeringsinstantie worden omgeleid. Breekt uw netwerk uitgaand verkeer open met TLS-inspectie (SSL-decryptie), dan moet u de **servicehosts van Duo (`*.duosecurity.com`) van die inspectie uitsluiten**, anders mislukt de aanmelding via Duo.

## Wanneer u dit nodig hebt

Voeg een certificaat toe wanneer de doelserver gebruikmaakt van:

- een **zelfondertekend certificaat**, of
- een certificaat dat is uitgegeven door een **interne / private certificeringsinstantie** die niet publiek wordt vertrouwd.

Voegt u het niet toe, dan mislukt de verbinding met een foutmelding als `self-signed certificate in certificate chain`.

## Voordat u begint

- Zorg dat u het certificaat in **PEM**-formaat hebt (een tekstblok dat begint met `-----BEGIN CERTIFICATE-----`).
- Bij een certificaat van een interne CA voegt u het **CA-certificaat** toe (plus eventuele tussenliggende certificaten), niet het eigen leafcertificaat van de server. Voeg bij twijfel de volledige keten toe.

## Een vertrouwd certificaat toevoegen

1. Open **Instellingen → Vertrouwde certificaten**.
2. Kies **Certificaat toevoegen**.
3. Vul een **Naam** in om het later te herkennen (bijvoorbeeld `Internal Mail Relay CA`).
4. Plak het certificaat in het tekstveld, of sleep een `.pem`- of `.crt`-bestand naar het uploadgebied.
5. Kies **Certificaat toevoegen**. Het subject, de issuer, de vervaldatum en de fingerprint worden uit het certificaat gelezen en in de lijst getoond.

U kunt een volledige keten of bundel plakken (meerdere certificaten in één blok); elk certificaat wordt als eigen vermelding opgeslagen.

## Een vertrouwd certificaat verwijderen

Kies in de lijst het verwijderpictogram op de regel en bevestig. Het certificaat wordt dan niet meer vertrouwd; verbindingen naar servers die erop steunen kunnen daarna mislukken.

> **Opmerking:** Het kan enkele minuten duren voordat een wijziging op alle nodes van de instantie is doorgevoerd.

## Referentie

| Veld | Opmerkingen |
|---|---|
| Formaat | PEM (`-----BEGIN CERTIFICATE-----`). Eén certificaat, een keten of een bundel. |
| Getoonde metadata | Naam, subject, type (root-CA / intermediate CA of certificaat), vervaldatum, fingerprint (SHA-256) |
| Vervaldatum | Een verlopen certificaat wordt bij het uploaden geweigerd; vermeldingen die bijna verlopen worden in de lijst gemarkeerd |
| Reikwijdte | Een vertrouwd certificaat geldt voor alle hierboven genoemde uitgaande TLS-verbindingen |

## Probleemoplossing

- **`self-signed certificate in certificate chain`**: de keten van de server wordt niet volledig vertrouwd. Voeg het uitgevende CA-certificaat toe, inclusief eventuele tussenliggende certificaten en het rootcertificaat.
- **Certificaat is verlopen**: het certificaat is voorbij zijn geldigheidsdatum. Vraag een actueel exemplaar op bij de beheerder van de server en voeg dat toe.
- **Hostnaam komt niet overeen**: het certificaat vertrouwen slaat de hostnaamcontrole niet over. Het certificaat van de server moet nog steeds bij de hostnaam passen waarmee wordt verbonden.
- **Toegevoegd, maar de verbinding mislukt nog steeds**: controleer of u het CA-certificaat hebt toegevoegd (niet alleen het leafcertificaat van de server) en of de volledige keten aanwezig is.

## Zie ook

- [E-mailprovider](https://dts-identity.com/nl/docs/branding/email.md)
- [Telefoon- / sms-provider](https://dts-identity.com/nl/docs/branding/phone-sms.md)
