Statische IP für API-Allowlist: eine feste IPv4, der Ihre Partner vertrauen können

Warum verlangen APIs und Firewalls eine statische IP?

APIs und Firewalls verlangen eine statische IP, weil eine bekannte Quelladresse eine einfache zweite Prüfung zusätzlich zu einem Schlüssel oder Passwort ist. Wenn ein Schlüssel durchsickert, wird eine Anfrage von einer unbekannten Adresse trotzdem abgelehnt.

Häufige Einsatzorte einer IP-Allowlist:

• Partner- und Lieferanten-APIs: Logistik, Lagerbestand, Großhandelskataloge und Daten-Feeds.
• B2B-Dashboards, die Anmeldungen nur von registrierten Adressen eines Kunden akzeptieren.
• Cloud-Firewalls und Security Groups, die SSH, einen Datenbank-Port oder ein Admin-Panel für gelistete IPs öffnen.
• Staging- und Preview-Server, die nicht öffentlich sein sollten.
• SaaS-Admin-Konsolen mit optionaler Einstellung „vertrauenswürdige IPs“.

Heim- und Büroanschlüsse wechseln häufig die Adresse, und Cloud-Funktionen oder CI-Runner nutzen gemeinsam genutzte, wechselnde Bereiche. Eine gemietete IP gibt allen einen stabilen Ausgang.

Welche zwei Allowlists sind beteiligt?

In diesem Setup treffen zwei verschiedene Allowlists aufeinander, und ihre Verwechslung ist die häufigste Support-Frage.

Wenn Ihre Maschinen wechselnde Adressen haben, überspringen Sie die Proxy-Allowlist und nutzen Sie stattdessen Benutzername und Passwort. Benutzername und Passwort oder eine IP-Allowlist (bis zu 10 IPs).

Wie leite ich API-Aufrufe über die statische IP?

Leite API-Aufrufe über die statische IP, indem du sie als HTTP(S)- oder SOCKS5-Proxy des Clients festlegst, der die API aufruft. Die meisten HTTP-Bibliotheken, curl und viele Tools lesen eine Proxy-Einstellung oder die Umgebungsvariable HTTPS_PROXY. Bestätige zuerst die Exit-Adresse mit einem öffentlichen Echo-Dienst und rufe dann die Partner-API auf. Die folgenden Adressen sind Dokumentationsbeispiele; deine echte IP, dein Port und deine Zugangsdaten stehen in deinem Konto.

# 1. The address the partner will see
curl -x http://USERNAME:[email protected]:8000 https://api.ipify.org

# 2. Same proxy for every tool in this shell
export HTTPS_PROXY=http://USERNAME:[email protected]:8000
curl -H "Authorization: Bearer $PARTNER_TOKEN" https://example.com/api/v1/orders

Was passiert mit der Allowlist, wenn die Miete endet?

Die Allowlist funktioniert weiter, solange du dieselbe IP behältst, also verlängere vor dem Enddatum. Jede Miete dauert 30 Tage ab Bereitstellung. Verlängere in deinem Konto vor dem Enddatum; die Beibehaltung derselben IPs nach Ablauf einer Miete ist nicht garantiert.

Eine sichere Routine für allowlistierten Zugriff:

1. Miete zwei IPs, nicht eine. Gib dem Partner beide Adressen. Muss eine ersetzt werden, läuft die Integration über die andere weiter.
2. Notiere das Enddatum, das neben jeder IP in deinem Konto angezeigt wird, und verlängere ein paar Tage früher.
3. Halte den Änderungsprozess des Partners bereit. Wisse, wer seine Allowlist aktualisiert und wie lange das dauert.
4. Teste nach jeder Verlängerung mit dem oben genannten Echo-Aufruf.

Wenn eine IP nicht funktioniert oder für eine rechtmäßige Nutzung unbrauchbar ist, schreib dem Support: Wir reparieren sie oder ersetzen sie durch eine IP im selben Land, abhängig vom Bestand. Eine Ersatz-IP ist eine neue Adresse, also braucht sie einen neuen Allowlist-Eintrag.

Wann ist eine gemietete Proxy-IP die falsche Wahl?

Eine gemietete Proxy-IP ist die falsche Wahl, wenn der Dienst, den du erreichen willst, auf unserer Sperrliste steht oder eine dauerhafte Adresse benötigt. Banking-, Behörden- und Zahlungsportal-Websites sind auf jeder IP gesperrt, daher sind Allowlists für Bank- und Zahlungs-APIs keine Nutzung, die wir unterstützen.

Ziehe auch andere Optionen in Betracht, wenn:

• Du eigene Server in der Cloud betreibst: Eine statische Adresse von deinem Cloud-Anbieter, an dein eigenes NAT-Gateway gebunden, hält den Traffic innerhalb deiner Infrastruktur.
• Du IPv6 brauchst: Nur IPv4. IPv6-Proxys werden noch nicht verkauft.
• Du dieselbe Adresse über Jahre brauchst: Eine 30-Tage-Miete lässt sich verlängern, aber es ist keine Adresszuweisung, die dir gehört.