# Certificats de confiance

Ajoutez des certificats d'AC ou auto-signés pour que la plateforme fasse confiance en TLS à votre relais mail, passerelle SMS ou cible de provisionnement.

Lorsque la plateforme établit une connexion sortante en TLS vers l'un de vos propres serveurs, elle valide le certificat de ce serveur. **Certificats de confiance** est l'endroit où vous ajoutez l'autorité de certification (AC) ou le certificat auto-signé que ce serveur présente, afin que la connexion soit approuvée au lieu d'être rejetée.

Cette confiance ne s'applique qu'aux connexions **sortantes** (la plateforme agit comme client et valide le certificat du *serveur distant*). Sont concernés :

- votre **relais de messagerie** (un serveur SMTP personnalisé),
- votre **passerelle SMS personnalisée**,
- le **provisionnement sortant** vers une cible SCIM,
- un serveur multifacteur **privacyIDEA** auto-hébergé.

Les points de terminaison qui présentent un certificat publiquement approuvé (par exemple une API commerciale d'e-mail ou de SMS) fonctionnent sans aucune entrée ici.

> **Remarque :** L'authentification multifacteur Duo n'est pas couverte par ce magasin de confiance. L'intégration Duo valide directement le certificat cloud de Duo et ne peut pas être réorientée vers une autre autorité de certification. Si votre réseau pratique l'inspection TLS (déchiffrement SSL) du trafic sortant, vous devez **exclure de l'inspection les hôtes de service Duo (`*.duosecurity.com`)**, faute de quoi la connexion Duo échoue.

## Quand cela est nécessaire

Ajoutez un certificat lorsque le serveur cible utilise :

- un **certificat auto-signé**, ou
- un certificat émis par une **autorité de certification interne ou privée** qui n'est pas approuvée publiquement.

Si vous ne l'ajoutez pas, la connexion échoue avec une erreur du type `self-signed certificate in certificate chain`.

## Avant de commencer

- Munissez-vous du certificat au format **PEM** (un bloc de texte commençant par `-----BEGIN CERTIFICATE-----`).
- Pour un certificat émis par une AC interne, ajoutez le **certificat de l'AC** (ainsi que les éventuels intermédiaires), et non le certificat feuille du serveur. En cas de doute, incluez la chaîne complète.

## Ajouter un certificat de confiance

1. Ouvrez **Paramètres → Certificats de confiance**.
2. Sélectionnez **Ajouter un certificat**.
3. Saisissez un **Nom** permettant de le reconnaître plus tard (par exemple `Internal Mail Relay CA`).
4. Collez le certificat dans le champ de texte, ou faites glisser un fichier `.pem` / `.crt` sur la zone de téléversement.
5. Sélectionnez **Ajouter un certificat**. L'objet, l'émetteur, la date d'expiration et l'empreinte sont lus dans le certificat et affichés dans la liste.

Vous pouvez coller une chaîne complète ou un lot (plusieurs certificats dans un même bloc) ; chaque certificat est enregistré comme une entrée distincte.

## Supprimer un certificat de confiance

Dans la liste, sélectionnez l'icône de suppression sur la ligne concernée et confirmez. Le certificat n'est alors plus approuvé ; les connexions vers les serveurs qui s'appuient dessus peuvent ensuite échouer.

> **Remarque :** Une modification peut mettre quelques minutes à s'appliquer sur tous les nœuds de l'instance.

## Référence

| Champ | Remarques |
|---|---|
| Format | PEM (`-----BEGIN CERTIFICATE-----`). Un certificat, une chaîne ou un lot. |
| Métadonnées affichées | Nom, objet, type (AC racine / intermédiaire ou certificat), date d'expiration, empreinte (SHA-256) |
| Expiration | Un certificat expiré est refusé au téléversement ; les entrées proches de l'expiration sont signalées dans la liste |
| Portée | Un certificat de confiance s'applique à toutes les connexions TLS sortantes listées ci-dessus |

## Dépannage

- **`self-signed certificate in certificate chain`** : la chaîne du serveur n'est pas intégralement approuvée. Ajoutez le certificat de l'AC émettrice, y compris les éventuels intermédiaires et la racine.
- **Le certificat est expiré** : le certificat a dépassé sa date de validité. Obtenez-en un à jour auprès de l'exploitant du serveur et ajoutez-le.
- **Non-concordance du nom d'hôte** : faire confiance au certificat ne dispense pas de la vérification du nom d'hôte. Le certificat du serveur doit toujours correspondre au nom d'hôte auquel vous vous connectez.
- **Ajouté, mais la connexion échoue toujours** : vérifiez que vous avez bien ajouté le certificat de l'AC (et pas seulement le certificat feuille du serveur) et que la chaîne complète est présente.

## Voir aussi

- [Fournisseur d'e-mail](https://dts-identity.com/fr/docs/branding/email.md)
- [Fournisseur de téléphone / SMS](https://dts-identity.com/fr/docs/branding/phone-sms.md)
