Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Atslēgu rotācija un dzīves cikls

Nodarbība 7 no 12 Atjaunota 2026. gada 28. jūlijs Augstākais
Šajā lapā
  1. Kāpēc atslēgu rotācija ir būtiska
  2. Rotācija, izmantojot vadības API
  3. Pilns atslēgas dzīves cikls
  4. Kuru rotācijas stratēģiju pieņemt?
  5. Divdesmit minūtes, lai atgūtu kontroli pār savu inventāru
  6. Galvenās atziņas

Kāpēc atslēgu rotācija ir būtiska

Biežs iebildums apmācību sesijās ir: „Mana atslēga nekad nav noplūdusi, kāpēc to mainīt?” Atbilde slēpjas vienā vārdā: nenoteiktība. Tu nevari pierādīt, ka atslēga nav bijusi pakļauta riskam — aizmirsts detalizēts žurnāls serverī, ekrānuzņēmums, kopīgots atbalsta pieteikumā, vai apdraudēta izstrādātāja darbstacija pirms sešiem mēnešiem. Regulāra rotācija pārvērš šo nenoteiktību ierobežotā riskā: pat ja atslēga tikusi nokopēta bez tava ziņas, tā pārstās darboties nākamās rotācijas brīdī. Tieši tādu loģiku izmanto SOC 2 auditori; viņi sagaida dokumentētu rotācijas politiku. To mēs saucam par laika uzbrukuma virsmas samazināšanu: jo ilgāk atslēga eksistē, jo ilgāks ir izmantošanas logs klusai kompromitācijai.

xAI vadības API ir izstrādāts tā, lai šī prakse būtu nesāpīga: tas nodrošina specializētu galapunktu, kas ļauj rotēt atslēgu, nepārrakstot tavas konfigurācijas.

Rotācija, izmantojot vadības API

Rotācijas galapunkts ir vienkāršs:

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

Pirms šī izsaukuma veikšanas pārliecinies, ka saproti, ko tas dara: tas ģenerē jaunu slepeno atslēgu esošajam ID un neatgriezeniski atzīst veco par nederīgu, vienlaikus saglabājot atslēgai piesaistītos ACL, ātruma ierobežojumus un konfigurācijas. Tas, kas komandas pirmajā reizē pārsteidz, ir fakts, ka izmaiņas stājas spēkā nekavējoties un ir neatgriezeniskas. Ja tava produkcijas backend sistēma izmanto šo atslēgu rotācijas brīdī, tā dažu sekunžu laikā sāks saņemt autentifikācijas kļūdas. Nav iepazīšanās perioda, nav iespējas veikt atgriešanu.

Tieši tāpēc produkcijas vidē parasti izvēlas divu soļu procedūru, lai izvairītos no jebkādiem pārtraukumiem. Vispirms izveido jaunu atslēgu, izmantojot POST /auth/teams/{teamId}/api-keys, ar tieši tādām pašām atļaujām kā vecajai. Tad pārbaudi tās izplatīšanu ar GET /auth/api-keys/{newKeyId}/propagation — tikko izveidota atslēga nav uzreiz zināma visā infrastruktūrā, un pārāk agrīna izvietošana rada mulsinošas kļūdas. Tālāk izvieto jauno atslēgu savos backend serveros un pārbaudi, vai izsaukumi ar to faktiski strādā, nevis tikai tas, ka izvietošana beidzās bez kļūdām. Tikai pēc šī apstiprinājuma atspējo veco atslēgu vai ļauj tai sasniegt derīguma termiņa beigas, pirms to neatgriezeniski dzēs ar DELETE /auth/api-keys/{oldKeyId}.

Šī pieeja „jauna atslēga, tad dzēšana” nodrošina pārklāšanās periodu, kurā abas atslēgas pastāv līdzās: ja izvietošana vienā serverī neizdodas, nekas nesalūst. Rotācija uz vietas joprojām ir pieejama, ja vēlies saglabāt to pašu atslēgas ID:

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

Šajā gadījumā plāno savu backend sistēmu atjaunināšanu nekavējoties, jo vecā atslēga pārstāj darboties brīdī, kad izsaukums ir pabeigts.

Pilns atslēgas dzīves cikls

Pārvaldītai atslēgai ir četru cēlienu stāsts. Izveides brīdī, izmantojot POST /auth/teams/{teamId}/api-keys, tu definē tās nosaukumu, ACL un — šis ir ieradums, kas jānostiprina — tās derīguma termiņu:

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

