Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Rotation og sletning af nøgler

Lektion 4 af 14 Opdateret 29. juli 2026 Udvikler
På denne side
  1. Rotation: Forny uden afbrydelser
  2. Udfør en rotation
  3. Slet en nøgle
  4. Automatisér rotation
  5. Vigtige pointer

Rotation: Forny uden afbrydelser

Rotation af nøgler er en kritisk sikkerhedspraksis. Det genererer en ny hemmelig nøgle til at erstatte den gamle, uden at selve nøglen slettes. Den gamle hemmelighed ugyldiggøres øjeblikkeligt og permanent.

Udfør en rotation

Rotation løser et problem, som sletning ikke kan: at fornye hemmeligheden uden at miste nøglens identitet. Dens ACL’er, hastighedsbegrænsninger og navn overlever operationen, så du behøver ikke at rekonfigurere noget – kun hemmeligheden ændres i dit vault. Dette gør regelmæssig rotation praktisk; at genoprette en nøgle ville kræve, at du rekonfigurerede alt hver gang.

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"

Rotationsadfærd

  • Den gamle hemmelige nøgle ugyldiggøres øjeblikkeligt – alle anmodninger, der bruger den, vil fejle med en 401-fejl
  • En ny hemmelig nøgle genereres og returneres i svaret
  • Nøgle-ID’et (apiKeyId), navn, ACL’er og hastighedsbegrænsninger forbliver uændrede
  • Den nye hemmelige nøgle vises kun én gang – gem den straks

Sikker rotationsproces

Én del af denne procedure fortjener særlig opmærksomhed, fordi det ofte overrasker brugere: den gamle hemmelighed ugyldiggøres øjeblikkeligt. Der er ingen grace-periode, hvor begge hemmeligheder fungerer. Tjenester, der stadig bruger den gamle værdi, vil fejle i samme sekund, kaldet udføres. Dette dikterer rækkefølgen af de seks trin nedenfor: Forbered dit vault før du udløser rotationen, ikke bagefter.

  1. Forbered din infrastruktur til at acceptere en ny nøgle (miljøvariabel, vault)
  2. Udfør rotationen via API’et
  3. Opdater hemmeligheden i dit vault med det samme
  4. Genudrul dine tjenester med den nye nøgle
  5. Verificer, at anmodninger succeeds med den nye nøgle
  6. Verificer udbredelsen via GET /auth/api-keys/{apiKeyId}/propagation

Hvornår skal du rotere?

Tre situationer udløser rotation, hver med forskellig hastegrad. Mistænkt lækage kræver øjeblikkelig rotation: Et teammedlem med nøgleadgang forlader virksomheden, en logfil indeholdende en nøgle eksponeres offentligt, eller et Git-repository indeholder en nøgle i klartekst. I disse tilfælde er hver time med venten en time med eksponering, så rotér før du afslutter hændelsesanalysen. Politikbaseret rotation er forebyggende: Hver 30., 60. eller 90. dag, afhængigt af dine sikkerhedskrav, begrænser det levetiden for en nøgle, der måske er lækket ubemærket. Endelig er miljøændringer – infrastrukturmigration eller udbyterskift – en naturlig mulighed for at starte forfra med rene nøgler i stedet for at bære gamle med ind i en kontekst, de aldrig var designet til.

Slet en nøgle

Sletning er permanent og uoprettelig. Spørgsmålet du skal stille før sletning, er ikke „Er denne nøgle kompromitteret?”, men „Har jeg stadig brug for dette adgangsområde?”. Hvis svaret er ja, har du brug for rotation: Det neutraliserer den eksponerede hemmelighed, mens konfigurationen bevares. Sletning er kun berettiget for en nøgle, der ikke længere er nyttig – et stoppet projekt, en leverandør der er gået væk, eller et nedlagt miljø.

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"

Konsekvenser af sletning

  • Nøglen og alle dens parametre slettes permanent
  • Alle anmodninger, der bruger denne nøgle, vil fejle øjeblikkeligt
  • Handlingen er uoprettelig – du skal oprette en ny nøgle med nye parametre
  • Nøglens brugshistorik forbliver tilgængelig i analytics

Rotation kontra sletning

AspektRotationSletning
Nøglen eksisterer stadigJaNej
Ny hemmelighed genereretJaNej
ACL’er bevaretJaNej
Begrænsninger bevaretJaNej
ReversibelNej (gammel hemmelighed tabt)Nej (nøgle slettet)
Typisk brugRegelmæssig fornyelseForældet nøgle eller bekræftet kompromittering

Automatisér rotation

Automatiseret rotation giver kun mening, hvis skrivning til vaultet er en del af samme script uden manuel indgriben imellem. Ellers flytter du blot risikoen: En maskinegenereret hemmelighed, der kopieres i hånden, har større sandsynlighed for at ende i en udklipsholder eller terminalhistorik end en nøgle oprettet fra konsollen.

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.")

Planlagt rotation

Integrér rotation i din CI/CD-pipeline eller et cron-job:

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

Vigtige pointer

  • POST /auth/api-keys/{apiKeyId}/rotate ugyldiggør den gamle hemmelighed og genererer en ny
  • Ugyldiggørelse af den gamle hemmelighed er øjeblikkelig og permanent
  • DELETE /auth/api-keys/{apiKeyId} sletter nøglen uopretteligt
  • Foretræk rotation frem for sletning for at bevare eksisterende ACL’er og begrænsninger
  • Automatisér rotation med et script og et hemmeligheds-vault
  • Verificér altid udbredelsen efter en rotation