Authentifizierung mit Bearer-Token
Auf dieser Seite
Sichere API-Aufrufe
Jede Anfrage an die xAI-API muss authentifiziert werden. Die API verwendet das Bearer-Token-Schema, einen weit verbreiteten Standard für REST-APIs. In dieser Lektion wird erklärt, wie der Mechanismus funktioniert, und die besten Praktiken zum Schutz Ihrer Schlüssel in der Produktion werden vorgestellt.
Das Bearer-Token-Schema
Wie der Name andeutet, kann, wer das Token „trägt”, auf die API zugreifen. Deshalb ist der Schutz Ihres Schlüssels fundamental: Es gibt keine Identitätsprüfung jenseits des Tokens selbst.
Header-Format
Jede HTTP-Anfrage muss den Authorization-Header mit dem Bearer-Präfix gefolgt von Ihrem Schlüssel enthalten:
Authorization: Bearer xai-your-api-key
Mit cURL ergibt sich daraus:
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "grok-4.5", "input": "Hello"}'
In Python übernehmen die SDKs diesen Header automatisch, wenn Sie den Schlüssel an den Client-Konstruktor übergeben.
Authentifizierungsfehler
HTTP 401 Unauthorized
Dieser Fehler bedeutet, dass Ihr Schlüssel fehlt, ungültig ist oder widerrufen wurde. Prüfen Sie:
- Ob die Umgebungsvariable
XAI_API_KEYgesetzt ist - Ob der Schlüssel mit
xai-beginnt - Ob der Schlüssel im Console nicht widerrufen wurde
HTTP 403 Forbidden
Ihr Schlüssel ist gültig, verfügt aber nicht über die für die angeforderte Aktion erforderlichen Berechtigungen. Dies kann bei Teambeschränkungen für bestimmte Operationen auftreten.
Best Practices für die Sicherheit
Schlüssel niemals im Code offenzulegen
Schlüssel dürfen niemals als Klartext in folgenden Bereichen erscheinen:
- Versionierter Quellcode (Git)
- Anwendungsprotokollen
- URLs oder Abfrageparametern
- Fehlermeldungen, die an Benutzer angezeigt werden
- GitHub-Issues und Pull Requests
Verwenden Sie ein Secrets-Vault
In der Produktion sollten Sie Ihre Schlüssel in einem dedizierten System speichern:
- AWS Secrets Manager oder Parameter Store
- Google Secret Manager
- Azure Key Vault
- HashiCorp Vault
- Geheime Ihrer CI/CD-Plattform (GitHub Actions, GitLab CI)
Schlüsselrotation
Ändern Sie Ihre Schlüssel regelmäßig und sofort, wenn Sie einen Leck verdächtigen:
- Erstellen Sie einen neuen Schlüssel in der xAI-Console
- Aktualisieren Sie den Schlüssel in Ihrem Secrets-Vault
- Starten Sie Ihre Anwendung neu
- Prüfen Sie, ob alles mit dem neuen Schlüssel funktioniert
- Widerrufen Sie den alten Schlüssel in der Console
Berechtigungen einschränken
Wenn Sie in einem Team arbeiten, erstellen Sie für jeden Dienst und jede Umgebung separate Schlüssel. Wenn einer kompromittiert wird, bleibt der Schaden auf einen einzelnen Kontext beschränkt.
Leck-Erkennung
Das xai--Präfix ermöglicht es Erkennungstools (GitHub Secret Scanning, GitGuardian, TruffleHog), Schlüssel im Quellcode automatisch zu identifizieren. Schalten Sie diese Tools in Ihren Repositories ein, damit Sie sofort benachrichtigt werden, falls eine unbeabsichtigte Offenlegung stattfindet.
Wenn ein Schlüssel in einem öffentlichen Commit erkannt wird:
- Widerrufen Sie ihn sofort in der xAI-Console
- Prüfen Sie Ihre Nutzungshistorie auf betrügerische Nutzung
- Erstellen Sie einen neuen Schlüssel
- Bereinigen Sie Ihre Git-Historie (oder behandeln Sie den Schlüssel als kompromittiert und ziehen Sie weiter)
HTTPS erforderlich
Die xAI-API akzeptiert nur HTTPS-Verbindungen. TLS verschlüsselt Ihre Anfragen während der Übertragung, einschließlich des Authorization-Headers. Versuchen Sie niemals, diesen Schutz zu umgehen: Eine Anfrage über unverschlüsseltes HTTP würde Ihren Schlüssel im Netzwerk exponieren.
Kernaussagen
- Die API verwendet das Bearer-Token-Schema über den
Authorization-Header - Der Schlüssel ist der einzige Authentifizierungsfaktor: Schützen Sie ihn wie ein Passwort
- Verwenden Sie in der Produktion ein Secrets-Vault und kodieren Sie niemals einen Schlüssel fest
- Schalten Sie die Leck-Erkennung in Ihren Git-Repositorien ein
- Rotieren Sie Schlüssel regelmäßig und widerrufen Sie jeden kompromittierten Schlüssel sofort
Überprüfen Sie Ihr Verständnis
Die Grundlagen der xAI-API: Eine letzte Kontrolle, bevor Sie bauen.
1. Was sollten Sie mit einem API-Schlüssel tun, sobald Sie ihn erstellt haben?
Antwort: Speichern Sie ihn an einem sicheren Ort (er wird nur einmal angezeigt), exponieren Sie ihn über die Variable XAI_API_KEY statt ihn festzu kodieren, verwenden Sie einen Schlüssel pro Umgebung und testen Sie ihn sofort mit einem Aufruf an /v1/models.
2. Was ist die Basis-URL und warum ist sie so wichtig?
Antwort: https://api.x.ai/v1. Sie macht die OpenAI-Kompatibilität möglich: Das Ändern von base_url und dem Schlüssel reicht aus, um bestehenden OpenAI-Code auf Grok zu richten.
3. Welche SDKs können Sie mit Grok verwenden?
Antwort: Das native xAI-SDK, das OpenAI-SDK (mit der xAI base_url) und das Vercel AI SDK auf der JavaScript-Seite, plus cURL zum Testen: Das Ökosystem ist offen.
4. Was ist der Haupt-Generierungs-Endpunkt?
Antwort: POST /v1/responses, das moderne Format; chat/completions bleibt als Legacy-Option für die Kompatibilität verfügbar.
5. Wie wird jede Anfrage authentifiziert?
Antwort: Mit dem Authorization: Bearer-Header und dem xai-…-Schlüssel: das Standard-Bearer-Token-Schema, gleichgültig welches SDK oder Tool verwendet wird.
Ein gesicherter Schlüssel, die Basis-URL, Ihre Wahl des SDKs, Bearer überall: Die Grundlage ist gelegt, und die nächsten API-Kurse bauen darauf auf.