Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Raktų rotacija ir gyvavimo ciklas

Paskaita 7 iš 12 Atnaujinta 2026 m. liepos 28 d. Pažengusiems
Šiame puslapyje
  1. Kodėl raktų rotacija yra būtina
  2. Rotacija naudojant Valdymo API
  3. Pilnas rakto gyvavimo ciklas
  4. Kokią rotacijos strategiją turėtum pasirinkti?
  5. Dvidešimt minučių, kad atgautum kontrolę over savo inventorių
  6. Svarbiausi punktai

Kodėl raktų rotacija yra būtina

Dažnas mokymų dalyvių argumentas skamba taip: „Mano raktas niekada nebuvo paviešintas, kodėl jį keisti?“ Atsakymas telpa į vieną žodį: netikrumas. Niekuomet negali įrodyti, kad raktas nebuvo atskleistas – pamirštas išsamus žurnalas serveryje, ekrano kopija, bendrinta palaikymo užklausoje, ar prieš šešis mėnesius užkrėsta kūrėjo darbo stotis. Reguliari rotacija šį netikrumą paverčia apibrėžta rizika: net jei raktas buvo nukopijuotas tau nežinant, jis nustos veikti kitos rotacijos metu. Būtent taip samprotauja SOC 2 auditoriai; jie tikisi dokumentuotos rotacijos politikos. Tai vadiname laiko atakų paviršiaus mažinimu: kuo ilgiau raktas gyvuoja, tuo ilgesnis yra tylios kompaktacijos išnaudojimo langas.

xAI valdymo API sukurta taip, kad ši praktika būtų neskausminga: ji suteikia specialią galutinę vietą (endpoint), leidžiančią sukurti naują raktą neperrašant konfigūracijų.

Rotacija naudojant Valdymo API

Rotacijos galutinė vieta yra paprasta:

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

Prieš naudodamas šį kvietimą, įsitikink, kad supranti, ką jis daro: jis sugeneruoja naują slaptąjį raktą esamam ID ir visam laikui pripažįsta senąjį negaliojančiu, išlaikydamas prie raktą priskirtas ACL, spartos ribas ir konfigūracijas. Kas pirmą kartą nustebina komandas, tai faktas, kad pakeitimas įvyksta iškart ir yra negrįžtamas. Jei tavo gamybinė serverio pusė (backend) naudoja šį raktą rotacijos metu, ji per kelias sekundes pradės gauti autentifikavimo klaidas. Nėra lengvatinio laikotarpio, nėra būdo grįžti atgal.

Štai kodėl gamybinėje aplinkoje paprastai renkiesi dviejų žingsnių procedūrą, kad išvengtum bet kokių sutrikimų. Pirma, sukurk naują raktą naudodamas POST /auth/teams/{teamId}/api-keys su точно tomis pačiomis teisėmis kaip ir senasis. Tada patikrink jo plitimą naudodamas GET /auth/api-keys/{newKeyId}/propagation – ką tik sukurtas raktas nėra akimirksniu žinomas visoje infrastruktūroje, o per ankstyvas diegimas sukelia painias klaidas. Kitas žingsnis – įdiegti naują raktą į savo serverius ir patikrinti, ar kvietimai su juo iš tikrųjų veikia, o ne tik tai, ar diegimas baigėsi be klaidų. Tik gavęs šį patvirtinimą, išjunk senąjį raktą arba palauk, kol jis pasieks galiojimo pabaigą, prieš jį visam laikui ištrindamas naudodamas DELETE /auth/api-keys/{oldKeyId}.

Šis „pirma naujas raktas, tada ištrynimas“ metodas suteikia persidengimo laikotarpį, kai abu raktai egzistuoja vienu metu: jei diegimas viename serveryje nepavyksta, niekas nesugriūva. Rotacija vietoje lieka prieinama, jei nori išlaikyti tą patį rakto ID:

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

Šiuo atveju planuokite savo serverius atnaujinti nedelsiant, nes senasis raktas nustoja galioti tą akimirką, kai kvietimas baigiamas.

Pilnas rakto gyvavimo ciklas

Gerai valdomas raktas turi keturių veiksmų istoriją. Kūrimo metu, naudojant POST /auth/teams/{teamId}/api-keys, apibrėži jo pavadinimą, ACL ir – tai įprotis, kurį reikia įtvirtinti – jo galiojimo pabaigos datą:

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

