Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Rotatie en levenscyclus van sleutels

Les 7 van 12 Bijgewerkt op 28 juli 2026 Gevorderd
Op deze pagina
  1. Waarom sleutelrotatie essentieel is
  2. Rotatie via de Management API
  3. De volledige levenscyclus van een sleutel
  4. Welke rotatiestrategie moet u adopteren?
  5. Twintig minuten om de controle over uw inventaris terug te krijgen
  6. Belangrijkste punten

Waarom sleutelrotatie essentieel is

Een veelgehoord bezwaar tijdens trainingssessies is: “Mijn sleutel is nooit gelekt, waarom zou ik deze wijzigen?” Het antwoord komt neer op één woord: onzekerheid. U kunt nooit bewijzen dat een sleutel niet is blootgesteld—een uitgebreid logbestand dat op een server is vergeten, een screenshot dat in een supportticket is gedeeld, of een gecompromitteerd developer-werkstation van zes maanden geleden. Regelmatige rotatie zet deze onzekerheid om in een beperkt risico: zelfs als een sleutel zonder uw weten is gekopieerd, stopt deze met werken bij de volgende rotatie. Dit is precies de redenering die SOC 2-auditors hanteren; zij verwachten een gedocumenteerd rotatiebeleid. Dit noemen we het verkleinen van het temporele aanvalsoppervlak: hoe langer een sleutel leeft, hoe groter het venster voor exploitatie bij een stille compromittering.

De Management API van xAI is ontworpen om deze praktijk pijnloos te maken: deze biedt een specifiek endpoint waarmee u een sleutel kunt roteren zonder uw configuraties herschrijven.

Rotatie via de Management API

Het rotatie-endpoint is eenvoudig:

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

Zorg ervoor dat u begrijpt wat deze aanroep doet voordat u deze gebruikt: deze genereert een nieuwe geheime sleutel voor de bestaande ID en maakt de oude permanent ongeldig, terwijl de ACL’s, snelheidslimieten en configuraties die aan de sleutel zijn gekoppeld, behouden blijven. Wat teams de eerste keer vaak verrast, is dat de wijziging direct en onomkeerbaar is. Als uw productie-backend deze sleutel gebruikt wanneer u de rotatie activeert, ontvangt deze binnen enkele seconden authenticatiefouten. Er is geen gratieperiode en geen manier om terug te draaien.

Daarom geeft u in een productieomgeving over het algemeen de voorkeur aan een tweestapsprocedure om onderbrekingen te voorkomen. Maak eerst een nieuwe sleutel aan via POST /auth/teams/{teamId}/api-keys, met exact dezelfde rechten als de oude. Verifieer vervolgens de propagatie met GET /auth/api-keys/{newKeyId}/propagation—een pas aangemaakte sleutel is niet direct bekend in de volledige infrastructuur, en te vroeg implementeren leidt tot verwarrende fouten. Implementeer daarna de nieuwe sleutel op uw backends en test of de aanroepen daadwerkelijk werken, niet alleen of de implementatie zonder fouten is voltooid. Pas wanneer u deze bevestiging heeft, schakelt u de oude sleutel uit, of laat u deze verstrijken, voordat u deze permanent verwijdert met DELETE /auth/api-keys/{oldKeyId}.

Deze aanpak van “eerst nieuwe sleutel, dan verwijderen” geeft u een overlapperiode waarin beide sleutels naast elkaar bestaan: als de implementatie op één server mislukt, breekt er niets. Rotatie op dezelfde plek blijft beschikbaar als u dezelfde sleutel-ID wilt behouden:

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

Plan in dit geval om uw backends direct bij te werken, aangezien de oude sleutel sterft op het moment dat de aanroep voltooid is.

De volledige levenscyclus van een sleutel

Een goed beheerde sleutel heeft een verhaal in vier akten. Bij het aanmaken, via POST /auth/teams/{teamId}/api-keys, definieert u de naam, de ACL’s en—dit is de gewoonte die u moet verankeren—de vervaldatum:

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

