BroadRouter
Loslegen

IP-Allowlist (IP allow list)

Aktualisiert

Eine IP-Allowlist ist eine Sicherheitskontrolle, die nur Anfragen von gelisteten IP-Adressen oder CIDR-Bereichen annimmt und alle anderen ablehnt. Bei einer API begrenzt sie den Schaden eines geleakten Schlüssels, weil der Schlüssel aus nicht gelisteten Netzen nicht funktioniert.

Auch genannt: IP-Allowlist, IP-Whitelist, IP-Freigabeliste, erlaubte IP-Adressen, IP-Beschränkung, IP allow list, IP allowlist, IP whitelist, allowed IPs, IP restriction, allowed_ips

Ein API-Schlüssel funktioniert standardmäßig von überall. Eine Allowlist bindet ihn an die Orte, an denen Ihr Code tatsächlich läuft.

So funktioniert es

Der Edge der API prüft die Quell-IP jeder Anfrage gegen eine Liste. Steht die Adresse auf der Liste oder liegt sie in einem gelisteten Bereich, geht die Anfrage weiter zur normalen Schlüsselprüfung. Andernfalls wird sie abgelehnt.

Bereiche werden in CIDR-Notation geschrieben: eine Adresse, ein Schrägstrich und eine Präfixlänge. RFC 4632 erklärt, dass die Präfixlänge angibt, wie viele führende Bits festgelegt sind. Für IPv4:

Eintrag Umfasst
203.0.113.7 eine Adresse
198.51.100.0/24 256 Adressen, 198.51.100.0 bis 198.51.100.255
10.0.0.0/16 65.536 Adressen

IPv6 nutzt dasselbe Prinzip mit 128-Bit-Adressen, etwa 2001:db8::/48.

Entscheidend ist Ihre Egress-IP: die öffentliche Adresse, von der der Traffic Ihres Servers ausgeht. Hinter NAT, einem Load Balancer oder einem Firmen-Proxy ist das oft nicht die Adresse, die der Rechner für sich selbst anzeigt.

Warum es wichtig ist

API-Schlüssel sind Bearer-Tokens: Wer einen besitzt, kann ihn nutzen. Schlüssel leaken über Commits, Logs, Screenshots und Laptops. Mit einer Allowlist scheitert ein gestohlener Schlüssel im Netz des Angreifers, und aus einem Leak mit Kostenfolgen wird ein Nicht-Ereignis. GitHub zum Beispiel wendet seine Allowlist auf API-Aufrufe und Personal Access Tokens ebenso an wie auf Web-Anmeldungen.

Der Preis ist etwas Betriebsaufwand. Jeder neue Server, jede Region und jeder CI-Runner braucht einen Eintrag für seine Egress-IP, und dynamische IPs brauchen einen festen Egress-Pfad.

Bei BroadNet Inference

Tragen Sie auf der Kontoseite eine IPv4- oder IPv6-Adresse oder einen CIDR-Bereich pro Zeile ein, bis zu 32 Einträge. Eine leere Liste bedeutet keine Einschränkung. Neue Schlüssel übernehmen die Liste des Kontos. Ein allowed_ips pro Schlüssel ersetzt sie für diesen Schlüssel:

curl -X POST https://inference.broadnet.ai/portal/keys \
  -H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL" \
  -H "Content-Type: application/json" \
  -d '{"label":"worker-1","allowed_ips":["203.0.113.7","198.51.100.0/24"]}'

Anfragen von anderen Adressen erhalten einen 403. Nach einer Änderung oder dem Widerruf eines Schlüssels werden neue Anfragen innerhalb von fünf Sekunden gestoppt. Alle Schritte stehen in API-Schlüssel und IP-Allowlists, die Fehlertabelle in Fehler und Retries. Das größere Bild zum Datenschutz zeigt die ZDR-Checkliste.

Häufige Fehler

  • Die private Adresse eines Servers, etwa 10.x.x.x, statt seiner öffentlichen Egress-IP einzutragen.
  • Einen sehr breiten Bereich einzutragen, damit die Fehler verschwinden. Ein /8 umfasst über 16 Millionen Adressen.

Häufige Fragen

Reicht eine IP-Allowlist, um einen API-Schlüssel zu schützen?

Nein. Sie ist eine Schutzschicht. Halten Sie Schlüssel trotzdem auf Servern und aus Code und Logs heraus, geben Sie jeder App einen eigenen Schlüssel und widerrufen Sie Schlüssel schnell, wenn sie leaken.

Meine Server laufen serverless oder mit Autoscaling. Kann ich trotzdem eine Allowlist nutzen?

Nur wenn der ausgehende Traffic von bekannten Adressen kommt. Leiten Sie ihn über ein NAT-Gateway oder einen Egress-Proxy mit festen IPs und tragen Sie diese ein.

Welchen Fehler bekomme ich von einer IP, die nicht auf der Liste steht?

Bei BroadNet Inference einen 403. Andere APIs geben typischerweise ebenfalls 403 zurück.

Als Markdown lesenChatGPT fragenClaude fragenPerplexity fragen