Einen Porkbun-API-Schlüssel erstellen

Einen Porkbun-API-Schlüssel zu erstellen dauert nur eine Minute, aber ein zusätzlicher Schritt bringt fast alle zum Stolpern — hör also nicht auf, sobald du deinen Schlüssel kopiert hast.

#Überblick

• InfraNest verbindet sich mit Porkbun über einen API-Schlüssel und einen geheimen API-Schlüssel, beide werden auf der Porkbun-Website selbst erstellt.
• Das Erstellen des Schlüssels ist nur die halbe Arbeit — Porkbun verlangt außerdem, dass du den API-Zugriff für jede Domain separat aktivierst.
• Optional kannst du den Schlüssel weiter einschränken oder Ausgabenlimits festlegen, beides ist für den Einstieg aber nicht erforderlich.

#Den Schlüssel erstellen

1. Melde dich bei Porkbun an.
2. Gehe zu Account → API Access (porkbun.com/account/api).
3. Wähle Create API Key und gib ihm einen Namen, den du wiedererkennst, zum Beispiel InfraNest.
4. Porkbun zeigt dir einen API-Schlüssel, der mit pk1_ beginnt, und einen geheimen API-Schlüssel, der mit sk1_ beginnt.
5. Kopiere beide und füge sie in InfraNest ein — siehe Connect Porkbun.

WarningDer geheime Schlüssel wird nur einmal angezeigt. Wenn du ihn verlierst, erstelle ein neues Schlüsselpaar, anstatt zu versuchen, ihn wiederherzustellen.

#API-Zugriff für deine Domains aktivieren

Das ist der Schritt, den die meisten übersehen. Das Erstellen eines Schlüssels allein erlaubt ihm noch nicht, irgendetwas an deinen Domains zu ändern. Porkbun steuert den API-Zugriff pro Domain, und er ist standardmäßig deaktiviert.

Das Symptom ist eindeutig, sobald man es kennt: Alle deine Domains erscheinen ganz normal in InfraNest, und dann wird jede einzelne Änderung, die du versuchst — Nameserver, automatische Verlängerung, ein DNS-Eintrag — abgelehnt. Mit deinem Schlüssel ist dabei nichts falsch.

Es gibt zwei Möglichkeiten, das zu beheben:

1. Alles auf einmal (empfohlen). Aktiviere auf derselben Seite Account → API Access die Option Opt In All Domains. Neue Domains, die du später registrierst, werden dann automatisch einbezogen.
2. Eine Domain nach der anderen. Öffne in deiner Domainliste unter porkbun.com/account eine Domain und schalte deren API Access-Schalter ein.

InfraNest markiert jede Domain, die noch nicht freigegeben ist, mit einer Meldung, die erklärt, was falsch ist und was zu tun ist. Wenn du also nur einen Teil erledigt hast, siehst du, welche noch übrig sind.

#Optional: den Schlüssel einschränken

Porkbun kann einen Schlüssel weiter einschränken. Beide Einstellungen sind optional und standardmäßig deaktiviert, es sei denn, du schaltest sie ein — du findest sie hinter dem Zahnrad-Symbol neben dem Schlüssel auf der Seite API Access.

• Source IP allowlist — akzeptiert nur Anfragen von bestimmten Adressen. Lass dies leer: InfraNest verbindet sich nicht von einer festen Adresse aus, daher kann mit einer Allowlist jede Anfrage abgelehnt werden, egal wie korrekt dein Schlüssel ist.
• Target domain allowlist — erlaubt dem Schlüssel nur, bestimmte Domains zu verändern. Es handelt sich um eine exakte Übereinstimmung, daher deckt die Angabe von example.com keine andere Domain ab, die dir gehört.

Wenn du dir nicht sicher bist, lass beides leer. Das ist Porkbuns Standardeinstellung und sie funktioniert.

#Optional: Ausgabenkontrollen

Porkbun bucht vom Guthaben deines vorausbezahlten Kontos ab, und dieselbe Seite API Access kann begrenzen, wie viel ein Schlüssel pro Monat ausgeben darf, und dich per E-Mail benachrichtigen, wenn das Guthaben unter einen von dir gewählten Betrag fällt. InfraNest liest beide Werte aus und zeigt sie bei der Verbindung an, damit dich ein hier festgelegtes Monatslimit später nicht überrascht.

NoteEin monatliches Ausgabenlimit lehnt Abbuchungen ab, selbst wenn dein Guthaben in Ordnung ist. Wenn eine Verlängerung fehlschlägt und das Guthaben gut aussieht, überprüfe diese Einstellung.

#Fehlerbehebung

• Jede Änderung wird abgelehnt, aber der Schlüssel sieht in Ordnung aus — du hast wahrscheinlich den oben beschriebenen Schritt zum domainweisen API-Zugriff übersprungen. Prüfe Opt In All Domains oder den API Access-Schalter jeder einzelnen Domain.
• Die Verlängerung schlägt fehl, obwohl dein Guthaben gut aussieht — prüfe, ob für den Schlüssel ein monatliches Ausgabenlimit festgelegt ist.