Schlüsselrotation und Löschung
Auf dieser Seite
Rotation: Erneuerung ohne Unterbrechung
Schlüsselrotation ist eine kritische Sicherheitspraxis. Sie erzeugt einen neuen Geheimhaltungsschlüssel, um den alten zu ersetzen, ohne den Schlüssel selbst zu löschen. Der alte Geheimhaltungsschlüssel wird sofort und unwiderruflich ungültig.
Rotation durchführen
Rotation löst ein Problem, das eine Löschung nicht bewältigen kann: die Erneuerung des Geheimnisses ohne Verlust der Identität des Schlüssels. Seine Zugriffssteuerungslisten (ACLs), Rate Limits und der Name überstehen die Operation, sodass Sie nichts neu konfigurieren müssen – lediglich das Geheimnis in Ihrem Tresor ändert sich. Dies macht regelmäßige Rotationen praktikabel; die Neuerstellung eines Schlüssels würde erfordern, dass alles bei jedem Vorgang neu konfiguriert wird.
POST /auth/api-keys/{apiKeyId}/rotate
curl -X POST "https://management-api.x.ai/auth/api-keys/$API_KEY_ID/rotate" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Verhalten bei Rotation
- Der alte Geheimhaltungsschlüssel wird sofort ungültig – jede Anfrage, die ihn verwendet, schlägt mit einem Fehler 401 fehl
- Ein neuer Geheimhaltungsschlüssel wird generiert und in der Antwort zurückgegeben
- Die Schlüssel-ID (
apiKeyId), der Name, die ACLs und die Rate Limits bleiben unverändert - Der neue Geheimhaltungsschlüssel wird nur einmal angezeigt – speichern Sie ihn sofort
Sichere Rotationsprozedur
Ein Teil dieses Verfahrens verdient besondere Betonung, da er Benutzer oft überrascht: der alte Geheimhaltungsschlüssel wird sofort ungültig. Es gibt keine Übergangsfrist, in der beide Geheimnisse funktionieren. Dienste, die noch den alten Wert verwenden, werden ab dem zweiten Aufruf nach der Rotation versagen. Dies diktiert die Reihenfolge der folgenden sechs Schritte: Bereiten Sie Ihre Infrastruktur vor der Auslösung der Rotation vor, nicht danach.
- Vorbereiten Sie Ihre Infrastruktur, um einen neuen Schlüssel zu akzeptieren (Umgebungsvariable, Tresor)
- Ausführen Sie die Rotation über die API
- Aktualisieren Sie das Geheimnis in Ihrem Tresor sofort
- Neu bereitstellen Sie Ihre Dienste mit dem neuen Schlüssel
- Verifizieren Sie, dass Anfragen mit dem neuen Schlüssel erfolgreich sind
- Verifizieren Sie die Ausbreitung über
GET /auth/api-keys/{apiKeyId}/propagation
Wann rotieren
Drei Situationen lösen eine Rotation aus, jede mit unterschiedlicher Dringlichkeit. Verdacht auf eine Offenlegung erfordert eine sofortige Rotation: ein Teammitglied mit Schlüsselzugriff verlässt das Unternehmen, ein Log enthält einen Schlüssel, der öffentlich exponiert wurde, oder ein Git-Repository enthält einen Klartext-Schlüssel. In diesen Fällen ist jede Stunde des Wartens eine Stunde der Exposition, daher rotieren Sie, bevor die Incident-Analyse abgeschlossen ist. Eine politikbasierte Rotation ist präventiv: alle 30, 60 oder 90 Tage, abhängig von Ihren Sicherheitsanforderungen, begrenzt die Lebensdauer eines Schlüssels, der möglicherweise unbemerkt offengelegt wurde. Schließlich bieten Umgebungsänderungen – Infrastrukturmigrationen oder Anbieterwechsel – eine natürliche Gelegenheit, mit sauberen Schlüssel neu zu beginnen, anstatt alte Schlüssel in einen Kontext zu tragen, für den sie nie konzipiert wurden.
Schlüssel löschen
Die Löschung ist dauerhaft und unwiderruflich. Die Frage, die Sie sich vor dem Löschen stellen, lautet nicht „Ist dieser Schlüssel kompromittiert?“, sondern „Brauche ich diesen Zugriffsbereich noch?“. Wenn die Antwort Ja lautet, benötigen Sie eine Rotation: sie neutralisiert das offengelegte Geheimnis, während die Konfiguration erhalten bleibt. Die Löschung ist nur gerechtfertigt für einen Schlüssel, der nicht mehr nützlich ist – ein gestopptes Projekt, ein abgereister Anbieter oder eine abgeschaltete Umgebung.
DELETE /auth/api-keys/{apiKeyId}
curl -X DELETE "https://management-api.x.ai/auth/api-keys/$API_KEY_ID" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Folgen der Löschung
- Der Schlüssel und alle seine Parameter werden dauerhaft gelöscht
- Alle Anfragen, die diesen Schlüssel verwenden, werden sofort fehlschlagen
- Die Aktion ist unwiderruflich – Sie müssen einen neuen Schlüssel mit neuen Parametern erstellen
- Die Nutzungshistorie des Schlüssels bleibt in der Analyse verfügbar
Rotation versus Löschung
| Aspekt | Rotation | Löschung |
|---|---|---|
| Schlüssel existiert noch | Ja | Nein |
| Neues Geheimnis generiert | Ja | Nein |
| ACLs erhalten | Ja | Nein |
| Limits erhalten | Ja | Nein |
| Umkehrbar | Nein (altes Geheimnis verloren) | Nein (Schlüssel gelöscht) |
| Typischer Einsatz | Regelmäßige Erneuerung | Obsoletter Schlüssel oder bestätigte Kompromittierung |
Rotation automatisieren
Automatisierte Rotation macht nur Sinn, wenn das Schreiben in den Tresor Teil desselben Skripts ist, ohne manuelle Zwischenschritte. Andernfalls verlagern Sie lediglich das Risiko: ein maschinell generiertes Geheimnis, das manuell kopiert wird, landet eher in einer Zwischenablage oder der Terminalverlaufshistorie als ein Schlüssel, der aus der Konsole erstellt wurde.
import requests
import json
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
KEY_ID = "key-123"
# Rotieren
response = requests.post(
f"{MANAGEMENT_API}/auth/api-keys/{KEY_ID}/rotate",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
new_key = response.json()
new_secret = new_key.get("secret")
# Speichern in Ihrem Tresor (Beispiel mit einer .env-Datei)
# In der Produktion verwenden Sie Vault, AWS Secrets Manager usw.
print(f"Neuer Schlüssel generiert. Aktualisieren Sie Ihren Tresor.")
Geplante Rotation
Integrieren Sie die Rotation in Ihre CI/CD-Pipeline oder einen Cron-Job:
# Cron-Beispiel: Rotation am 1. jeden Monats um 3 Uhr
0 3 1 * * /opt/scripts/rotate-xai-keys.sh
Kernaussagen
POST /auth/api-keys/{apiKeyId}/rotateungültigt das alte Geheimnis und generiert ein neues- Die Ungültigmachung des alten Geheimnisses ist sofort und dauerhaft
DELETE /auth/api-keys/{apiKeyId}löscht den Schlüssel unwiderruflich- Bevorzugen Sie Rotation gegenüber Löschung, um bestehende ACLs und Limits aufrechtzuerhalten
- Automatisieren Sie Rotation mit einem Skript und einem Geheimnistresor
- Verifizieren Sie immer die Ausbreitung nach einer Rotation