> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/fr/pam/deploy-operate/certificates.md).

# Certificats et HTTPS

Servir la console en HTTPS : le nom auquel le certificat doit correspondre, le réglage URL du site qui doit s'accorder avec lui, et ce qui casse en silence quand les deux divergent.

## De quoi il s'agit et quand l'utiliser

Deux éléments distincts doivent s'aligner avant que la console soit correctement servie en HTTPS, et les confondre est la raison d'être de cette page :

* **Le certificat** qui termine le HTTPS pour l'accès web, installé sur le serveur et correspondant au nom DNS que vos utilisateurs saisissent.
* **URL du site**, un réglage qui indique à la solution sa propre adresse publique.

Le certificat fait taire l'avertissement du navigateur. L'URL du site est ce que la solution place dans les liens des courriels de notification, dans les redirections SSO et dans les rappels internes. Réussir le certificat et laisser l'URL du site en l'état produit une installation qui a l'air terminée (la page de connexion s'affiche en HTTPS sans avertissement) et casse silencieusement l'authentification unique et tous les liens que le système envoie par courriel.

Les certificats situés ailleurs dans le produit relèvent d'autres chaînes de confiance et ne se configurent pas ici : LDAPS utilise ses propres fichiers de certificat chargés sur l'appliance, le broker authentifie gateways et connecteurs avec sa propre PKI, et le TLS de SMTP se configure avec le serveur de messagerie. Corriger le certificat de la console n'y touche pas.

{% hint style="warning" %}
**L'installation du certificat elle-même n'est pas une procédure en libre-service dans le matériau source de ce wiki.** Ce que la source indique, c'est que la mise en place du certificat HTTPS nécessite le support de mise en œuvre DataDike, qui accède au serveur en ligne de commande pour importer votre wildcard. Faites appel au support plutôt que d'improviser. Notez par ailleurs qu'un écran de Paramètres existe pour téléverser un certificat wildcard ou de sous-domaine, dont les champs n'ont pas pu être vérifiés face à la source et ne sont donc pas documentés ici. Confirmez auprès du support quelle voie s'applique à votre installation et à votre version.
{% endhint %}

## Ce qui est établi

| Fait                                                                                        | Remarque                                                                                                                                                            |
| ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| L'interface web est servie en HTTPS pour l'accès par navigateur                             | Énoncé comme une caractéristique de la plateforme                                                                                                                   |
| Pour l'accès web, votre propre certificat ou une émission automatique peuvent être utilisés | Lequel des deux s'applique à votre installation et à votre version doit être confirmé auprès du support ; la source n'affirme rien de plus que l'existence des deux |
| Le certificat est importé sur le serveur par le support de mise en œuvre                    | Énoncé pour le cas du wildcard                                                                                                                                      |
| L'adresse doit être un nom DNS qui se résout pour vos utilisateurs                          | Un certificat correspond à des noms, et la voie de configuration temporaire s'appuie sur une entrée de fichier hosts qui n'existe que sur une seule machine         |

## Avant de commencer

* **Arrêtez d'abord le nom DNS.** Le certificat correspond au nom que les utilisateurs saisissent, l'URL du site s'en déduit, et le changer plus tard oblige à revoir les deux.
* **Ayez le certificat.** Un certificat wildcard ou de sous-domaine couvrant ce nom.
* **Sachez que vous avez deux étapes DNS.** La source décrit délibérément la configuration en deux temps : une étape **temporaire**, où vous ajoutez une entrée dans le fichier hosts de votre propre machine uniquement pour atteindre l'appliance pendant la configuration, et l'étape **définitive**, où les enregistrements existent dans votre DNS privé, ainsi que dans votre DNS public si vous publiez la console sur internet par NAT/DNAT. L'entrée hosts est un échafaudage ; la laisser en place, c'est ainsi qu'un administrateur finit par voir un système fonctionnel que personne d'autre ne peut atteindre.
* **Faites appel au support de mise en œuvre** pour l'import.

## Étapes

1. **Fixez le nom d'hôte et créez les enregistrements DNS définitifs** pour le nom que couvre le certificat : DNS privé, et DNS public également si la console est publiée à l'extérieur.
2. **Faites importer le certificat par le support** sur le serveur.
3. **Renseignez l'URL du site** sous **Paramètres système › Général › Basique** avec l'URL complète de ce nom, avec le schéma `https://` et **sans barre oblique finale**.
4. **Redémarrez les composants dépendants** après avoir modifié l'URL du site. La source est explicite : le changement en a besoin pour être appliqué.
5. **Supprimez l'entrée temporaire du fichier hosts** de votre propre machine, afin de tester ce que tout le monde voit.

## À quoi sert l'URL du site

C'est pourquoi l'étape 3 n'est pas cosmétique. L'URL du site est consommée en interne par :

| Consommateur                                                                                               | Effet d'une valeur erronée                                                                    |
| ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Les liens des courriels de notification : alertes, approbations d'accès, réinitialisations de mot de passe | Les destinataires reçoivent un lien vers l'ancienne adresse, ou vers une IP en HTTP simple    |
| Les redirections après authentification SSO (SAML2, OIDC, OAuth2)                                          | La connexion fédérée échoue ou boucle, tandis que la connexion locale continue de fonctionner |
| Les rappels et webhooks générés en interne                                                                 | Les intégrations n'arrivent pas à rappeler                                                    |
| Le téléchargement du client d'accès distant, là où il est configuré                                        | Les clients téléchargent depuis une adresse qui peut ne pas se résoudre pour l'utilisateur    |

