Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Schlüsselrotation und Lebenszyklus

Lektion 7 von 12 Aktualisiert am 28. Juli 2026 Fortgeschritten
Auf dieser Seite
  1. Warum Schlüsselrotation unerlässlich ist
  2. Rotation über die Management-API
  3. Der vollständige Lebenszyklus eines Schlüssels
  4. Welche Rotationsstrategie sollten Sie adoptieren?
  5. Zwanzig Minuten, um die Kontrolle über Ihr Inventar zurückzugewinnen
  6. Kernaussagen

Warum Schlüsselrotation unerlässlich ist

Ein häufiger Einwand in Schulungssitzungen lautet: „Mein Schlüssel ist noch nie geleakt, warum sollte ich ihn ändern?” Die Antwort lässt sich auf ein Wort reduzieren: Unsicherheit. Sie können niemals beweisen, dass ein Schlüssel nicht exponiert wurde – ein ausführliches Log, das auf einem Server vergessen wurde, ein Screenshot, der in einem Support-Ticket geteilt wurde, oder ein kompromittierter Entwickler-Workstation von vor sechs Monaten. Regelmäßige Rotation verwandelt diese Unsicherheit in ein begrenztes Risiko: Selbst wenn ein Schlüssel unbemerkt kopiert wurde, wird er bei der nächsten Rotation ungültig. Genau dies ist die Argumentation, die SOC 2-Prüfer verwenden; sie erwarten eine dokumentierte Rotationsrichtlinie. Dies nennen wir die Reduzierung der zeitlichen Angriffsfläche: Je länger ein Schlüssel lebt, desto länger ist das Fenster für die Ausnutzung einer stillen Kompromittierung.

Die Management-API von xAI ist so konzipiert, dass diese Praxis mühelos wird: Sie bietet einen dedizierten Endpunkt, mit dem Sie einen Schlüssel rotieren können, ohne Ihre Konfigurationen neu schreiben zu müssen.

Rotation über die Management-API

Der Rotationsendpunkt ist einfach:

POST https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate

Stellen Sie sicher, dass Sie verstehen, was dieser Aufruf tut, bevor Sie ihn verwenden: Er generiert einen neuen Geheimhaltungsschlüssel für die bestehende ID und macht den alten dauerhaft ungültig, während die ACLs, Rate Limits und Konfigurationen, die dem Schlüssel zugeordnet sind, erhalten bleiben. Das, was Teams beim ersten Mal überrascht, ist, dass die Änderung sofort und unwiderruflich ist. Wenn Ihr Produktions-Backend diesen Schlüssel verwendet, wenn Sie die Rotation auslösen, beginnen Sie innerhalb von Sekunden, Authentifizierungsfehler zu erhalten. Es gibt keine Gnadenfrist und keine Möglichkeit zur Rücknahme.

Deshalb bevorzugt man in der Produktion im Allgemeinen ein zweistufiges Verfahren, um jegliche Unterbrechung zu vermeiden. Erstellen Sie zunächst einen neuen Schlüssel über POST /auth/teams/{teamId}/api-keys mit exakt denselben Berechtigungen wie der alte. Überprüfen Sie dann dessen Ausbreitung mit GET /auth/api-keys/{newKeyId}/propagation – ein frisch erstellter Schlüssel ist nicht sofort in der gesamten Infrastruktur bekannt, und eine zu frühe Bereitstellung führt zu verwirrenden Fehlern. Anschließend deployen Sie den neuen Schlüssel in Ihre Backends und testen Sie, dass Aufrufe tatsächlich mit ihm funktionieren, nicht nur, dass die Bereitstellung fehlerfrei abgeschlossen wurde. Erst wenn Sie diese Bestätigung haben, sollten Sie den alten Schlüssel deaktivieren oder ablaufen lassen, bevor Sie ihn dauerhaft mit DELETE /auth/api-keys/{oldKeyId} löschen.

Dieser Ansatz „neuer Schlüssel, dann löschen” gibt Ihnen einen Überlappungszeitraum, in dem beide Schlüssel koexistieren: Wenn die Bereitstellung auf einem Server fehlschlägt, bricht nichts zusammen. Die Rotation am Ort bleibt verfügbar, wenn Sie denselben Schlüssel-Beibehalten möchten:

curl -X POST \
  "https://management-api.x.ai/auth/api-keys/key_abc123/rotate" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

In diesem Fall planen Sie vor, Ihre Backends sofort zu aktualisieren, da der alte Schlüssel stirbt, sobald der Aufruf abgeschlossen ist.

Der vollständige Lebenszyklus eines Schlüssels

Ein gut verwalteter Schlüssel hat eine vieraktige Geschichte. Bei der Erstellung über POST /auth/teams/{teamId}/api-keys definieren Sie seinen Namen, seine ACLs und – dies ist die Gewohnheit, die verankert werden muss – sein Ablaufdatum:

