Aller au contenu

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.

GuideDéveloppeur
Accès requis
Administrateur client avec le droit « Infra Client » (profil Infra)
Durée
10 min
Voir en Markdown

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 consoleChamps demandésOù les obtenir
OVHOVH Endpoint (ovh-eu, ovh-ca ou ovh-us), Application Key, Application Secret, Consumer KeyUne application de l'API OVH, avec un jeton autorisé sur /domain/zone/<votre-zone>/*
IONOS CloudAPI TokenUn jeton de l'API IONOS Cloud ayant accès au service Cloud DNS
IONOS HostingAPI KeyUne clé de l'API développeur IONOS (en-tête X-API-Key)

Conseil

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

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

Voir aussi