> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Domaine personnalisé KYC : configuration DNS

> Avec Didit, servez la vérification depuis votre sous-domaine plutôt que verify.didit.me : ajoutez le domaine et créez deux enregistrements DNS.

Servez le parcours de vérification depuis votre propre sous-domaine, par exemple `verify.yourbrand.com` au lieu de `verify.didit.me`. Les utilisateurs restent sur votre domaine pendant tout le parcours, ce qui supprime la dernière référence visible à Didit dans un parcours en [marque blanche](https://docs.didit.me/fr/console/white-label.md).

> [!NOTE]
>
> Le domaine personnalisé fait partie de la marque blanche, sur les forfaits **Scale** et **Enterprise**. Vous devez aussi disposer d'un **accès en écriture à Customization**. Les membres ayant un accès en lecture seule voient la section désactivée.

> [!NOTE]
>
> Lorsque votre organisation quitte Scale ou Enterprise, y compris un essai Scale qui se termine sans forfait payant, son domaine personnalisé est supprimé et les nouveaux liens de vérification utilisent à nouveau le domaine de Didit. Un domaine personnalisé connecté avant le 1er novembre 2026 reste actif quel que soit le forfait ; si vous le supprimez, en ajouter un nouveau nécessite Scale ou Enterprise.

> [!NOTE]
>
> Les domaines personnalisés sont disponibles **uniquement pour les applications en production**. Une application [sandbox](https://docs.didit.me/fr/integration/sandbox-testing.md) ne peut pas en ajouter un, et les sessions sandbox utilisent toujours le domaine de vérification hébergé par défaut. Passez à votre application en production dans la Business Console pour configurer votre domaine.

***

## Prérequis

| Exigence | Détail |
| - | - |
| **Application en production** | Le domaine appartient à une application en production. Les applications sandbox ne peuvent pas configurer de domaine personnalisé. |
| **Sous-domaine uniquement** | Utilisez `verify.yourbrand.com`. Les domaines racines comme `yourbrand.com` sont rejetés, de même qu'un préfixe `www.`. |
| **Pas déjà utilisé** | Le sous-domaine ne peut pas pointer vers un site web ou une application existante qui vous appartient. |
| **Accès DNS** | Vous devez créer deux enregistrements chez votre fournisseur DNS. |

***

## Fonctionnement

Vous saisissez votre sous-domaine dans la Business Console. Didit génère alors deux enregistrements DNS que vous devez ajouter chez votre fournisseur :

| Enregistrement | Rôle |
| - | - |
| **CNAME de vérification** | Prouve que vous possédez le domaine, ce qui permet d'émettre le certificat SSL. |
| **CNAME CloudFront** | Dirige votre sous-domaine vers l'interface de vérification. |

Les deux enregistrements sont obligatoires. Une fois qu'ils sont résolus, vous vérifiez la propriété depuis la console, et le parcours est alors proposé depuis votre domaine.

***

## Configurer votre domaine

**1. Ajouter le domaine**

Rendez-vous dans **Customization > Domain**, saisissez votre sous-domaine (par exemple `verify.yourbrand.com`) et cliquez sur **Ajouter un domaine**.

La console génère vos enregistrements DNS. Cette opération prend quelques secondes.

**2. Copier les deux enregistrements**

La console affiche une carte pour chaque enregistrement, **CNAME de vérification** et **CNAME CloudFront**. Chaque carte fournit deux valeurs :

| Champ de la carte | Où le placer chez votre fournisseur DNS |
| - | - |
| **Nom d'hôte** | Le **nom** de l'enregistrement (hôte) |
| **Données/URL** | La **valeur** de l'enregistrement (cible) |

> [!WARNING]
>
> N'inversez pas **Nom d'hôte** et **Données/URL** lorsque vous les collez chez votre fournisseur DNS, et utilisez le bouton de copie pour chaque valeur. Les valeurs de vérification sont longues et faciles à mal recopier.

**3. Ajouter les deux enregistrements chez votre fournisseur DNS**

Créez les deux enregistrements de type `CNAME`. Ajouter uniquement l'enregistrement CloudFront est la cause la plus fréquente des échecs de vérification ultérieurs.

Définissez le TTL à `300` afin que toute correction effectuée ensuite se propage en quelques minutes au lieu de quelques heures.

**4. Vérifier la propriété**

De retour dans la console, cliquez sur **Vérifier le domaine**. En cas de succès, le panneau affiche **Domaine vérifié** et le bouton disparaît.

En cas d'échec, la console affiche une boîte **Échec de la vérification** avec la raison précise. Lisez-la avant de modifier quoi que ce soit : elle indique l'enregistrement manquant ou incorrect.

> [!NOTE]
>
> Le DNS se propage généralement en quelques minutes, mais cela peut prendre jusqu'à **24–48 heures**. Si la console affiche **Modifications DNS détectées**, vos enregistrements sont corrects et la propagation est encore en cours : aucune action n'est nécessaire.

***

## Modifier ou supprimer votre domaine

Pour déplacer le parcours vers un autre sous-domaine, saisissez le nouveau et cliquez sur **Mettre à jour le domaine**. Didit génère une nouvelle paire d'enregistrements : vous devez les ajouter chez votre fournisseur DNS, puis relancer la vérification.

Pour revenir à `verify.didit.me`, videz le champ et cliquez sur **Supprimer le domaine**.

> [!NOTE]
>
> Tant qu'un domaine personnalisé est configuré, vous ne pouvez pas réactiver l'écran de connexion Didit. Supprimez d'abord le domaine.

***

## Dépannage

> [accordion] Erreur 500, ou message mentionnant une autre distribution CloudFront
>
> Votre sous-domaine possède un enregistrement `A` en conflit avec le CNAME : un hôte ne peut pas avoir les deux. Supprimez l'enregistrement `A` et ne conservez que le CNAME.
>
> S'il n'existe aucun enregistrement `A`, le CNAME CloudFront pointe vers une mauvaise cible. Comparez-le caractère par caractère à la valeur **Données/URL** affichée dans la console.

> [accordion] La vérification ne réussit jamais
>
> Vérifiez que **les deux** enregistrements existent chez votre fournisseur. Ajouter uniquement l'enregistrement CloudFront est la cause la plus fréquente : le parcours semble se charger, mais le certificat n'est jamais émis.
>
> La zone **Échec de la vérification** de la console indique l'enregistrement manquant ou incorrect.

> [accordion] Le certificat n'est jamais émis (Cloudflare)
>
> Réglez les deux enregistrements sur **DNS uniquement** : le nuage gris, proxy désactivé. Le proxy à nuage orange intercepte la requête et empêche l'émission du certificat.
>
> Les fournisseurs sans bascule de proxy, comme cPanel, ne sont pas concernés.

> [accordion] Le nom de l'enregistrement est dupliqué
>
> Certains fournisseurs ajoutent automatiquement votre zone, transformant `verify.yourbrand.com` en `verify.yourbrand.com.yourbrand.com`.
>
> Chez ces fournisseurs, saisissez le nom **relatif** plutôt que le nom complet affiché dans la console : `verify` au lieu de `verify.yourbrand.com`, et `_abc123.verify` au lieu de `_abc123.verify.yourbrand.com`. Rouvrez ensuite l'enregistrement enregistré et vérifiez que le nom complet mémorisé correspond exactement au **Nom d'hôte** de la console.

> [accordion] Une correction met des heures à s'appliquer
>
> Vos enregistrements sont mis en cache pendant la durée de leur TTL. Réduisez le TTL à `300` et attendez l'expiration de l'ancienne valeur avant de tester à nouveau.

***

## Étapes suivantes

* **Alignez le reste de l'interface sur votre marque** : les couleurs, le logo et la typographie se configurent dans [Personnalisation](https://docs.didit.me/fr/console/white-label.md).
* **Activez votre style par workflow** : la personnalisation ne s'applique qu'aux workflows où **Inclure un style personnalisé** est activé. Voir [Marque blanche](https://docs.didit.me/fr/console/white-label.md#activer-le-style-personnalisé-dans-votre-workflow).
* **Vérifiez vos obligations de transparence** : un domaine personnalisé masque la marque Didit, mais pas son rôle. Voir [responsabilités en matière de conformité](https://docs.didit.me/fr/console/white-label.md#responsabilités-en-matière-de-conformité-dans-les-parcours-en-marque-blanche).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.