Configurer un domaine personnalisé Auth0 : login.votredomaine.com étape par étape

Remplacez yourapp.auth0.com par login.yourapp.com. Guide complet : DNS, certificat TLS, Universal Login et CORS.

Par Auth0.Expert · 2025-03-01 · 8 min de lecture

Custom Domain DNS Universal Login

Domaine personnalisé Auth0 : guide complet

TL;DR

Un domaine personnalisé (login.yourdomain.com) améliore la confiance utilisateur, évite le blocage par les bloqueurs de cookies tiers, et est indispensable pour les cookies SameSite. Disponible sur les plans Professional et Enterprise.

---

Pourquoi c'est critique

Avant de rentrer dans la technique, rappelons pourquoi cette configuration est essentielle pour la sécurité et la confiance sur votre application.

  1. Cookies tiers bloqués : Chrome et Safari bloquent les cookies auth0.com sur votre domaine → les sessions SSO Silent Auth ne fonctionnent plus.
  2. Branding : l'URL votreapp.auth0.com révèle votre stack technique et nuit à la confiance.
  3. CNAME Auth0 : avec un domaine custom, Auth0 gère quand même le TLS automatiquement.

---

Étape 1 : Créer le domaine dans Auth0

Pour débuter, commencez par déclarer votre domaine personnalisé dans le dashboard Auth0 via les paramètres de branding.

Type: Auth0-managed certificate (recommandé)
Domain: login.yourapp.com

Auth0 vous donnera un enregistrement CNAME à créer :

CNAME: login.yourapp.com → cd_xxxxxxxxxxxx.edge.tenants.auth0.com

---

Étape 2 : Configurer le DNS

Une fois le domaine généré, vous devez ajouter un enregistrement CNAME dans la zone DNS de votre domaine. Voici comment procéder avec Cloudflare, la configuration la plus courante et recommandée.

# Cloudflare (recommandé — proxy DÉSACTIVÉ pour Auth0)
Type: CNAME
Name: login
Target: cd_xxxxxxxxxxxx.edge.tenants.auth0.com
Proxy: Off (nuage gris)
TTL: Auto

⚠️ Cloudflare Proxy (nuage orange) doit être désactivé pour les domaines Auth0.

---

Étape 3 : Vérifier et activer

Lorsque le DNS est propagé, Auth0 déclenche automatiquement la vérification du CNAME. Cette automatisation simplifie la procédure.

  1. Auth0 vérifie automatiquement le CNAME (peut prendre jusqu'à 24h)
  2. Une fois vérifié, cliquez "Save"
  3. TLS est provisionné automatiquement par Auth0 via Let's Encrypt

---

Étape 4 : Mettre à jour votre code

Après l'activation, il est crucial de remplacer le domaine Auth0 par le domaine personnalisé dans votre code. Cela garantit que toutes vos authentifications passent par le nouveau domaine.

// Avant
const domain = 'yourapp.auth0.com';

// Après
const domain = 'login.yourapp.com';

Voici maintenant comment mettre à jour la configuration dans une application React utilisant le SDK officiel Auth0.

// auth0-react
import { Auth0Provider } from '@auth0/auth0-react';

<Auth0Provider
  domain="login.yourapp.com"  // ← domaine custom
  clientId="YOUR_CLIENT_ID"
  authorizationParams={{
    redirect_uri: window.location.origin
  }}
>

Ce code assure que tous les flux d’authentification passent par votre domaine personnalisé, renforçant la sécurité et l'image de marque.

---

Configurer le fallback

Pour assurer une tolérance aux pannes, il est recommandé de prévoir un repli sur le domaine Auth0 natif si le domaine personnalisé rencontre un incident.

const domain = process.env.REACT_APP_AUTH0_DOMAIN || 'yourapp.auth0.com';

---

CORS : mettre à jour les origines autorisées

Une étape indispensable consiste à adapter les URLs autorisées dans votre dashboard Auth0, afin d’éviter tout blocage lors du callback, logout ou lors des requêtes web.

Allowed Callback URLs:
  https://yourapp.com/callback

Allowed Logout URLs:
  https://yourapp.com

Allowed Web Origins:
  https://yourapp.com

---

Vérification finale

Pour finir, voici comment tester la bonne prise en compte du domaine côté DNS, TLS et découverte OIDC. Ces commandes aident à identifier rapidement les erreurs de configuration.

# Vérifier le CNAME
dig login.yourapp.com CNAME

# Vérifier TLS
curl -I https://login.yourapp.com/.well-known/openid-configuration

# Vérifier la discovery
curl https://login.yourapp.com/.well-known/openid-configuration | jq .issuer
# Doit retourner: "https://yourapp.auth0.com/" (pas le domaine custom)

Ces vérifications assurent que votre domaine custom pointe bien vers Auth0, que le certificat SSL est valide, et que la configuration OIDC fonctionne correctement.

⚠️ L'issuer dans les tokens reste votre domaine Auth0 original, pas le domaine custom. Ne confondez pas les deux dans votre validation.

---

> 📌 Migration vers un domaine personnalisé avec utilisateurs actifs ? Nos experts planifient la migration sans déconnecter vos utilisateurs actuels.

📞 +33 1 23 45 67 89

Autres articles