# Ajouter un domaine personnalisé

> Déclarer votre domaine dans l'architecture de l'app et confier à Wakastart une clé API de votre fournisseur DNS pour qu'il écrive les enregistrements.

Pour servir votre application sur votre propre nom (`app.exemple.fr`), déclarez le domaine dans l'architecture puis enregistrez les identifiants de votre fournisseur DNS. Wakastart s'en sert pour écrire les enregistrements à chaque mise en ligne.

## Avant de commencer

- Votre zone DNS est hébergée chez **OVH**, **IONOS Cloud** ou **IONOS Hosting**, et elle existe déjà chez ce fournisseur.
- Vous pouvez créer une clé API chez ce fournisseur.
- Votre application a été créée par Wakastart. Contactez-nous si vous devez en ouvrir une.

## Préparer les identifiants de votre fournisseur

Créez chez votre fournisseur une clé qui autorise la lecture et la modification de la zone DNS. Notez les valeurs : elles ne seront plus affichables une fois enregistrées.

| Fournisseur dans la console | Champs demandés | Où les obtenir |
|---|---|---|
| **OVH** | **OVH Endpoint** (`ovh-eu`, `ovh-ca` ou `ovh-us`), **Application Key**, **Application Secret**, **Consumer Key** | Une application de l'API OVH, avec un jeton autorisé sur `/domain/zone/<votre-zone>/*` |
| **IONOS Cloud** | **API Token** | Un jeton de l'API IONOS Cloud ayant accès au service Cloud DNS |
| **IONOS Hosting** | **API Key** | Une clé de l'API développeur IONOS (en-tête `X-API-Key`) |

:::tip
Limitez la clé à la seule zone concernée. Si elle fuit, seule cette zone est exposée, et vous la révoquez sans toucher au reste de votre compte.
:::

## Déclarer le domaine

::::steps
### Ouvrir les domaines de l'app

Dans le menu, sous le nom de votre application, cliquez sur **Architecture**, puis sur **URLs**. En haut de la page **URLs publiques**, cliquez sur **Domaines**.

Résultat : la page **Domaines** affiche la carte **Domaines plateforme**, en lecture seule, et la carte **Domaines personnalisés**.

### Renseigner le domaine

Dans **Domaines personnalisés**, cliquez sur **Ajouter un domaine**. À l'étape 1/2 :

1. Dans **Nom de domaine**, saisissez le domaine, par exemple `exemple.fr`.
2. Dans **Provider DNS**, choisissez votre fournisseur.
3. Dans **Zone DNS**, saisissez le nom de la zone chez le fournisseur, en général identique au domaine.
4. Cliquez sur **Continuer**.

Résultat : le domaine est créé et le dialogue passe à l'étape 2/2.

### Enregistrer les identifiants

À l'étape 2/2, renseignez les champs de votre fournisseur, puis cliquez sur **Enregistrer**.

Résultat : le message **Credentials enregistrés** s'affiche. La colonne **Credentials DNS** affiche **Configuration en cours...**, puis **Credentials actifs**.
::::

:::note
Vous pouvez cliquer sur **Ignorer** à l'étape 2/2 et revenir plus tard : ouvrez le menu de la ligne du domaine, puis **Configurer les credentials**. Un domaine IONOS ne peut rien publier sans identifiants.
:::

## Remplacer les identifiants

Quand vous renouvelez la clé chez votre fournisseur :

1. Sur la page **Domaines**, ouvrez le menu de la ligne du domaine.
2. Cliquez sur **Mettre à jour les credentials** (ou **Reconfigurer** si la configuration a échoué).
3. Saisissez les nouvelles valeurs, puis cliquez sur **Enregistrer**.

Résultat : les nouvelles valeurs remplacent les anciennes. Révoquez ensuite l'ancienne clé chez votre fournisseur.

## Supprimer un domaine

Un domaine encore utilisé ne peut pas être supprimé : dans ce cas, l'action **Supprimer** est grisée et porte la mention **URLs actives**.

1. Supprimez d'abord les URLs, le domaine racine et les redirections qui l'utilisent.
2. Sur la page **Domaines**, ouvrez le menu de la ligne, puis cliquez sur **Supprimer**.
3. Confirmez dans le dialogue **Supprimer le domaine**.

Résultat : le message **Domaine supprimé** s'affiche.

## Vérifier le résultat

- La ligne du domaine affiche **Credentials actifs** dans la colonne **Credentials DNS**.
- Dans **Architecture > URLs**, le domaine apparaît dans le groupe **Domaines personnalisés** du champ **Domaine** quand vous créez une URL.

La première écriture DNS a lieu quand vous mettez une route en ligne : c'est elle qui confirme que la clé est valide.

## Dépannage

- **Échec de la configuration** dans la colonne **Credentials DNS** : voir [Les identifiants DNS restent en échec](/v1.0/domaines-et-urls/depannage#les-identifiants-dns-restent-en-échec).
- **Impossible de créer le domaine.** : le nom est peut-être déjà déclaré, par votre app ou par une autre. Voir [le dépannage](/v1.0/domaines-et-urls/depannage#impossible-de-créer-le-domaine).

## Voir aussi

- [DNS et certificats TLS](/v1.0/domaines-et-urls/certificats-et-dns)
- [Créer une URL et ses routes](/v1.0/domaines-et-urls/creer-une-url-et-ses-routes)
- [Exposer le domaine racine](/v1.0/domaines-et-urls/exposer-le-domaine-racine)
