Een Cloudflare-API-token aanmaken

Het instellen van een Cloudflare-koppeling in InfraNest begint met het aanmaken van een API-token in je Cloudflare-account — dit artikel leidt je er doorheen.

#Overzicht

• InfraNest heeft een Cloudflare-API-token met de juiste rechten nodig om je DNS, certificaten en andere functies te beheren.
• Je kunt dit token in enkele seconden aanmaken via een vooringevulde link van het Cloudflare-koppelformulier van InfraNest, of het zelf samenstellen in Cloudflare.
• Welke rechten je toevoegt, bepaalt welke InfraNest-functies voor deze koppeling werken.

#Het token aanmaken

De snelste manier is om Open the token page — permissions pre-selected te selecteren op het Cloudflare-koppelformulier van InfraNest. Dit opent de tokeneditor van Cloudflare met de rechten al gekozen — als je deze link gebruikt, ga dan direct naar stap 5.

Om het token zelf aan te maken:

1. Meld je aan bij het Cloudflare dashboard.

2. Ga naar My Profile → API Tokens.

   

3. Selecteer Create Token, en vervolgens Create Custom Token.

4. Geef het token deze rechten:

   • Zone → Zone → Read en Zone → DNS → Edit — altijd nodig.
   • Zone → SSL and Certificates → Read — nodig voor de functie Certificates.
   • Account → Registrar: Domains → Admin — nodig voor de functie Registrar, als je domeinen bij Cloudflare hebt geregistreerd.
   • Zone → Zone Settings → Edit en Zone → Cache Purge → Purge — nodig als je wilt dat automatiseringen Cloudflare-instellingen wijzigen (beveiligingsniveau, development mode, Always Online) of je cache wissen.
   • Account → Workers Scripts → Read — nodig als je Cloudflare Workers gebruikt en wilt dat de hostnamen die ze bedienen worden weergegeven op de zonepagina. De vooringevulde link bevat deze niet, dus voeg hem zelf toe als je hem nodig hebt.

   

5. Kies onder Zone Resources voor All zones, of alleen de zones die je door InfraNest wilt laten beheren. Zones die je weglaat, worden niet geïmporteerd.

6. Selecteer Continue to summary, en vervolgens Create Token.

7. Kopieer het token meteen — Cloudflare toont het maar één keer.

   

WarningCloudflare toont het token slechts één keer. Als je wegnavigeert voordat je het hebt gekopieerd, moet je een nieuwe aanmaken.

#Waar de rechten voor dienen

• Zone:Read + DNS:Edit laten InfraNest je zones zien en records beheren.
• SSL and Certificates:Read laat InfraNest de certificaten op je zones weergeven.
• Workers Scripts:Read laat InfraNest de hostnamen weergeven waarvoor je Workers antwoorden. Dit zijn geen DNS-records, dus zonder dit recht verschijnen ze eenvoudigweg niet — verder heeft het nergens invloed op, en InfraNest behandelt het niet als een probleem.
• Zone Settings:Edit + Cache Purge zijn alleen nodig voor vier automatiseringsacties: het instellen van het beveiligingsniveau, de development mode of Always Online van een zone, en het wissen van de cache. DNS werkt prima zonder — die specifieke acties worden dan alleen niet uitgevoerd.
• Registrar: Domains laat InfraNest domeinen die bij Cloudflare zijn geregistreerd weergeven, registreren en beheren — transferlock, WHOIS-privacy en automatisch verlengen. Laat dit weg als je Cloudflare alleen voor DNS gebruikt.

#Controleren wat je token kan

1. Open het Cloudflare-account onder Integrations.
2. Bekijk het paneel Permission check — hierin staat wat bewezen werkt.
3. Bekijk Extras this key can unlock voor alles wat ontbreekt, samen met de acties die dit mogelijk zou maken.

NoteInfraNest voert deze controle uit wanneer je verbindt, opnieuw verbindt, en telkens wanneer je Check connection selecteert. Er worden alleen aanroepen gedaan die niets wijzigen — er wordt één adres gewist dat nooit gecachet was, en één instelling ingesteld op de waarde die hij al heeft.

Als je token is aangemaakt vóór augustus 2026, heeft het de rechten Zone Settings en Cache Purge niet, omdat die toen nog niet bestonden in InfraNest. Cloudflare kan geen recht toevoegen aan een bestaand token, dus moet je een nieuw token aanmaken met deze aangevinkt en plakken, of opnieuw verbinden als je oorspronkelijk hebt aangemeld met Cloudflare.

#Volgende stap

Ga terug naar InfraNest en volg Connect Cloudflare om het token te plakken.