Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Rotatie en verwijdering van sleutels

Les 4 van 14 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. Rotatie: vernieuwen zonder onderbreking
  2. Een rotatie uitvoeren
  3. Een sleutel verwijderen
  4. Rotatie automatiseren
  5. Belangrijkste punten

Rotatie: vernieuwen zonder onderbreking

Sleutelrotatie is een cruciale beveiligingspraktijk. Hiermee genereert u een nieuwe geheime sleutel om de oude te vervangen, zonder de sleutel zelf te verwijderen. Het oude geheim wordt onmiddellijk en permanent ongeldig gemaakt.

Een rotatie uitvoeren

Rotatie lost een probleem op dat verwijdering niet kan oplossen: het geheim vernieuwen zonder de identiteit van de sleutel te verliezen. De ACL’s, snelheidslimieten en naam blijven behouden na de bewerking, zodat u niets opnieuw hoeft te configureren; alleen het geheim verandert in uw kluis. Dit maakt regelmatige rotatie praktisch; het opnieuw aanmaken van een sleutel zou vereisen dat u elke keer alles opnieuw configureert.

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"

Gedrag bij rotatie

  • De oude geheime sleutel wordt onmiddellijk ongeldig gemaakt; alle verzoeken die deze gebruiken, mislukken met een 401-fout
  • Er wordt een nieuwe geheime sleutel gegenereerd en teruggegeven in het antwoord
  • De sleutel-ID (apiKeyId), naam, ACL’s en snelheidslimieten blijven ongewijzigd
  • De nieuwe geheime sleutel wordt slechts één keer weergegeven; sla deze onmiddellijk op

Veilig rotatieproces

Eén onderdeel van deze procedure verdient nadruk omdat het gebruikers vaak verrast: het oude geheim wordt onmiddellijk ongeldig gemaakt. Er is geen genadeperiode waarin beide geheimen werken. Diensten die nog steeds de oude waarde gebruiken, falen direct na de oproep. Dit bepaalt de volgorde van de onderstaande zes stappen: bereid uw kluis voor dat u de rotatie activeert, niet erna.

  1. Bereid uw infrastructuur voor op het accepteren van een nieuwe sleutel (omgevingsvariabele, kluis)
  2. Voer de rotatie uit via de API
  3. Werk het geheim onmiddellijk bij in uw kluis
  4. Herimplementeer uw diensten met de nieuwe sleutel
  5. Verifieer dat verzoeken slagen met de nieuwe sleutel
  6. Verifieer de propagatie via GET /auth/api-keys/{apiKeyId}/propagation

Wanneer roteren

Drie situaties leiden tot rotatie, elk met een andere urgentie. Vermoedelijke lekken vereisen onmiddellijke rotatie: een teamlid met sleuteltoegang vertrekt, een logbestand met een sleutel wordt openbaar gemaakt, of een Git-repository bevat een sleutel in platte tekst. In deze gevallen is elk uur wachten een uur blootstelling; roteer dus voordat u de incidentanalyse voltooit. Beleidsgebonden rotatie is preventief: elke 30, 60 of 90 dagen, afhankelijk van uw beveiligingseisen, beperkt dit de levensduur van een sleutel die onopgemerkt gelekt zou kunnen zijn. Tot slot bieden omgevingswijzigingen—zoals infrastructuurmigratie of wisselingen van provider—een natuurlijke gelegenheid om opnieuw te beginnen met schone sleutels, in plaats van oude sleutels mee te nemen naar een context waarvoor ze nooit zijn ontworpen.

Een sleutel verwijderen

Verwijdering is permanent en onherroepelijk. De vraag die u zich moet stellen voordat u verwijdert, is niet “Is deze sleutel gecompromitteerd?”, maar “Heb ik dit toegangsbereik nog nodig?”. Als het antwoord ja is, heeft u rotatie nodig: dit neutraliseert het blootgestelde geheim terwijl de configuratie behouden blijft. Verwijdering is alleen gerechtvaardigd voor een sleutel die niet langer nuttig is—een gestopt project, een vertrokken leverancier of een buiten gebruik gestelde omgeving.

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"

Gevolgen van verwijdering

  • De sleutel en al zijn parameters worden permanent verwijderd
  • Alle verzoeken die deze sleutel gebruiken, mislukken onmiddellijk
  • De actie is onomkeerbaar; u moet een nieuwe sleutel met nieuwe parameters aanmaken
  • De gebruiksgeschiedenis van de sleutel blijft beschikbaar in de analyses

Rotatie versus verwijdering

AspectRotatieVerwijdering
Sleutel bestaat nogJaNee
Nieuw geheim gegenereerdJaNee
ACL’s behoudenJaNee
Limieten behoudenJaNee
OmkeerbaarNee (oud geheim verloren)Nee (sleutel verwijderd)
Typisch gebruikRegelmatige vernieuwingVerouderde sleutel of bevestigde compromittering

Rotatie automatiseren

Geautomatiseerde rotatie is alleen zinvol als het wegschrijven naar de kluis onderdeel is van hetzelfde script, zonder handmatige tussenkomst. Anders verschuift u slechts het risico: een machinaal gegenereerd geheim dat met de hand wordt gekopieerd, belandt sneller in een klembord of terminalgeschiedenis dan een sleutel die via de console is aangemaakt.

import requests
import json

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
KEY_ID = "key-123"

# Rotate
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")

# Store in your vault (example with a .env file)
# In production, use Vault, AWS Secrets Manager, etc.
print(f"New key generated. Update your vault.")

Geplande rotatie

Integreer rotatie in uw CI/CD-pipeline of een cron-taak:

# Cron example: rotation on the 1st of each month at 3 AM
0 3 1 * * /opt/scripts/rotate-xai-keys.sh

Belangrijkste punten

  • POST /auth/api-keys/{apiKeyId}/rotate maakt het oude geheim ongeldig en genereert een nieuw exemplaar
  • Het ongeldig maken van het oude geheim is onmiddellijk en permanent
  • DELETE /auth/api-keys/{apiKeyId} verwijdert de sleutel onherroepelijk
  • Geef de voorkeur aan rotatie boven verwijdering om bestaande ACL’s en limieten te behouden
  • Automatiseer rotatie met een script en een geheimenkluis
  • Verifieer altijd de propagatie na een rotatie