BroadRouter
Loslegen

API-Schlüssel (API Key)

Aktualisiert

Ein API-Schlüssel ist eine geheime Zeichenfolge, die einen Client beim Aufruf einer API identifiziert und autorisiert. LLM-APIs erwarten ihn meist im Header Authorization: Bearer, und wer den Schlüssel besitzt, kann Anfragen stellen, die dem Konto des Inhabers berechnet werden.

Auch genannt: API Key, API-Key, API-Token, geheimer Schlüssel, Bearer-Token, Inferenz-Schlüssel, API key, API token, secret key, bearer token, inference key

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.

Häufige Fragen

Darf ich einen LLM-API-Schlüssel in eine Browser- oder Mobile-App einbauen?

Nein. Alles, was an einen Client ausgeliefert wird, lässt sich auslesen. Behalten Sie den Schlüssel auf einem Server und lassen Sie Ihre App Ihren Server aufrufen, der dann die LLM-API aufruft.

Was tue ich, wenn ein Schlüssel geleakt ist?

Widerrufen Sie ihn sofort, erstellen Sie einen neuen und prüfen Sie die Nutzung für den Zeitraum, in dem er offenlag. Finden Sie dann heraus, wie er nach außen gelangt ist, etwa über einen Commit, eine Logzeile oder einen Screenshot.

Wie viele Schlüssel kann ich bei BroadNet Inference haben?

Bis zu zehn aktive Pay-as-you-go-Schlüssel pro Konto. Jeder gilt ein Jahr ab Erstellung. Plan-Schlüssel sind davon getrennt.

Als Markdown lesenChatGPT fragenClaude fragenPerplexity fragen