Ein API-Schlüssel funktioniert wie ein Passwort für ein Programm. Er ist zugleich eine Ausgabevollmacht: Wer ihn besitzt, kann Ihr Guthaben verbrauchen.
So funktioniert es
LLM-APIs behandeln den Schlüssel als Bearer-Token. Der Client sendet ihn bei jeder Anfrage mit:
curl https://inference.broadnet.ai/v1/models \
-H "Authorization: Bearer $BROADNET_API_KEY"
RFC 6750 definiert ein Bearer-Token als eines, das „any party in possession of the token“ (Übersetzung: „jede Partei, die das Token besitzt“) verwenden kann. Einen zweiten Faktor gibt es nicht. Deshalb schreibt derselbe RFC vor, dass Clients Bearer-Tokens immer über TLS (https://) senden müssen.
Der Anbieter schlägt den Schlüssel nach, findet das Konto, prüft Limits und Richtlinien und bedient oder verweigert dann die Anfrage. Ein fehlender oder falscher Schlüssel führt meist zu 401; ein Schlüssel, den eine Richtlinie wie eine IP-Allowlist ablehnt, meist zu 403.
Warum es wichtig ist
Ein geleakter Schlüssel ist einer der häufigsten Gründe für eine aus dem Ruder laufende API-Rechnung, denn Bots durchsuchen öffentlichen Code nach Secrets. Er kann auch Daten preisgeben, wenn der Schlüssel Endpoints erreicht, die Kontodaten liefern. Bewährte Praxis im Sinne der OWASP-Empfehlungen zu Secrets:
- Laden Sie Schlüssel aus Umgebungsvariablen oder einem Secret-Manager. Committen Sie sie nie und backen Sie sie nie in Container-Images ein.
- Geben Sie jeder App und jedem Agenten einen eigenen Schlüssel, damit Sie einen widerrufen können, ohne alles anzuhalten.
- Rotieren Sie Schlüssel regelmäßig und sofort nach jedem Verdacht auf ein Leak.
- Begrenzen Sie, wo ein Schlüssel funktioniert, etwa mit einer Allowlist von Server-IPs.
Bei BroadNet Inference
BroadNet trennt zwei Zugangsdaten. Ein Inferenz-Schlüssel ruft Modelle unter /v1/* auf. Ein Portal-Zugang automatisiert das Konto: Schlüssel, erlaubte IPs und Käufe. Behandeln Sie Letzteren wie eine volle Kontovollmacht.
Beide werden nur einmal angezeigt. BroadNet speichert nur einen SHA-256-Hash und kann den Schlüssel daher nicht erneut anzeigen. Ein Pay-as-you-go-Schlüssel gilt ein Jahr, und ein Konto kann bis zu zehn aktive Schlüssel haben. Jeder Schlüssel kann seine eigene Liste erlaubter IPs haben. Nach einem Widerruf oder einer Änderung der Allowlist werden neue Anfragen innerhalb von fünf Sekunden gestoppt.
Plan-Schlüssel für die Flatrate-Pläne sind davon getrennt und belasten nie Ihr Guthaben. Die Einrichtung steht unter API-Schlüssel und IP-Allowlists, die Statuscodes unter Fehler und Retries.
Häufige Fehler
- Vollständige Request-Header loggen. Damit landet der Schlüssel in Ihren Logs.
- Einen Schlüssel im ganzen Team teilen. Dann können Sie einer einzelnen Person den Zugang nicht mehr entziehen.
- Den Schlüssel an den Support senden. Senden Sie stattdessen den Wert des Headers
X-Request-ID.