Utilisez votre propre compte DNS Hetzner pour gérer le DNS de vos domaines

Ce que cela vous apporte

Connecter votre propre compte Hetzner permet de diffuser le DNS d'un domaine depuis votre compte plutôt que depuis le nôtre. Vous conservez la zone, la facture et le tableau de bord du fournisseur ; nous créons et mettons à jour les enregistrements nécessaires à vos sites et boîtes aux lettres, vous évitant ainsi de les copier manuellement.

Avant de commencer

Un compte Hetzner contenant vos zones dans la Hetzner Console. Hetzner a transféré le DNS vers la Hetzner Console, et l'ancienne console DNS autonome utilise un autre type de jeton qui ne fonctionne plus pour cette fonctionnalité — si vos zones s'y trouvent encore, déplacez-les d'abord vers la Hetzner Console. Les jetons appartiennent à un projet, veillez donc à utiliser celui qui contient vos zones.

1. Créer la clé chez Hetzner

Dans la Hetzner Console, ouvrez le projet qui contient vos zones, sélectionnez Sécurité dans la barre latérale de gauche, puis Jetons d'API en haut, et cliquez sur Générer un jeton d'API. Attribuez-lui une description, sélectionnez Lecture et écriture — un jeton en lecture seule peut lister vos zones mais ne peut pas modifier un enregistrement — puis générez-le. Copiez le jeton : Hetzner ne l'affichera plus une fois la fenêtre fermée.

2. La connecter ici

Ouvrez la section Intégrations de votre tableau de bord et sélectionnez Connecter un compte. Choisissez Votre propre DNS comme groupe et Hetzner DNS comme compte, renseignez le champ Jeton d'API, puis cliquez sur Connecter le compte.

Nous testons les données collées avant tout enregistrement. Une clé qui ne fonctionne pas n'est jamais stockée, et le message d'erreur indique ce qui n'allait pas. Une clé valide est conservée de manière chiffrée dans notre coffre-fort de secrets — jamais dans notre base de données — et n'est plus jamais affichée, pas même pour vous.

Ce qui se passe ensuite

• Sur n'importe quel domaine, ouvrez son onglet DNS et désignez ce compte comme l'emplacement de diffusion du DNS du domaine. Nous y créons la zone si elle n'existe pas et écrivons les enregistrements requis pour les sites et les e-mails du domaine.
• Lorsqu'un changement de notre côté modifie la valeur d'un enregistrement — déplacement d'un site, changement de CDN ou ajout d'une boîte aux lettres —, nous mettons à jour l'enregistrement sur votre compte.
• Pour finaliser le transfert, les serveurs de noms de votre domaine doivent pointer vers Hetzner. Si le domaine est enregistré chez nous ou auprès d'un registrar que vous avez connecté, nous les configurons pour vous ; sinon, la page du domaine indique les serveurs de noms à configurer.
• Lors de la connexion, nous vérifions que la clé peut lister vos zones, lire les enregistrements et les modifier. La liste de contrôle située à côté de la connexion indique les actions que nous avons pu confirmer.

En cas de problème de connexion

Vos zones n'apparaissent pas. Le jeton appartient à un autre projet, ou les zones se trouvent toujours dans l'ancienne console DNS. Générez le jeton dans le projet qui les contient.

Les modifications d'enregistrements sont refusées. Le jeton a été créé avec des droits de Lecture. Générez un jeton Lecture et écriture et connectez-le.

Le message indique que la clé a été rejetée. Cela provient presque toujours de l'une de ces trois causes : un espace ou un saut de ligne copié avec la clé, une clé expirée, ou une clé révoquée ou régénérée après sa copie. Créez une nouvelle clé et collez-la à nouveau.

La connexion réussit, mais une action ultérieure échoue. La clé s'authentifie mais ne dispose pas d'une permission requise par l'action. Créez une nouvelle clé dotée des permissions énumérées ci-dessus, puis déconnectez l'ancienne connexion et connectez la nouvelle clé.

Déconnexion

Ouvrez Intégrations, recherchez le compte et cliquez sur Déconnecter. Cette action supprime immédiatement la clé stockée. Toute opération en cours utilisant cette clé s'arrête lors de sa prochaine action, et les écrans qui en dépendaient l'indiquent clairement au lieu d'échouer silencieusement.

La déconnexion n'annule pas ce qui a déjà été fait — les enregistrements, déploiements ou paramètres modifiés sur votre compte restent inchangés. Si vous pensez que la clé elle-même a pu être compromise, révoquez-la également auprès du fournisseur ; la déconnexion supprime notre copie, pas la sienne.