Ein geleakter Schlüssel ist der häufigste Grund, warum eine API-Rechnung aus dem Ruder läuft. BroadNet Inference bietet Ihnen zwei Schutzmechanismen: eine IP-Allowlist und einen schnellen Widerruf.
Zwei Arten von Zugangsdaten
| Zugangsdaten | Wofür | Behandeln Sie es als |
|---|---|---|
| Inferenz-Schlüssel | Modellanfragen an /v1/* |
Geheimnis für eine App oder einen Agenten |
| Portal-Credential | Automatisierung des Kontos: Schlüssel, erlaubte IPs, Käufe | Volle Kontorechte |
Beide werden nur einmal angezeigt. Das Portal speichert nur einen SHA-256-Hash und kann den Schlüssel daher nicht noch einmal anzeigen. Ein Pay-as-you-go-Inferenz-Schlüssel gilt ein Jahr ab Erstellung, und ein Konto kann bis zu zehn aktive Schlüssel haben.
Eine Allowlist festlegen
Tragen Sie auf der Kontoseite pro Zeile eine IPv4- oder IPv6-Adresse oder einen CIDR-Bereich ein, bis zu 32 Einträge. Eine leere Liste bedeutet keine IP-Beschränkung. Neue Schlüssel übernehmen diese Kontoliste. Der Edge prüft bei jeder API-Anfrage die Client-IP, die Cloudflare meldet.
Wenn Sie die Kontoliste per Skript verwalten möchten, ersetzt PUT /portal/allowed_ips sie mit einem Aufruf (Portal-Credential erforderlich).
Einem einzelnen Schlüssel geben Sie eine eigene Liste, wenn Sie ihn mit einem Portal-Credential erstellen:
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"]}'
Ein allowed_ips pro Schlüssel ersetzt für diesen Schlüssel die geerbte Kontoliste. Die Antwort enthält den Schlüssel im Klartext genau einmal; speichern Sie ihn sofort.
Einen geleakten Schlüssel schnell widerrufen
DELETE /portal/keys/{alias} widerruft einen Pay-as-you-go-Schlüssel, DELETE /portal/keys/hourly/{alias} einen Stunden-Schlüssel (der ursprüngliche Kaufbetrag bleibt berechnet). Nach einem Widerruf oder einer Änderung der Allowlist stoppen neue Anfragen innerhalb von fünf Sekunden.
curl -X DELETE https://inference.broadnet.ai/portal/keys/$KEY_ALIAS \
-H "Authorization: Bearer $BROADNET_PORTAL_CREDENTIAL"
Setzen Sie KEY_ALIAS auf den Alias, der für den Schlüssel auf der Kontoseite oder in GET /portal/keys angezeigt wird. Der Alias ist nicht der geheime Schlüssel. Wenn ein Portal-Credential leakt, widerrufen Sie es mit DELETE /portal/credentials/{id}: Es kann alles, was Ihr Konto kann.
Fehlerbehebung
- 403 von einem Server, den Sie eingetragen haben. Der Edge sieht Ihre öffentliche ausgehende Adresse, nicht die private IP des Servers. Server hinter einem NAT-Gateway, Proxy oder Load Balancer gehen über die Adresse dieses Geräts nach außen. Ein Server mit IPv6 kann über IPv6 nach außen gehen, auch wenn Sie nur seine IPv4-Adresse eingetragen haben. Tragen Sie die Adresse ein, von der die Anfrage tatsächlich ausgeht, oder einen CIDR-Bereich, der sie abdeckt.
- Ein neuer Schlüssel ignoriert die Kontoliste. Ein
allowed_ips-Array pro Schlüssel ersetzt für diesen Schlüssel die geerbte Kontoliste. Prüfen Sie, was Sie beim Erstellen übergeben haben. - 409
key_limit_reached. Das Konto hat bereits zehn aktive Schlüssel. Widerrufen Sie einen, den Sie nicht mehr nutzen. - Anfragen gelingen noch einige Sekunden nach dem Widerruf. Das ist bis zu fünf Sekunden lang zu erwarten, bis der Cache nachgezogen hat.
Eine Anfrage von einer Adresse, die nicht auf der Liste steht, erhält 403. Siehe alle Fehlercodes von BroadNet und wann sich ein Retry lohnt. Für die erste Anfrage mit einem neuen Schlüssel folgen Sie der Anleitung zum OpenAI Python SDK. Der Glossareintrag zur IP-Allowlist erklärt das Prinzip allgemein.

