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.
- Required access
- Administrateur client avec le droit « Infra Client » (profil Infra)
- Duration
- 10 min
This page has not been translated yet and is shown in French.
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
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 :
- Dans Nom de domaine, saisissez le domaine, par exemple
exemple.fr. - Dans Provider DNS, choisissez votre fournisseur.
- Dans Zone DNS, saisissez le nom de la zone chez le fournisseur, en général identique au domaine.
- 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 :
- Sur la page Domaines, ouvrez le menu de la ligne du domaine.
- Cliquez sur Mettre à jour les credentials (ou Reconfigurer si la configuration a échoué).
- 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.
- Supprimez d'abord les URLs, le domaine racine et les redirections qui l'utilisent.
- Sur la page Domaines, ouvrez le menu de la ligne, puis cliquez sur Supprimer.
- 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.
- 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.