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

Ce que cette connexion vous apporte

Connecter votre propre compte DigitalOcean 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 de messagerie, afin que vous n’ayez pas à les copier manuellement.

Avant de commencer

Un compte DigitalOcean avec vos domaines ajoutés sous Networking → Domains, ou prêts à être ajoutés.

1. Créez la clé chez DigitalOcean

Dans le panneau de configuration DigitalOcean, ouvrez API, puis l’onglet Tokens, et dans Personal access tokens, choisissez Generate New Token. Nommez-le, choisissez une date d’expiration et attribuez-lui les droits Full Access — ou, avec Custom Scopes, les accès en lecture et en écriture aux domaines. Cliquez sur Generate Token et copiez-le ; DigitalOcean ne l’affiche qu’une seule fois.

2. Connectez-la ici

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

Nous testons ce que vous collez avant que quoi que ce soit ne soit enregistré. Une clé qui ne fonctionne pas n’est jamais stockée, et la réponse indique la cause de l’erreur. Une clé fonctionnelle est conservée chiffrée dans notre coffre-fort de secrets — jamais dans notre base de données — et ne sera plus jamais affichée, même à vous.

Ce qui se passe ensuite

• Sur n’importe quel domaine, ouvrez son onglet DNS et choisissez ce compte comme emplacement à partir duquel le DNS du domaine est diffusé. Nous y créons la zone si elle n’existe pas et écrivons les enregistrements nécessaires aux sites et à la messagerie du domaine.
• Quand un élément de notre côté modifie le contenu requis d’un enregistrement — vous déplacez un site, changez de CDN ou ajoutez une boîte de messagerie —, nous mettons à jour l’enregistrement sur votre compte.
• Pour finaliser le transfert, les serveurs de noms de votre domaine doivent pointer vers DigitalOcean. 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 affiche les serveurs de noms à définir.
• Lorsque vous vous connectez, nous vérifions que la clé peut lister vos zones, lire les enregistrements et modifier les enregistrements. La liste de contrôle située à côté de la connexion indique ceux que nous avons pu confirmer.

En cas de problème de connexion

La connexion s’établit, puis la première modification d’enregistrement échoue. Le jeton est en lecture seule (Read Only). Un jeton en lecture seule se connecte avec succès, car le listage fonctionne ; générez-en un avec un accès en écriture.

Elle a cessé de fonctionner. Le jeton a atteint la date d’expiration que vous aviez choisie. Générez-en un nouveau.

Elle 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é avec la clé, une clé expirée, ou une clé révoquée ou régénérée après l’avoir copiée. 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 par l’action. Créez une nouvelle clé avec les autorisations listées ci-dessus, puis déconnectez l’ancienne connexion et connectez la nouvelle clé.

Déconnexion

Ouvrez Integrations, recherchez le compte et cliquez sur Disconnect. Cela supprime immédiatement la clé stockée. Tout élément qui l’utilisait s’arrêtera lors de sa prochaine action, et les écrans qui en dépendaient le signaleront plutôt que d’échouer silencieusement.

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