Atslēga bez expireTime ir atslēga, kas dzīvos mūžīgi, ja neviens par to nepadomās; atslēga ar derīguma termiņu liek tavai komandai uzdot jautājumu par atjaunošanu noteiktā datumā. Tālāk seko monitorings: GET /v1/api-key parāda atslēgas statusu (api_key_blocked, api_key_disabled), un xAI konsole atklāj lietojumu un anomālijas. Dzīves cikla vidusposma izmaiņām — pārdēvēšanai, ACL pielāgošanai, ātruma ierobežojumu pastiprināšanai, derīguma termiņa pagarināšanai — izmanto PUT https://management-api.x.ai/auth/api-keys/{api_key_id}. Visbeidzot, dzēšana, DELETE /auth/api-keys/{apiKeyId}, ir neatgriezeniska: jebkura lietotne, kas izmanto šo atslēgu, pārstāj darboties uzreiz. Pirms dzēšanas pārliecinies, ka neviena aizmirsta servisa — ikmēneša cron uzdevums, ziņošanas skripts — vairs nav atkarīga no tās.

Kuru rotācijas stratēģiju pieņemt?

Pareizais biežums ir atkarīgs no tavas vides sensitivitātes. Ikmēneša rotācija ir obligāta augsti sensitīvās vidēs, piemēram, finanšu vai veselības aprūpes nozarē, kur pakļautības logam jābūt minimālam. Ceturkšņa rotācija ir piemērota standarta profesionālām vidēm: pietiekami bieža, lai būtu efektīva, un pietiekami reta, lai neapgrūtinātu komandas. Gada rotācija, apvienojumā ar noteiktu derīguma termiņu, ir pieņemams minimums — zem tā tava rotācijas politika patiesībā nav politika. Visos gadījumos automatizācija, izmantojot ieplānotu skriptu, pasargā tevi no atkarības no administratora atmiņas.

Notikumu virzīta rotācija papildina šo grafiku, tiek aktivizēta apstākļu, nevis datuma dēļ. Visbiežāk to aktivizēsi darbinieka aiziešanas gadījumā, kuram bija piekļuve atslēgām: pat ja šķiršanās ir draudzīga, atslēgai, ko viņš zināja, jābūt rotētai tajā pašā dienā — tas ir drošības higiēnas noteikums, nevis neuzticēšanās zīme. Dari to pašu aizdomu gadījumā par kompromitāciju, drošības incidenta gadījumā tavā infrastruktūrā vai mainoties piegādātājam, kuram bija piekļuve tavām sistēmām.

Divdesmit minūtes, lai atgūtu kontroli pār savu inventāru

Labākais laiks, lai atklātu patieso savu atslēgu stāvokli, nav audita diena. Tāpēc uzskaiti visas savas atslēgas tagad, izmantojot GET /auth/teams/{teamId}/api-keys, un identificē tās, kurām nav derīguma termiņa, lai pievienotu expireTime. Katrai no tām pajautā sev, vai tās ACL atbilst stingrajam minimumam, kas nepieciešams lietotnei, kura to izmanto; atslēga, kas izveidota prototipam un pārnesta uz produkciju, gandrīz vienmēr nes pārāk daudz tiesību.

Tad dzēs neizmantotās atslēgas, jo katra aktīva atslēga ir potenciāls uzbrukuma vektors, un atslēga, ko neviens neatceras, ir vissliktākā no visām: neviens nepamanīs tās neparasto izmantošanu. Noslēgumā dokumentē, kam ir piekļuve kurai atslēgai un kāpēc. Šis dokuments, vairāk nekā pašas atslēgas, ir tas, ko tu izvilksi nākamajā auditā.

Galvenās atziņas

  • Galapunkts POST /auth/api-keys/{id}/rotate atzīst veco atslēgu par nederīgu neatgriezeniski, bez iepazīšanās perioda
  • Produkcijas vidē dod priekšroku jaunas atslēgas izveidei, pēc tam dzēšot veco, lai izvairītos no pārtraukumiem
  • Vienmēr iestati savām atslēgām derīguma termiņu
  • Automatizē rotāciju ar ieplānotu skriptu (ikmēneša, ceturkšņa vai gada, atkarībā no sensitivitātes)
  • Aktivizē tūlītēju rotāciju pie jebkurām personāla izmaiņām vai drošības incidenta