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

Ce que cette connexion vous apporte

Connecter votre propre compte Hetzner permet de diffuser le DNS d’un domaine depuis votre compte au lieu du nôtre. Vous conservez la zone, la facturation 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 avec vos zones dans la Hetzner Console. Hetzner a intégré la gestion DNS dans la Hetzner Console, et l’ancienne DNS Console autonome utilise un type de jeton différent qui ne fonctionne plus pour cet usage — si vos zones s’y trouvent encore, transférez-les d’abord vers la Hetzner Console. Les jetons sont rattachés à un projet, veillez donc à utiliser le projet qui contient vos zones.

1. Créez la clé chez Hetzner

Dans la Hetzner Console, ouvrez le projet contenant vos zones, choisissez Security dans la barre latérale de gauche, puis API tokens en haut, et Generate API token. Donnez-lui une description, choisissez Read & Write — un jeton en lecture seule peut lister vos zones mais ne peut modifier aucun enregistrement — puis générez-le. Copiez le jeton : Hetzner ne l’affichera plus une fois la fenêtre fermée.

2. Connectez-le ici

Ouvrez Integrations dans votre tableau de bord et choisissez Connect an account. Sélectionnez Your own DNS comme groupe et Hetzner DNS comme compte, renseignez API token, puis appuyez sur Connect account.

Nous testons ce que vous collez avant tout enregistrement. Une clé qui ne fonctionne pas n’est jamais stockée, et la réponse indique l’anomalie détectée. Une clé fonctionnelle est conservée sous forme chiffrée dans notre coffre-fort de secrets — jamais dans notre base de données — et n’est plus jamais affichée, même à vous.

Les étapes suivantes

• Sur n’importe quel domaine, ouvrez son onglet DNS et désignez ce compte comme source de diffusion du DNS du domaine. Nous y créons la zone si elle n’existe pas et inscrivons les enregistrements requis par les sites et la messagerie du domaine.
• Lorsqu’une modification de notre côté exige la mise à jour 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 la transition, les serveurs de noms de votre domaine doivent pointer vers Hetzner. Si le domaine est enregistré chez nous, ou auprès d’un bureau d’enregistrement que vous avez connecté, nous les configurons pour vous ; sinon, la page du domaine indique les serveurs de noms à définir.
• 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 éléments confirmés.

En cas d’échec de la connexion

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

Les modifications d’enregistrements sont refusées. Le jeton a été créé avec le droit Read. Générez un jeton Read & Write et connectez-le.

Un message indique que la clé a été rejetée. Il s’agit presque toujours de l’une de ces trois raisons : un espace ou un saut de ligne copié par inadvertance, une clé expirée, ou une clé révoquée ou régénérée après votre copie. Créez-en une nouvelle et collez-la à nouveau.

La connexion s’établit, mais une action ultérieure échoue. La clé s’authentifie mais ne dispose pas d’une autorisation requise pour l’action. Créez une nouvelle clé avec les autorisations mentionnées ci-dessus, puis déconnectez l’ancienne connexion et connectez la nouvelle clé.

Déconnexion

Ouvrez Integrations, localisez le compte et appuyez sur Disconnect. Cette opération supprime immédiatement la clé stockée. Tout élément qui l’utilisait s’interrompt lors de sa prochaine action, et les écrans dépendants le signalent plutôt que d’échouer de manière silencieuse.

La déconnexion n’annule pas ce qui a déjà été effectué — 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 chez le fournisseur ; la déconnexion supprime notre copie, pas la leur.