Een Porkbun-API-sleutel aanmaken

Volg deze handleiding om een Porkbun-API-sleutel en geheime sleutel voor InfraNest aan te maken, en om ervoor te zorgen dat Porkbun die sleutel ook daadwerkelijk iets laat doen — een stap die bijna iedereen de eerste keer mist.

Overzicht

• Porkbun vereist twee gegevens — een API-sleutel en een Geheime API-sleutel — om InfraNest je domeinen te laten beheren.
• Het aanmaken van de sleutel duurt maar een minuut, maar Porkbun vereist ook dat je API-toegang voor je domeinen apart inschakelt, anders wordt elke wijziging die InfraNest probeert door te voeren, geweigerd.
• Je kunt de sleutel optioneel verder beperken met een IP-toegestaanlijst, een domein-toegestaanlijst en uitgavencontroles.

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 key die begint met pk1_ en een Secret API key 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.

Schakel daarna API-toegang in voor je domeinen

Dit is de stap die mensen missen. Het aanmaken van een sleutel zorgt op zichzelf niet 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 kent: 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. In één keer (aanbevolen). Schakel op dezelfde Account → API Access-pagina Opt In All Domains in. Nieuwe domeinen die je later registreert, worden dan automatisch meegenomen.
2. Per domein apart. Open in je domeinlijst op porkbun.com/account een domein en schakel de API Access-schakelaar ervan in.

InfraNest markeert elk domein dat nog is uitgesloten met een NO API-vlag en legt uit wat je moet doen, zodat je kunt zien welke domeinen nog overblijven als je er maar een deel van 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 API Access-pagina.

• Source IP allowlist — accepteer alleen aanvragen van bepaalde adressen. Als je dit instelt, voeg dan het IP-adres toe dat wordt getoond op het Porkbun-koppelformulier van InfraNest, anders wordt elke aanvraag geweigerd, hoe correct je sleutel ook is.
• Target domain allowlist — laat de sleutel alleen bepaalde domeinen beïnvloeden. Dit is een exacte overeenkomst, 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 Porkbuns standaardinstelling en die werkt prima.

Optioneel: uitgavencontroles

Porkbun geeft uit vanaf je vooruitbetaalde accounttegoed, en dezelfde API Access-pagina kan beperken hoeveel een sleutel per maand mag uitgeven en je per e-mail waarschuwen wanneer het tegoed onder een door jou gekozen bedrag komt. InfraNest leest beide waarden uit en toont ze bij de verbinding, zodat een maandlimiet die je hier instelt je later niet verrast.

NoteEen maandelijkse uitgavenlimiet weigert kosten, zelfs als je tegoed gezond is. Controleer deze instelling als een verlenging mislukt terwijl het tegoed in orde lijkt.