Een DigitalOcean-API-token aanmaken

Een korte handleiding voor iedereen die DigitalOcean liever verbindt met een handmatig aangemaakt API-token in plaats van de één-klik-optie. Bedoeld voor InfraNest-gebruikers die DNS beheren via DigitalOcean.

Overzicht

• Dit heb je alleen nodig als je liever geen gebruik maakt van Connect with DigitalOcean, wat hetzelfde doet zonder token.
• Als je toch een token wilt, duurt het aanmaken ongeveer een minuut.
• Je plakt het token in InfraNest om het koppelen van het account af te ronden.

Het token aanmaken

1. Meld je aan bij DigitalOcean.
2. Open de tokenpagina — de link Open token page op het InfraNest-koppelscherm brengt je er direct naartoe, of gebruik het menu links: API (helemaal onderaan), en dan het tabblad Tokens.
3. Selecteer Generate New Token.
4. Geef het een naam die je herkent, zoals InfraNest.
5. Kies een verloopdatum (expiry). Lees de opmerking hieronder voordat je een keuze maakt.
6. Kies de scopes — Full Access is prima, of bekijk de lijst hieronder voor een beperkter token.
7. Selecteer Generate Token en kopieer de waarde. Deze begint met dop_v1_.
8. Plak deze in InfraNest — zie Connect DigitalOcean.

WarningHet token wordt maar één keer weergegeven. Als je wegnavigeert zonder het te kopiëren, maak dan een nieuw token aan in plaats van te proberen het opnieuw te vinden.

Welke scopes nodig zijn

Full Access werkt en is de snelste keuze. Als je liever alleen geeft wat InfraNest gebruikt, kies dan Custom Scopes en vink aan:

• domain — read, create, update en delete. Dit is DNS: het lezen van je zones en records, en het opslaan van wijzigingen die je in InfraNest maakt.
• certificate — read. Dit is de certificatenlijst. Alleen lezen; InfraNest wijzigt nooit een certificaat bij DigitalOcean.

Meer is niet nodig. Een token zonder de update- en delete-scopes voor domain toont je records perfect en weigert daarna elke bewerking, wat een verwarrende manier is om dat te ontdekken.

NoteIn tegenstelling tot sommige providers kan DigitalOcean deze niet automatisch aanvinken vanuit een link — het koppelscherm toont ze naast de knop, zodat je de selectie zelf kunt overnemen.

Over de verloopdatum

DigitalOcean vraagt je hoe lang het token geldig moet zijn, en de standaardwaarde is niet "voor altijd". Wanneer het verloopt, stoppen je zones met synchroniseren en stuurt InfraNest je een e-mail dat de integratie een probleem heeft — het is niet defect, het heeft alleen een nieuw token nodig.

Kies No expiry, of zet de datum in je agenda zodat je het kunt vervangen voordat het verloopt.

Een token vervangen

1. Maak eerst het nieuwe token aan (volg de stappen hierboven).
2. Open Integrations → DigitalOcean.
3. Selecteer Reconnect om het nieuwe token te plakken.
4. Verwijder daarna het oude token bij DigitalOcean.

Alles wat je in InfraNest hebt ingesteld, blijft ongewijzigd — de verbinding behoudt zijn zones, geschiedenis en instellingen.