Een sleutel zonder expireTime is een sleutel die eeuwig leeft als niemand eraan denkt; een sleutel met een vervaldatum dwingt uw team om op een vaste datum de vraag naar verlenging te stellen. Daarna komt monitoring: GET /v1/api-key informeert u over de status van de sleutel (api_key_blocked, api_key_disabled), en de xAI-console toont gebruik en anomalieën. Voor wijzigingen halverwege de levensduur—hernoemen, ACL’s aanpassen, snelheidslimieten aanscherpen, de vervaldatum uitstellen—gebruikt u PUT https://management-api.x.ai/auth/api-keys/{api_key_id}. Tot slot is verwijdering, DELETE /auth/api-keys/{apiKeyId}, permanent en onomkeerbaar: elke applicatie die deze sleutel gebruikt, stopt direct met werken. Controleer voordat u verwijdert of er geen vergeten service—een maandelijkse cron, een rapportagescript—nog steeds afhankelijk is van de sleutel.

Welke rotatiestrategie moet u adopteren?

De juiste frequentie hangt af van de gevoeligheid van uw omgeving. Maandelijkse rotatie is verplicht in zeer gevoelige contexten zoals financiën of gezondheidszorg, waar het blootstellingsvenster minimaal moet blijven. Driemaandelijkse rotatie past bij standaard professionele omgevingen: frequent genoeg om effectief te zijn, maar met voldoende tussenpoos om teams niet te belasten. Jaarlijkse rotatie, gekoppeld aan een vastgestelde vervaldatum, is het acceptabele minimum—daaronder is uw rotatiebeleid eigenlijk geen beleid. In alle gevallen bespaart automatisering via een gepland script u ervan afhankelijk te zijn van het geheugen van een beheerder.

Gebeurtenisgestuurde rotatie vult dit schema aan, getriggerd door omstandigheden in plaats van een datum. U activeert dit meestal bij het vertrek van een medewerker die toegang had tot sleutels: zelfs als het vertrek vriendelijk is, moet de sleutel die deze persoon kende dezelfde dag worden geroteerd—dit is een regel voor beveiligingshygiëne, geen teken van wantrouwen. Doe hetzelfde bij vermoeden van compromittering, een beveiligingsincident in uw infrastructuur, of een wijziging bij een leverancier die toegang had tot uw systemen.

Twintig minuten om de controle over uw inventaris terug te krijgen

Het beste moment om de werkelijke staat van uw sleutels te ontdekken, is niet op de dag van de audit. Maak dus nu een lijst van al uw sleutels met GET /auth/teams/{teamId}/api-keys en identificeer die zonder vervaldatum, om een expireTime toe te voegen. Vraag uzelf bij elke sleutel af of de ACL’s overeenkomen met het strikte minimum dat vereist is door de applicatie die deze gebruikt; een sleutel die voor een prototype is gemaakt en in productie is hergebruikt, heeft bijna altijd te veel rechten.

Verwijder vervolgens ongebruikte sleutels, want elke actieve sleutel is een potentieel aanvalsvector, en een sleutel waar niemand meer aan denkt, is het ergst van allemaal: niemand zal het abnormale gebruik opmerken. Sluit af door te documenteren wie toegang heeft tot welke sleutel en waarom. Dit document, meer dan de sleutels zelf, is wat u bij de volgende audit boven tafel haalt.

Belangrijkste punten

  • Het endpoint POST /auth/api-keys/{id}/rotate maakt de oude sleutel permanent ongeldig, zonder gratieperiode
  • Geef in productie de voorkeur aan het aanmaken van een nieuwe sleutel en het vervolgens verwijderen van de oude om onderbrekingen te voorkomen
  • Stel altijd een vervaldatum in voor uw sleutels
  • Automatiseer rotatie met een gepland script (maandelijks, driemaandelijks of jaarlijks, afhankelijk van de gevoeligheid)
  • Activeer directe rotatie bij elke wijziging in personeel of beveiligingsincident