Een Cloudflare API-token aanmaken

DNSense praat met Cloudflare via een API-token. Maak er een met beperkte rechten. De oude Global API key werkt ook, maar die geeft volledige toegang tot elk account waar je lid van bent. Een uitgelekte sleutel is dan een veel groter probleem dan een uitgelekt token.

Wat het token nodig heeft

• Zone: Read zodat DNSense je zones kan opvragen.
• DNS: Edit zodat het records kan wijzigen.
• Domain: Read, alleen als je ook domeinen bij Cloudflare Registrar wilt zien.

Het token aanmaken

1. Open het Cloudflare-dashboard en ga naar My Profile > API Tokens. Accounteigenaren kunnen onder Manage Account ook een account-token maken, dat niet aan één persoon hangt.
2. Klik op Create Token. Begin met de template Edit zone DNS, of kies Create Custom Token.
3. Geef het een naam die je later herkent, zoals dnsense.
4. Controleer de rechten. Voeg Zone > Zone > Read toe als de template die mist.
5. Kies bij Zone Resources welke zones DNSense mag aanraken. All zones is het eenvoudigst. Eén zone kan ook, maar dan ziet DNSense alleen die.

6. Laat het IP-filter leeg, tenzij je weet vanaf welk adres DNSense verbindt. Een filter dat niet klopt laat elke aanroep falen.
7. Ga door naar het overzicht en lees het één keer na.

8. Klik op Create Token.

Kopieer het nu

Cloudflare toont het token één keer. Kopieer het voordat je de pagina sluit. Op het scherm staat ook een curl-commando om het token te testen. Voer dat gerust uit.

Koppelen aan DNSense

Voeg een koppeling toe, kies Cloudflare en de optie API token. Plak het token. Het veld Account ID is optioneel, laat het leeg tenzij je DNSense tot één account wilt beperken. Raak je het token kwijt, maak dan een nieuw token en vervang de gegevens op de bestaande koppeling. Verwijderen hoeft niet.