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

# Domaines personnalisés

> Configurez des URL personnalisées pour votre portail de vérification et votre console avec une configuration de domaine personnalisée et une vérification DNS.

Les domaines personnalisés vous permettent de servir le portail de vérification et la console Truthlocks depuis votre propre domaine. Au lieu de `verify.truthlocks.com`, vos utilisateurs voient `verify.yourdomain.com`.

> [!NOTE]
>
> Les domaines personnalisés sont disponibles sur tous les plans. Accédez à **Paramètres > Domaines**
> dans la console pour commencer.

## Types de domaine

Truthlocks prend en charge deux types de domaines personnalisés :

| Type | Objectif | Exemple |
| :- | :- | :- |
| **Vérification** | Portail de vérification public où les destinataires et les auditeurs vérifient les attestations | `verify.yourdomain.com` |
| **Console** | Console administrative pour votre équipe | `console.yourdomain.com` |

Vous pouvez configurer un ou les deux types selon vos besoins.

## Configuration d'un domaine personnalisé

**1. Ouvrir les paramètres de domaine**

Naviguez vers **Paramètres > Domaines** dans la console.

**2. Ajouter un domaine**

Cliquez sur **Ajouter un domaine**, sélectionnez le type de domaine (Vérification ou Console), et
entrez le nom d'hôte que vous souhaitez utiliser (par exemple, `verify.yourdomain.com`).

**3. Ajouter l'enregistrement DNS**

Truthlocks génère un jeton de vérification unique pour votre domaine. Ajoutez un enregistrement TXT
enregistrez dans votre configuration DNS :

| Champ | Valeur |
| :- | :- |
| **Type** | `TXT` |
| **Nom** | `_truthlocks-verify` |
| **Valeur** | Le jeton de vérification affiché dans la console |

Copiez le jeton en utilisant le bouton **Copier** à côté.

**4. Vérifier le domaine**

Après avoir ajouté l'enregistrement DNS, cliquez sur **Vérifier l'enregistrement DNS** dans la console.
Truthlocks vérifie l'enregistrement TXT et met à jour le statut du domaine.

> [!TIP]
>
> La propagation DNS peut prendre jusqu'à 48 heures, bien que la plupart des fournisseurs propagent
> en quelques minutes. Si la vérification échoue, attendez quelques minutes et réessayez.

## Statuts de domaine

Chaque domaine passe par trois statuts :

| Statut | Signification |
| :- | :- |
| **En attente** | Le domaine a été ajouté mais l'enregistrement DNS n'a pas encore été vérifié. |
| **Vérifié** | L'enregistrement DNS TXT a été trouvé et validé. Le domaine devient actif automatiquement. |
| **Actif** | Le domaine est en ligne et sert du trafic pour votre locataire. |

## Gestion des domaines via l'API

Vous pouvez ajouter, lister et vérifier des domaines personnalisés par programmation.

### Lister les domaines

```http Request theme={null}
GET /v1/settings/domains
X-API-Key: tl_live_...
```

```json Response theme={null}
{
  "domains": [
    {
      "id": "dom_abc123",
      "tenant_id": "tn_xyz789",
      "type": "VERIFY",
      "hostname": "verify.acme.com",
      "status": "ACTIVE",
      "verification_token": "tl-verify-abc123def456",
      "verified_at": "2026-03-25T14:30:00Z",
      "created_at": "2026-03-25T14:00:00Z"
    }
  ]
}
```

### Ajouter un domaine

```http Request theme={null}
POST /v1/settings/domains
X-API-Key: tl_live_...
Content-Type: application/json

{
  "type": "VERIFY",
  "hostname": "verify.acme.com"
}
```

Le champ `type` accepte `VERIFY` pour les domaines de vérification ou `CONSOLE` pour les domaines de console. La réponse inclut le `verification_token` dont vous avez besoin pour la configuration DNS.

### Vérifier un domaine

```http Request theme={null}
POST /v1/settings/domains/{domain_id}/verify
X-API-Key: tl_live_...
```

Renvoie l'objet de domaine mis à jour. Si l'enregistrement DNS n'est pas trouvé, le statut reste `PENDING`.

## Exemple : configuration complète

```bash theme={null}
# 1. Add the domain
curl -X POST https://api.truthlocks.com/v1/settings/domains \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{"type": "VERIFY", "hostname": "verify.acme.com"}'

# 2. Add the TXT record to your DNS (using your DNS provider)
# Name:  _truthlocks-verify
# Value: <verification_token from response>

# 3. Verify the domain
curl -X POST https://api.truthlocks.com/v1/settings/domains/dom_abc123/verify \
  -H "X-API-Key: tl_live_..."
```

## Dépannage

### La vérification échoue continuellement

1. Confirmez que le nom de l'enregistrement TXT est exactement `_truthlocks-verify` (certains fournisseurs ajoutent automatiquement le domaine — vérifiez les doublons comme `_truthlocks-verify.yourdomain.com.yourdomain.com`).
2. Attendez la propagation DNS. Utilisez `dig TXT _truthlocks-verify.yourdomain.com` pour confirmer que l'enregistrement est visible.
3. Assurez-vous que la valeur TXT correspond exactement au jeton affiché dans la console, sans espaces supplémentaires.

### Le domaine est vérifié mais non actif

Les domaines vérifiés passent automatiquement à l'état Actif. Si le statut ne se met pas à jour, actualisez la page ou récupérez-le via l'API.

## Lié

> [card] [Marque personnalisée](https://docs.truthlocks.com/guides/enterprise-branding.md)
>
> Téléchargez des logos et définissez les couleurs de la marque pour les pages de vérification et les e-mails.

> [card] [Livraison d'e-mails](https://docs.truthlocks.com/security/email-delivery.md)
>
> Configurez des expéditeurs d'e-mails personnalisés et des serveurs SMTP.


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