Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Nøglerotation og livscyklus

Lektion 7 af 12 Opdateret 28. juli 2026 Avanceret
På denne side
  1. Hvorfor nøglerotation er afgørende
  2. Rotation via Management API
  3. Den komplette livscyklus for en nøgle
  4. Hvilken rotationsstrategi bør du vælge?
  5. Tyve minutter til at genvinde kontrollen over dit inventar
  6. Vigtige pointer

Hvorfor nøglerotation er afgørende

En indvending, der ofte dukker op under træningssessioner, er: “Min nøgle er aldrig blevet lækket, hvorfor skal jeg så ændre den?” Svaret kan koges ned til ét ord: usikkerhed. Du kan aldrig bevise, at en nøgle ikke er blevet eksponeret – et udførligt logfil glemt på en server, et skærmbillede delt i en supportticket eller en kompromitteret udviklerarbejdsstation fra for seks måneder siden. Regelmæssig rotation omdanner denne usikkerhed til en begrænset risiko: Selv hvis en nøgle blev kopieret uden din viden, vil den holde op med at fungere ved næste rotation. Det er præcis den logik, SOC 2-revisorer bruger; de forventer en dokumenteret rotationspolitik. Dette kaldes at reducere det tidsmæssige angrebsareal: Jo længere en nøgle lever, jo større er vinduet for udnyttelse ved en stille kompromittering.

xAI’s Management API er designet til at gøre denne praksis smertefri: Det tilbyder et dedikeret endpoint, der lader dig rotere en nøgle uden at skulle omskrive dine konfigurationer.

Rotation via Management API

Rotations-endpointet er ligetil:

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

Sørg for, at du forstår, hvad dette kald gør, før du bruger det: Det genererer en ny hemmelig nøgle til det eksisterende ID og ugyldiggør permanent den gamle, mens ACL’er, hastighedsbegrænsninger og konfigurationer knyttet til nøglen bevares. Det, der ofte overrasker hold første gang, er, at ændringen er øjeblikkelig og irreversibel. Hvis dit produktionsbackend bruger denne nøgle, når du udløser rotationen, vil det begynde at modtage autentificeringsfejl inden for få sekunder. Der er ingen grace period, ingen måde at rulle tilbage på.

Derfor foretrækker man i produktion generelt en totrinsprocedure for at undgå afbrydelser. Opret først en ny nøgle via POST /auth/teams/{teamId}/api-keys med præcis de samme rettigheder som den gamle. Verificér derefter dens udbredelse med GET /auth/api-keys/{newKeyId}/propagation – en nyoprettet nøgle er ikke øjeblikkeligt kendt på tværs af hele infrastrukturen, og for tidlig udrulning producerer forvirrende fejl. Derefter udruller du den nye nøgle til dine backends og tester, at kald faktisk fungerer med den, ikke blot at udrulningen blev afsluttet uden fejl. Først når du har denne bekræftelse, bør du deaktivere den gamle nøgle eller lade den nå sin udløbsdato, før du permanent sletter den med DELETE /auth/api-keys/{oldKeyId}.

Denne “ny nøgle, derefter slet”-tilgang giver dig en overlapningsperiode, hvor begge nøgler sameksisterer: Hvis udrulningen fejler på én server, bryder intet sammen. In-place rotation forbliver tilgængelig, hvis du ønsker at beholde det samme nøgle-ID:

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

I dette tilfælde skal du planlægge at opdatere dine backends med det samme, da den gamle nøgle dør i det øjeblik, kaldet er fuldført.

Den komplette livscyklus for en nøgle

En veladministreret nøgle har en historie i fire akter. Ved oprettelse, via POST /auth/teams/{teamId}/api-keys, definerer du dens navn, dens ACL’er og – dette er vanen, du skal cementere – dens udløbsdato:

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

En nøgle uden expireTime er en nøgle, der vil leve for evigt, hvis ingen tænker over det; en nøgle med udløb tvinger dit hold til at stille spørgsmålet om fornyelse på en fast dato. Dernæst kommer overvågning: GET /v1/api-key fortæller dig nøglens status (api_key_blocked, api_key_disabled), og xAI-konsollen eksponerer forbrug og anomalier. Til ændringer midt i livscyklussen – omdøbning, justering af ACL’er, stramning af hastighedsbegrænsninger, udskydelse af udløb – brug PUT https://management-api.x.ai/auth/api-keys/{api_key_id}. Endelig er sletning, DELETE /auth/api-keys/{apiKeyId}, permanent og irreversibel: Ethvert program, der bruger denne nøgle, holder øjeblikkeligt op med at fungere. Før du sletter, skal du sikre dig, at ingen glemt service – et månedligt cron-job, et rapporteringsscript – stadig afhænger af den.

Hvilken rotationsstrategi bør du vælge?

Den rette frekvens afhænger af miljøets følsomhed. Månedlig rotation er obligatorisk i meget følsomme kontekster som finans eller sundhedsvæsen, hvor eksponeringsvinduet skal holdes minimalt. Kvartalsvis rotation passer til standard professionelle miljøer: Hyppig nok til at være effektiv, men med nok mellemrum til ikke at belaste holdene. Årlig rotation, koblet med en defineret udløbsdato, er det acceptabelte minimum – under det er din rotationspolitik ikke rigtig en politik. I alle tilfælde sparer automatisering via et planlagt script dig for at skulle afhænge af en administrators hukommelse.

Hændelsesdrevet rotation lægges oven i denne tidsplan, udløst af omstændigheder snarere end dato. Du vil oftest udløse den ved en medarbejders afgang, som har haft adgang til nøgler: Selv hvis separationen er hjertelig, skal den nøgle, de kendte, roteres samme dag – dette er en regel for sikkerhedshygiejne, ikke et tegn på mistillid. Gør det samme i tilfælde af mistanke om kompromittering, en sikkerhedshændelse i din infrastruktur eller et skift af leverandør, der har haft adgang til dine systemer.

Tyve minutter til at genvinde kontrollen over dit inventar

Det bedste tidspunkt at opdage den reelle tilstand af dine nøgler er ikke revisionsdagen. Så list alle dine nøgler op nu med GET /auth/teams/{teamId}/api-keys og identificér dem uden udløb for at tilføje en expireTime. For hver enkelt skal du spørge dig selv, om dens ACL’er matcher det strengt minimum, som applikationen, der bruger den, kræver; en nøgle oprettet til en prototype og genbrugt i produktion bærer næsten altid for mange rettigheder.

Slet derefter ubrugte nøgler, for hver aktiv nøgle er en potentiel angrebsvektor, og en nøgle, som ingen husker, er den værste af alle: Ingen vil bemærke dens unormale brug. Afslut med at dokumentere, hvem der har adgang til hvilken nøgle, og hvorfor. Dette dokument er, mere end nøglerne selv, det du vil finde frem ved næste revision.

Vigtige pointer

  • Endpointet POST /auth/api-keys/{id}/rotate ugyldiggør den gamle nøgle permanent uden nogen grace period
  • I produktion bør du foretrække at oprette en ny nøgle og derefter slette den gamle for at undgå afbrydelser
  • Sæt altid en udløbsdato på dine nøgler
  • Automatisér rotation med et planlagt script (månedligt, kvartalsvist eller årligt baseret på følsomhed)
  • Udløs øjeblikkelig rotation ved enhver personaleændring eller sikkerhedshændelse