Créer un jeton d'API DigitalOcean

Un guide court pour les personnes qui préfèrent connecter DigitalOcean à l'aide d'un jeton d'API créé manuellement plutôt que via l'option en un clic. Il s'adresse aux utilisateurs d'InfraNest qui gèrent le DNS via DigitalOcean.

Aperçu

• Vous n'en avez besoin que si vous préférez ne pas utiliser Connect with DigitalOcean, qui fait la même chose sans jeton.
• Si vous voulez tout de même un jeton, sa création prend environ une minute.
• Vous coller le jeton dans InfraNest pour finaliser la connexion du compte.

Créer le jeton

1. Connectez-vous à DigitalOcean.
2. Ouvrez la page des jetons — le lien Open token page sur l'écran de connexion InfraNest vous y amène directement, ou utilisez le menu de gauche : API (tout en bas), puis l'onglet Tokens.
3. Sélectionnez Generate New Token.
4. Donnez-lui un nom que vous reconnaîtrez, par exemple InfraNest.
5. Choisissez une date d'expiration (expiry). Consultez la remarque ci-dessous avant de faire votre choix.
6. Choisissez les scopes — Full Access convient, ou consultez la liste ci-dessous pour un jeton plus restreint.
7. Sélectionnez Generate Token, puis copiez la valeur. Elle commence par dop_v1_.
8. Collez-la dans InfraNest — voir Connect DigitalOcean.

WarningLe jeton n'est affiché qu'une seule fois. Si vous quittez la page sans le copier, générez-en un nouveau plutôt que d'essayer de le retrouver.

Scopes nécessaires

Full Access fonctionne et constitue le choix le plus rapide. Si vous préférez n'accorder que ce qu'InfraNest utilise réellement, choisissez Custom Scopes et cochez :

• domain — read, create, update et delete. Il s'agit du DNS : la lecture de vos zones et enregistrements, et l'enregistrement des modifications que vous effectuez dans InfraNest.
• certificate — read. Il s'agit de la liste des certificats. Lecture uniquement ; InfraNest ne modifie jamais un certificat chez DigitalOcean.

Rien d'autre n'est nécessaire. Un jeton sans les scopes update et delete pour domain affichera parfaitement vos enregistrements puis refusera toute modification, ce qui est une manière déconcertante de le découvrir.

NoteContrairement à certains fournisseurs, DigitalOcean ne peut pas précocher ces cases depuis un lien — l'écran de connexion les répertorie à côté du bouton afin que vous puissiez reproduire la sélection vous-même.

À propos de l'expiration

DigitalOcean vous demande de choisir la durée de validité du jeton, et la valeur par défaut n'est pas « pour toujours ». Lorsqu'il expire, vos zones cessent de se synchroniser et InfraNest vous envoie un e-mail indiquant que l'intégration a un problème — elle n'est pas cassée, elle a simplement besoin d'un nouveau jeton.

Choisissez soit No expiry, soit notez la date dans votre calendrier afin de le remplacer avant son expiration.

Remplacer un jeton

1. Générez d'abord le nouveau jeton (suivez les étapes ci-dessus).
2. Ouvrez Integrations → DigitalOcean.
3. Sélectionnez Reconnect pour coller le nouveau jeton.
4. Supprimez ensuite l'ancien jeton chez DigitalOcean.

Rien de ce que vous avez configuré dans InfraNest n'est affecté — la connexion conserve ses zones, son historique et ses paramètres.