{
  "name": "prod-chat-service",
  "acls": ["api-key:endpoint:chat", "api-key:model:grok-4.3"],
  "expireTime": "2026-12-31T23:59:59Z"
}

Ein Schlüssel ohne expireTime ist ein Schlüssel, der ewig leben wird, wenn niemand darüber nachdenkt; ein Schlüssel mit Ablaufdatum zwingt Ihr Team dazu, die Frage der Erneuerung an einem festen Datum zu stellen. Als Nächstes kommt die Überwachung: GET /v1/api-key informiert Sie über den Schlüsselstatus (api_key_blocked, api_key_disabled), und die xAI-Konsole stellt Nutzung und Anomalien bereit. Für Änderungen im mittleren Lebensabschnitt – Umbenennung, Anpassung der ACLs, Verschärfung der Rate Limits, Verschiebung des Ablaufdatums – verwenden Sie PUT https://management-api.x.ai/auth/api-keys/{api_key_id}. Schließlich ist das Löschen, DELETE /auth/api-keys/{apiKeyId}, dauerhaft und unwiderruflich: Jede Anwendung, die diesen Schlüssel verwendet, funktioniert sofort nicht mehr. Vor dem Löschen stellen Sie sicher, dass keine vergessene Dienstleistung – ein monatlicher Cron-Job, ein Reporting-Skript – noch davon abhängt.

Welche Rotationsstrategie sollten Sie adoptieren?

Die richtige Häufigkeit hängt von der Sensibilität Ihrer Umgebung ab. Eine monatliche Rotation ist in hochsensiblen Kontexten wie Finanzen oder Gesundheitswesen zwingend erforderlich, wo das Expositionsfenster minimal bleiben muss. Eine vierteljährliche Rotation eignet sich für Standard-Umgebungen im professionellen Bereich: häufig genug, um wirksam zu sein, und ausreichend beabstandet, um Teams nicht zu belasten. Eine jährliche Rotation, gekoppelt mit einem definierten Ablaufdatum, ist das akzeptable Minimum – darunter ist Ihre Rotationsrichtlinie keine Richtlinie mehr. In allen Fällen spart Ihnen Automatisierung über ein geplantes Skript davon ab, auf das Gedächtnis eines Administrators angewiesen zu sein.

Ereignisgesteuerte Rotation fügt diesem Zeitplan hinzu und wird durch Umstände statt durch Datum ausgelöst. Sie werden dies am häufigsten bei der Abreise eines Mitarbeiters auslösen, der Zugriff auf Schlüssel hatte: Selbst wenn die Trennung freundschaftlich ist, muss der Schlüssel, den sie kannten, am selben Tag rotieren – dies ist eine Regel der Sicherheitshygiene, kein Zeichen von Misstrauen. Tun Sie dasselbe im Falle eines vermuteten Kompromittierungs, eines Sicherheitsvorfalls in Ihrer Infrastruktur oder eines Lieferantenwechsels, der Zugriff auf Ihre Systeme hatte.

Zwanzig Minuten, um die Kontrolle über Ihr Inventar zurückzugewinnen

Der beste Zeitpunkt, um den tatsächlichen Zustand Ihrer Schlüssel zu entdecken, ist nicht der Prüfungstag. Listen Sie daher jetzt alle Ihre Schlüssel mit GET /auth/teams/{teamId}/api-keys auf und identifizieren Sie diejenigen ohne Ablaufdatum, um ein expireTime hinzuzufügen. Für jeden fragen Sie sich, ob seine ACLs dem strengen Minimum entsprechen, das die Anwendung, die ihn verwendet, erfordert; ein Schlüssel, der für ein Prototyp erstellt und in die Produktion recycelt wurde, trägt fast immer zu viele Rechte.

Löschen Sie dann ungenutzte Schlüssel, da jeder aktive Schlüssel ein potenzieller Angriffsvektor ist, und ein Schlüssel, den niemand mehr erinnert, der schlechteste von allen ist: Niemand wird seinen abnormalen Gebrauch bemerken. Beenden Sie dies, indem Sie dokumentieren, wer Zugriff auf welchen Schlüssel hat und warum. Dieses Dokument, mehr als die Schlüssel selbst, ist das, was Sie bei der nächsten Prüfung vorlegen werden.

Kernaussagen

  • Der Endpunkt POST /auth/api-keys/{id}/rotate macht den alten Schlüssel dauerhaft ungültig, ohne Gnadenfrist
  • Bevorzugen Sie in der Produktion das Erstellen eines neuen Schlüssels und das anschließende Löschen des alten, um jegliche Unterbrechung zu vermeiden
  • Setzen Sie immer ein Ablaufdatum für Ihre Schlüssel
  • Automatisieren Sie die Rotation mit einem geplanten Skript (monatlich, vierteljährlich oder jährlich basierend auf der Sensibilität)
  • Lösen Sie bei jeder Personaländerung oder einem Sicherheitsvorfall eine sofortige Rotation aus