Een Porkbun-API-key aanmaken

Dit artikel laat zien hoe je een Porkbun-API-key en secret key aanmaakt zodat InfraNest je domeinen kan beheren — voor iedereen die een Porkbun-account koppelt aan InfraNest.

Overzicht

• InfraNest maakt verbinding met Porkbun met behulp van twee gegevens: een API-key en een secret API-key.
• Het aanmaken van het sleutelpaar duurt maar een minuutje, maar er is een tweede, gemakkelijk te missen stap die uitgevoerd moet worden voordat InfraNest daadwerkelijk iets aan je domeinen kan wijzigen.
• Je kunt de key optioneel ook verder beveiligen en uitgavenlimieten instellen, allebei vanaf dezelfde Porkbun-pagina.

De key aanmaken

1. Meld je aan bij Porkbun.
2. Ga naar Account → API Access (porkbun.com/account/api).
3. Selecteer Create API Key en geef hem 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 secret key wordt maar één keer getoond. Als je hem verliest, maak dan een nieuw sleutelpaar aan in plaats van te proberen hem te herstellen.

API-toegang inschakelen voor je domeinen

Dit is de stap die mensen missen. Het aanmaken van een key geeft die op zichzelf nog geen toestemming om iets aan je domeinen te wijzigen. Porkbun regelt API-toegang per domein, en die staat standaard uit.

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

Je hebt twee manieren om dit op te lossen:

1. Allemaal in één keer (aanbevolen). Op dezelfde Account → API Access-pagina schakel je Opt In All Domains in. Nieuwe domeinen die je later registreert, worden dan automatisch meegenomen.
2. Per domein. Open in je domeinlijst op porkbun.com/account een domein en schakel de API Access-toggle in.

InfraNest markeert elk domein dat nog niet is opgenomen met een NO API-vlag en legt uit wat je moet doen, zodat je kunt zien welke domeinen er nog over zijn als je maar een deel hebt gedaan.

De key beperken (optioneel)

Porkbun kan een key verder beveiligen. Beide instellingen zijn optioneel en staan uit totdat je ze inschakelt — je vindt ze achter het tandwielicoon naast de key op de API Access-pagina.

1. Source IP allowlist — accepteer alleen aanvragen van bepaalde adressen. Als je dit instelt, voeg dan het IP-adres toe dat InfraNest's Porkbun-koppelformulier laat zien, anders wordt elke aanvraag geweigerd, hoe correct je key ook is.
2. Target domain allowlist — sta de key alleen toe om bepaalde domeinen aan te raken. Dit is een exacte match, dus het opgeven van example.com dekt geen ander domein dat je bezit.

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

Uitgavenlimieten instellen (optioneel)

Porkbun geeft uit van het prepaid tegoed van je account, en dezelfde API Access-pagina kan beperken hoeveel een key per maand mag uitgeven en je een e-mail sturen wanneer het tegoed 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, ook als je tegoed gezond is. Als een verlenging mislukt en het tegoed er goed uitziet, controleer dan deze instelling.

Tips

• Geef je key een herkenbare naam, zoals InfraNest, zodat je hem later kunt identificeren als je meerdere keys beheert.
• Door Opt In All Domains in te schakelen, hoef je de per-domeinstap niet steeds te herhalen wanneer je een nieuw domein registreert.

Problemen oplossen

• Elke wijziging wordt geweigerd, maar de key ziet er correct uit: dit betekent bijna altijd dat API-toegang nog uitstaat voor dat domein. Controleer de NO API-vlag die InfraNest toont en schakel API Access in voor het domein, of gebruik Opt In All Domains.
• Aanvragen worden geweigerd, ondanks dat de key correct is: controleer of er een Source IP allowlist is ingesteld op de key — die blokkeert alles tenzij het IP-adres van InfraNest is toegevoegd.
• Een verlenging mislukt en je tegoed lijkt in orde: controleer de maandelijkse uitgavenlimiet onder de uitgavenlimieten op de API Access-pagina.