Elle est obligatoire, et elle doit être joignable depuis les clients qui utilisent la plateforme, et pas seulement résoluble sur le serveur.

## Comment vérifier que cela a fonctionné

Chacun des contrôles ci-dessous éprouve un consommateur différent de la configuration, car le cadenas du navigateur ne prouve que le premier.

1. **Ouvrez la console par le nom DNS exact, en HTTPS**, depuis une machine sans entrée dans le fichier hosts. Aucun avertissement, et le nom du certificat correspond au nom affiché dans la barre d'adresse.
2. **Interrogez l'endpoint de santé non authentifié en HTTPS sur ce même nom** : `/api/health/` doit renvoyer son JSON. Cela confirme que le TLS se termine sur ce nom et que l'application répond derrière, ce qu'une page statique d'erreur ou de maintenance ne ferait pas.
3. **Déclenchez quelque chose qui envoie un lien**, un courriel de notification que vous pouvez recevoir, et confirmez que le lien utilise le nom en HTTPS plutôt qu'une IP ou `http://`. C'est le contrôle de l'URL du site, et rien de ce qu'affiche le navigateur ne s'y substitue.
4. **Effectuez une connexion via votre fournisseur d'identité.** La redirection après authentification doit atterrir sur le nom en HTTPS. Une URL du site périmée casse exactement cela tout en laissant la connexion locale en bonne santé : tester avec le compte administrateur local ne prouve donc rien ici.
5. **Si un scanner de vulnérabilités ou une autre intégration consomme l'API d'identifiants**, confirmez que son connecteur fonctionne toujours : il exige l'URL de base en HTTPS et un certificat que son propre magasin de confiance accepte. Une autorité de certification interne à laquelle les navigateurs font confiance grâce à une stratégie de groupe n'est pas nécessairement approuvée par une appliance de scan.

{% hint style="warning" %}
**Rien dans la source ne documente d'alerte d'expiration pour le certificat de la console.** Suivez la date d'expiration en dehors du produit, dans votre inventaire de certificats ou dans votre système de supervision. Un certificat qui expire coupe l'accès par navigateur de tout le monde d'un coup, et il le fait à une date connue des mois à l'avance.
{% endhint %}

## Erreurs fréquentes

| Symptôme                                                                                        | Cause                                                                                                                                                       | Correction                                                                                                                                    |
| ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| La console s'affiche en HTTPS, mais la connexion SSO boucle ou atterrit sur la mauvaise adresse | L'URL du site n'a pas été mise à jour vers le nom en HTTPS                                                                                                  | Renseignez l'URL du site sous **Général › Basique**, puis redémarrez les composants dépendants                                                |
| Les liens des courriels pointent vers une adresse IP ou vers `http://`                          | L'URL du site contient encore sa valeur d'installation                                                                                                      | Même correction. Vérifiez en recevant un courriel, pas en relisant le champ                                                                   |
| Avertissement de certificat dans le navigateur après l'installation                             | Le nom saisi n'est pas couvert par le certificat, ou le DNS se résout encore via une entrée hosts résiduelle                                                | Utilisez le nom que couvre le certificat ; supprimez les entrées du fichier hosts et confirmez l'existence des enregistrements DNS définitifs |
| Fonctionne pour l'administrateur, injoignable pour tous les autres                              | L'entrée temporaire du fichier hosts assure encore la résolution sur cette seule machine                                                                    | Créez les enregistrements définitifs dans le DNS privé, et les enregistrements publics si la console est publiée                              |
| Un scanner ou une intégration A2A n'arrive pas à se connecter                                   | URL de base sans HTTPS, ou certificat auquel l'intégration ne fait pas confiance                                                                            | Utilisez l'URL de base en HTTPS et faites approuver le certificat par ce client                                                               |
| LDAPS échoue toujours après la correction du certificat de la console                           | Le TLS de LDAP utilise ses propres fichiers, `ldap_ca.pem`, `ldap_cert.pem` et `ldap_cert.key`, chargés sur l'appliance, et exige un redémarrage du service | Traitez les certificats LDAP séparément du certificat de la console                                                                           |
| Les connexions gateway échouent après le passage à une release qui impose TLS 1.3               | La 5.0.1 impose TLS 1.3 entre la VM Gateway et le serveur, et sa note de version indique qu'un redémarrage est requis                                       | Voir [Mise à niveau](https://wiki.datadike.com/fr/pam/deploy-operate/upgrade.md)                                                              |
| Les enrôlements de broker cassent après un changement d'adresse du broker                       | L'adresse du broker est inscrite dans ses certificats et ses tokens d'enrôlement et ne peut plus être modifiée ensuite                                      | Adressez toujours le broker par un nom DNS ; le changer autrement impose de réinstaller le broker                                             |

## Pages associées

* [Mise à niveau](https://wiki.datadike.com/fr/pam/deploy-operate/upgrade.md)
* [Supervision et santé](https://wiki.datadike.com/fr/pam/deploy-operate/monitoring.md)
* [Ports](https://wiki.datadike.com/fr/pam/reference/ports.md)
* [Concepts fondamentaux](https://wiki.datadike.com/fr/pam/get-started/core-concepts.md)