Raktas be expireTime yra raktas, kuris gyvuos amžinai, jei niekas apie jį negalvos; raktas su galiojimo laiku verčia tavo komandą fiksuotą datą kelti atnaujinimo klausimą. Toliau eina stebėsena: GET /v1/api-key nurodo rakto būseną (api_key_blocked, api_key_disabled), o xAI konsolė rodo naudojimą ir anomalijas. Gyvavimo vidurio pakeitimams – pervadinimui, ACL koregavimui, spartos ribų sugriežtinimui, galiojimo laiko pratęsimui – naudok PUT https://management-api.x.ai/auth/api-keys/{api_key_id}. Galiausiai, ištrynimas naudojant DELETE /auth/api-keys/{apiKeyId} yra galutinis ir negrįžtamas: bet kuri programa, naudojanti šį raktą, akimirksniu nustoja veikti. Prieš trindamas įsitikink, kad jokia pamiršta tarnyba – mėnesinis cron, ataskaitų scriptas – nuo jo nebepriklauso.

Kokią rotacijos strategiją turėtum pasirinkti?

Tinkamas dažnis priklauso nuo tavo aplinkos jautrumo. Mėnesinė rotacija yra privaloma itin jautriuose kontekstuose, pavyzdžiui, finansuose ar sveikatos priežiūroje, kur poveikio langas turi likti minimalus. Ketvirtinė rotacija tinka standartinėms profesinėms aplinkoms: pakankamai dažna, kad būtų efektyvi, ir pakankamai reta, kad neapsunkintų komandų. Metinė rotacija, kartu su nustatyta galiojimo pabaigos data, yra priimtinas minimumas – žemiau šios ribos tavo rotacijos politika iš tikrųjų nėra politika. Visais atvejais automatizavimas naudojant suplanuotą scriptą apsaugo tave nuo priklausomybės nuo administratoriaus atminties.

Įvykiais grįsta rotacija papildo šį grafiką ir yra inicijuojama ne pagal datą, o pagal aplinkybes. Dažniausiai ją inicijuosi darbuotojui, turėjusiam prieigą prie raktų, paliekant darbą: net jei išsiskyrimas yra malonus, raktas, kurį jis žinojo, turi būti pakeistas tą pačią dieną – tai saugumo higienos taisyklė, o ne nepasitikėjimo ženklas. Taip pat elkis įtariant kompaktaciją, įvykus saugumo incidentui tavo infrastruktūroje arba pasikeitus tiekėjui, kuris turėjo prieigą prie tavo sistemų.

Dvidešimt minučių, kad atgautum kontrolę over savo inventorių

Geriausias laikas sužinoti tikrąją savo raktų būklę yra ne audito diena. Todėl dabar išvardink visus savo raktus naudodamas GET /auth/teams/{teamId}/api-keys ir identifikuok tuos, kurie neturi galiojimo pabaigos, kad pridėtum expireTime. Kiekvienam jų paklausk savęs, ar jo ACL atitinka griežtą minimumą, reikalingą programai, kuri jį naudoja; raktas, sukurtas prototipui ir perkeltas į gamybą, beveik visada turi per daug teisių.

Tada ištrinkite nenaudojamus raktus, nes kiekvienas aktyvus raktas yra potencialus atakos vektorius, o raktas, kurio niekas neprisimena, yra pats blogiausias iš visų: niekas nepastebės jo nenormalaus naudojimo. Pabaigai dokumentuok, kas turi prieigą prie kurio rakto ir kodėl. Šis dokumentas, labiau nei patys raktai, yra tai, ką pateiksi per kitą auditą.

Svarbiausi punktai

  • Galutinė vieta POST /auth/api-keys/{id}/rotate pripažįsta senąjį raktą negaliojančiu visam laikui, be jokio lengvatinio laikotarpio
  • Gamybinėje aplinkoje teik pirmenybę naujo rakto kūrimui, o tada senojo ištrynimui, kad išvengtum bet kokių sutrikimų
  • Visada nustatykite galiojimo pabaigos datą savo raktams
  • Automatizuokite rotaciją naudodami suplanuotą scriptą (mėnesinį, ketvirtinį arba metinį, priklausomai nuo jautrumo)
  • Inicijuokite neatidėliotiną rotaciją įvykus bet kokiems personalo pokyčiams ar saugumo incidentams