Domaine personnalisé
Proposez la connexion depuis votre propre domaine plutôt que depuis l'hôte de plateforme par défaut.
Remarque sur les plans : Les domaines personnalisés sont disponibles à partir du plan Essential. Voir Plans & add-ons. Sur les niveaux inférieurs, la connexion est servie depuis l'hôte de plateforme par défaut.
Remarque : Un domaine personnalisé ne se configure pas dans l'Admin Console. La mise en place s'effectue dans le portail distinct qui gère votre instance. Cette page explique ce que change un domaine personnalisé et ce qu'il faut préparer avant la mise en place.
Par défaut, votre tenant est joignable via un hôte géré par la plateforme. Avec un domaine personnalisé, vos utilisateurs se connectent sur un nom d'hôte qui vous appartient, par exemple auth.yourcompany.com, de sorte que les pages de connexion, les liens contenus dans les e-mails de la plateforme et les points de terminaison OIDC utilisent tous votre propre domaine. Cela maintient une expérience cohérente avec le reste de votre service.
Ce qu'il faut préparer
| Élément | Détails |
|---|---|
| Un nom d'hôte dédié | Un sous-domaine réservé à la seule connexion, par exemple auth.yourcompany.com. Ne réutilisez pas le nom d'hôte d'un site web existant. |
| L'accès à la zone DNS | Deux enregistrements sont publiés pour ce nom d'hôte : un CNAME qui acheminera le trafic vers la plateforme, et un enregistrement TXT qui prouve que vous possédez le domaine. Les noms d'hôte et les valeurs exacts sont affichés pendant la mise en place. |
| Un certificat TLS (facultatif) | Uniquement si vous souhaitez utiliser votre propre certificat plutôt qu'un certificat géré. Préparez la chaîne de certificats PEM complète et la clé privée correspondante. Le certificat doit couvrir le nom d'hôte et ne doit pas être expiré. |
Comment se déroule la mise en place
Les étapes se suivent dans un ordre fixe :
- Domaine enregistré. Le nom d'hôte est consigné pour votre instance.
- Propriété vérifiée. Vous publiez les enregistrements TXT et CNAME chez votre fournisseur DNS. La vérification aboutit dès que les enregistrements se sont propagés, ce qui prend généralement quelques minutes.
- Certificat choisi. Soit un certificat géré est émis et renouvelé automatiquement, soit vous fournissez votre propre certificat accompagné de sa clé privée.
- Domaine activé. Le domaine est raccordé en périphérie et la connexion y est basculée. L'activation prend un moment et peut brièvement interrompre les sessions actives.
Après l'activation
- Les pages de connexion, les demandes de facteur supplémentaire, l'écran de consentement et le portail utilisateur sont servis depuis votre domaine.
- L'issuer OIDC et tous les points de terminaison utilisent le nouveau nom d'hôte. Les applications qui lisent le document de découverte le reprennent automatiquement ; tout ce qui comporte des URL de points de terminaison codées en dur doit être mis à jour.
- Les liens contenus dans les e-mails de la plateforme pointent vers le nouveau nom d'hôte.
- Laissez les enregistrements DNS en place aussi longtemps que le domaine est utilisé. Les supprimer casse la connexion.
Dépannage
- La vérification de propriété n'aboutit pas. Les modifications DNS peuvent prendre quelques minutes, parfois davantage, pour se propager. Vérifiez que l'hôte et la valeur de l'enregistrement correspondent exactement à ce qu'affiche la mise en place, sans caractère supplémentaire.
- Conflit de CNAME. Assurez-vous qu'aucun enregistrement A ou AAAA n'existe pour le même nom d'hôte.
- Certificat refusé. En mode certificat propre, le certificat doit être une chaîne PEM valide, correspondre à la clé privée, couvrir le nom d'hôte (CN ou SAN) et ne pas être expiré.
- La connexion utilise toujours l'ancien hôte. L'activation est la dernière étape et elle est distincte de la vérification. Vérifiez que le domaine s'affiche comme actif avant de basculer vos utilisateurs.