Einen Porkbun-API-Schlüssel erstellen

Dieser Artikel zeigt dir, wie du einen Porkbun-API-Schlüssel und einen geheimen Schlüssel erstellst, damit InfraNest deine Domains verwalten kann — für alle, die ein Porkbun-Konto mit InfraNest verbinden.

Übersicht

• InfraNest verbindet sich mit Porkbun über zwei Informationen: einen API-Schlüssel und einen geheimen API-Schlüssel.
• Das Erstellen des Schlüsselpaars dauert nur eine Minute, aber es gibt einen zweiten, leicht zu übersehenden Schritt, der erledigt werden muss, bevor InfraNest tatsächlich etwas an deinen Domains ändern kann.
• Du kannst den Schlüssel optional zusätzlich einschränken und Ausgabenkontrollen festlegen — beides auf derselben Porkbun-Seite.

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 key, der mit pk1_ beginnt, und einen Secret API key, 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, statt zu versuchen, ihn wiederherzustellen.

API-Zugriff für deine Domains aktivieren

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

Das Symptom ist unverkennbar, 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 — verweigert. Mit deinem Schlüssel ist alles in Ordnung.

Es gibt zwei Wege, das zu beheben:

1. Alle auf einmal (empfohlen). Aktiviere auf derselben Account → API Access-Seite 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 auf porkbun.com/account eine Domain und schalte deren API Access-Schalter ein.

InfraNest markiert jede Domain, die noch nicht freigeschaltet ist, mit einer NO API-Kennzeichnung und erklärt, was zu tun ist, sodass du sehen kannst, welche noch übrig sind, wenn du nur einige davon erledigt hast.

Schlüssel einschränken (optional)

Porkbun kann einen Schlüssel weiter einschränken. Beide Einstellungen sind optional und deaktiviert, bis du sie aktivierst — du findest sie hinter dem Zahnradsymbol neben dem Schlüssel auf der API Access-Seite.

1. Source IP allowlist — akzeptiert nur Anfragen von bestimmten Adressen. Wenn du dies einstellst, füge die IP-Adresse hinzu, die im Porkbun-Verbindungsformular von InfraNest angezeigt wird, sonst wird jede Anfrage verweigert, egal wie korrekt dein Schlüssel ist.
2. Target domain allowlist — erlaubt dem Schlüssel nur den Zugriff auf bestimmte Domains. 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, lasse beide leer. Das ist die Standardeinstellung von Porkbun und funktioniert.

Ausgabenkontrollen festlegen (optional)

Porkbun bucht Kosten von deinem vorausbezahlten Kontoguthaben ab, und dieselbe API Access-Seite 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, sodass ein hier festgelegtes Monatslimit dich später nicht überrascht.

NoteEin monatliches Ausgabenlimit verweigert Buchungen selbst dann, wenn dein Guthaben gesund ist. Wenn eine Verlängerung fehlschlägt und das Guthaben in Ordnung aussieht, überprüfe diese Einstellung.

Tipps

• Gib deinem Schlüssel einen wiedererkennbaren Namen wie InfraNest, damit du ihn später identifizieren kannst, wenn du mehrere Schlüssel verwaltest.
• Das Aktivieren von Opt In All Domains erspart dir, den Schritt pro Domain jedes Mal zu wiederholen, wenn du eine neue Domain registrierst.

Problembehandlung

• Jede Änderung wird verweigert, aber der Schlüssel scheint korrekt zu sein: Das bedeutet fast immer, dass der API-Zugriff für diese Domain noch deaktiviert ist. Überprüfe die von InfraNest angezeigte NO API-Kennzeichnung und aktiviere API Access für die Domain, oder verwende Opt In All Domains.
• Anfragen werden verweigert, obwohl der Schlüssel korrekt ist: Prüfe, ob eine Source IP allowlist für den Schlüssel gesetzt ist — sie blockiert alles, sofern die IP-Adresse von InfraNest nicht hinzugefügt wurde.
• Eine Verlängerung schlägt fehl und dein Guthaben sieht in Ordnung aus: Überprüfe das monatliche Ausgabenlimit unter den Ausgabenkontrollen auf der API Access-Seite.