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
/8umfasst über 16 Millionen Adressen.