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.
Ce qui est établi
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
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.
Faites importer le certificat par le support sur le serveur.
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.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é.
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 :
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.
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.
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.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.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.
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.
Erreurs fréquentes
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
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
Atualizado
Isto foi útil?