Een Porkbun API-sleutel aanmaken

Het aanmaken van een Porkbun API-sleutel duurt maar een minuutje, maar één extra stap struikelt bijna iedereen — stop dus niet zodra je je sleutel hebt gekopieerd.

#Overzicht

• InfraNest maakt verbinding met Porkbun via een API-sleutel en een geheime API-sleutel, beide aangemaakt op de eigen site van Porkbun.
• Het aanmaken van de sleutel is maar de helft van het werk — Porkbun vereist ook dat je API-toegang apart inschakelt voor elk domein.
• Je kunt de sleutel optioneel verder beperken of uitgavenlimieten instellen, maar geen van beide is nodig om te beginnen.

#De sleutel aanmaken

1. Meld je aan bij Porkbun.
2. Ga naar Account → API Access (porkbun.com/account/api).
3. Selecteer Create API Key en geef deze een naam die je herkent, zoals InfraNest.
4. Porkbun toont je een API-sleutel die begint met pk1_ en een geheime API-sleutel die begint met sk1_.
5. Kopieer beide en plak ze in InfraNest — zie Connect Porkbun.

WarningDe geheime sleutel wordt eenmalig getoond. Als je hem kwijtraakt, maak dan een nieuw sleutelpaar aan in plaats van te proberen hem te herstellen.

#API-toegang voor je domeinen inschakelen

Dit is de stap die mensen missen. Het aanmaken van een sleutel zorgt er op zich niet voor dat deze iets met je domeinen kan doen. Porkbun regelt API-toegang per domein, en die staat standaard uit.

Het symptoom is onmiskenbaar zodra je het herkent: al je domeinen verschijnen gewoon netjes in InfraNest, en vervolgens wordt elke wijziging die je probeert — nameservers, automatisch verlengen, een DNS-record — geweigerd. Er is niets mis met je sleutel.

Je hebt twee manieren om dit op te lossen:

1. Alles in één keer (aanbevolen). Zet op dezelfde pagina Account → API Access Opt In All Domains aan. Nieuwe domeinen die je later registreert, worden dan automatisch meegenomen.
2. Eén domein tegelijk. Open in je domeinlijst op porkbun.com/account een domein en zet de API Access-schakelaar aan.

InfraNest markeert elk domein dat nog niet is opgenomen met een bericht dat uitlegt wat er mis is en wat je moet doen, zodat je kunt zien welke domeinen nog over zijn als je er maar een deel hebt gedaan.

#Optioneel: de sleutel beperken

Porkbun kan een sleutel verder vergrendelen. Beide instellingen zijn optioneel en staan uit tenzij je ze inschakelt — je vindt ze achter het tandwielicoon naast de sleutel op de pagina API Access.

• Source IP allowlist — accepteer alleen verzoeken van bepaalde adressen. Laat dit leeg: InfraNest maakt geen verbinding vanaf één vast adres, dus met een allowlist kan elk verzoek worden geweigerd, hoe correct je sleutel ook is.
• Target domain allowlist — sta de sleutel alleen toe op bepaalde domeinen. Dit is een exacte match, dus het vermelden van example.com dekt geen enkel ander domein dat je bezit.

Als je het niet zeker weet, laat beide dan leeg. Dat is de standaardinstelling van Porkbun en die werkt prima.

#Optioneel: uitgavenbeheer

Porkbun put uit het vooruitbetaalde tegoed van je account, en dezelfde pagina API Access kan beperken hoeveel een sleutel per maand mag uitgeven en je per e-mail waarschuwen zodra het saldo onder een door jou gekozen bedrag zakt. InfraNest leest beide waarden uit en toont ze bij de koppeling, zodat een maandlimiet die je hier instelt je later niet verrast.

NoteEen maandelijkse uitgavenlimiet weigert kosten, zelfs als je saldo gezond is. Als een verlenging mislukt terwijl het saldo er goed uitziet, controleer dan deze instelling.

#Problemen oplossen

• Elke wijziging wordt geweigerd, maar de sleutel lijkt in orde — je hebt waarschijnlijk de stap voor API-toegang per domein hierboven overgeslagen. Controleer Opt In All Domains of de API Access-schakelaar van elk domein.
• Verlenging mislukt terwijl je saldo er goed uitziet — controleer of er een maandelijkse uitgavenlimiet is ingesteld op de sleutel.