Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Rotering och livscykel för nycklar

Lektion 7 av 12 Uppdaterad 28 juli 2026 Avancerad
På denna sida
  1. Varför nyckelrotering är avgörande
  2. Rotering via Management API
  3. Nyckelns kompletta livscykel
  4. Vilken roteringsstrategi bör du välja?
  5. Tjugo minuter för att återta kontrollen över ditt inventarium
  6. Viktiga punkter

Varför nyckelrotering är avgörande

Ett vanligt invändning under utbildningar är: “Min nyckel har aldrig läckt, varför byta den?” Svaret kokar ner till ett ord: osäkerhet. Du kan aldrig bevisa att en nyckel inte har exponerats – en utförlig logg glömd på en server, en skärmdump delad i ett supportärende, eller en komprometterad utvecklararbetsplats från för sex månader sedan. Regelbunden rotering omvandlar denna osäkerhet till en begränsad risk: även om en nyckel kopierades utan din vetskap, slutar den att fungera vid nästa rotering. Det är exakt detta resonemang SOC 2-revisorer använder; de förväntar sig en dokumenterad roteringspolicy. Detta kallar vi att reducera den tidsmässiga attackytan: ju längre en nyckel lever, desto längre är fönstret för exploatering vid en tyst kompromettering.

xAI:s Management API är designat för att göra denna process smärtfri: det tillhandahåller en dedikerad slutpunkt som låter dig rotera en nyckel utan att skriva om dina konfigurationer.

Rotering via Management API

Roteringsslutpunkten är enkel:

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

Se till att du förstår vad detta anrop gör innan du använder det: det genererar en ny hemlig nyckel för det befintliga ID:t och ogiltigförklarar permanent den gamla, samtidigt som ACL:er, hastighetsbegränsningar och konfigurationer kopplade till nyckeln behålls. Det som ofta tar team på sängen första gången är att ändringen är omedelbar och oåterkallelig. Om din produktionsbackend använder denna nyckel när du utlöser roteringen, börjar den ta emot autentiseringsfel inom sekunder. Det finns ingen grace-period, inget sätt att rulla tillbaka.

Därför föredrar du i produktion generellt en tvåstegsprocess för att undvika avbrott. Skapa först en ny nyckel via POST /auth/teams/{teamId}/api-keys, med exakt samma behörigheter som den gamla. Verifiera sedan dess spridning med GET /auth/api-keys/{newKeyId}/propagation – en nyskapad nyckel är inte omedelbart känd över hela infrastrukturen, och att distribuera för tidigt ger upphov till förvirrande fel. Därefter distribuerar du den nya nyckeln till dina backends och testar att anrop faktiskt fungerar med den, inte bara att distributionen avslutades utan fel. Först när du har denna bekräftelse bör du inaktivera den gamla nyckeln, eller låta den nå sitt utgångsdatum, innan du permanent tar bort den med DELETE /auth/api-keys/{oldKeyId}.

Denna “ny nyckel sedan radera”-metod ger dig en överlappningsperiod där båda nycklarna samexisterar: om distributionen misslyckas på en server går inget sönder. Rotering på plats finns fortfarande tillgänglig om du vill behålla samma nyckel-ID:

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

I detta fall måste du planera att uppdatera dina backends omedelbart, eftersom den gamla nyckeln dör i samma ögonblick som anropet slutförs.

Nyckelns kompletta livscykel

En välskött nyckel har en historia i fyra akter. Vid skapandet, via POST /auth/teams/{teamId}/api-keys, definierar du dess namn, dess ACL:er och – detta är vanan du måste cementera – dess utgångsdatum:

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

En nyckel utan expireTime är en nyckel som kommer leva för evigt om ingen tänker på den; en nyckel med utgångsdatum tvingar ditt team att ställa frågan om förnyelse vid ett fast datum. Därefter kommer övervakning: GET /v1/api-key berättar nyckelns status (api_key_blocked, api_key_disabled), och xAI-konsolen exponerar användning och anomalier. För modifieringar under livscykeln – namnbyte, justering av ACL:er, skärpning av hastighetsbegränsningar, flytt framåt av utgångsdatum – använd PUT https://management-api.x.ai/auth/api-keys/{api_key_id}. Slutligen är radering, DELETE /auth/api-keys/{apiKeyId}, permanent och oåterkallelig: varje applikation som använder denna nyckel slutar fungera omedelbart. Innan du raderar, säkerställ att ingen glömd tjänst – en månatlig cron, ett rapporteringsskript – fortfarande är beroende av den.

Vilken roteringsstrategi bör du välja?

Rätt frekvens beror på känsligheten i din miljö. Månatlig rotering är obligatorisk i mycket känsliga sammanhang som finans eller vård, där exponeringsfönstret måste hållas minimalt. Kvartalsvis rotering passar standardprofessionella miljöer: tillräckligt ofta för att vara effektivt, tillräckligt glest för att inte belasta teamen. Årlig rotering, kopplad till ett definierat utgångsdatum, är det acceptabla minimumet – under det är din roteringspolicy inte riktigt en policy. I alla fall sparar automatisering via ett schemalagt skript dig från att bero på en administratörs minne.

Händelsestyrd rotering läggs till detta schema, utlöst av omständigheter snarare än datum. Du kommer oftast utlösa den vid en anställds avgång som hade tillgång till nycklar: även om separationen är vänlig, måste nyckeln de kände till roteras samma dag – detta är en regel för säkerhetshygien, inte ett tecken på misstro. Gör detsamma vid misstänkt kompromettering, en säkerhetsincident i din infrastruktur, eller ett leverantörsbyte där någon hade tillgång till dina system.

Tjugo minuter för att återta kontrollen över ditt inventarium

Bästa tiden att upptäcka det verkliga tillståndet för dina nycklar är inte revisionsdagen. Lista därför alla dina nycklar nu med GET /auth/teams/{teamId}/api-keys och identifiera de utan utgångsdatum, för att lägga till ett expireTime. För var och en, fråga dig själv om dess ACL:er matchar det strikta minimum som krävs av applikationen som använder den; en nyckel skapad för en prototyp och återanvänd i produktion bär nästan alltid på för många rättigheter.

Radera sedan oanvända nycklar, eftersom varje aktiv nyckel är en potentiell attackvektor, och en nyckel som ingen kommer ihåg är värst av alla: ingen kommer märka dess onormala användning. Avsluta med att dokumentera vem som har tillgång till vilken nyckel och varför. Detta dokument, mer än nycklarna själva, är vad du kommer dra fram vid nästa revision.

Viktiga punkter

  • Slutpunkten POST /auth/api-keys/{id}/rotate ogiltigförklarar den gamla nyckeln permanent, utan någon grace-period
  • I produktion, föredra att skapa en ny nyckel och sedan radera den gamla för att undvika avbrott
  • Sätt alltid ett utgångsdatum på dina nycklar
  • Automatisera rotering med ett schemalagt skript (månadsvis, kvartalsvis eller årligen baserat på känslighet)
  • Utlös omedelbar rotering vid alla personalförändringar eller säkerhetsincidenter