Rotation og sletning af nøgler
På denne side
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.
- Forbered din infrastruktur til at acceptere en ny nøgle (miljøvariabel, vault)
- Udfør rotationen via API’et
- Opdater hemmeligheden i dit vault med det samme
- Genudrul dine tjenester med den nye nøgle
- Verificer, at anmodninger succeeds med den nye nøgle
- 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
| Aspekt | Rotation | Sletning |
|---|---|---|
| Nøglen eksisterer stadig | Ja | Nej |
| Ny hemmelighed genereret | Ja | Nej |
| ACL’er bevaret | Ja | Nej |
| Begrænsninger bevaret | Ja | Nej |
| Reversibel | Nej (gammel hemmelighed tabt) | Nej (nøgle slettet) |
| Typisk brug | Regelmæssig fornyelse | Foræ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}/rotateugyldiggø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