Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Võtmete rotatsioon ja elutsükkel

Õppetund 7 / 12 Värskendatud 28. juuli 2026 Edasijõudnutele
Sellel lehel
  1. Miks on võtmete rotatsioon hädavajalik
  2. Rotatsioon haldus-API kaudu
  3. Võtme täielik elutsükkel
  4. Millist rotatsioonistrateegiat peaksid valima?
  5. Kakskümmend minutit oma inventuuri kontrolli alla saamiseks
  6. Peamised punktid

Miks on võtmete rotatsioon hädavajalik

Koolitustel kuuleb sageli vastuväidet: „Mu võti pole kunagi lekkinud, miks seda vahetada?“ Vastus taandub ühele sõnale: määramatus. Sa ei saa kunagi tõestada, et võti pole paljastunud – kas ununenud detailne logi serveris, tugipiletisse jagatud ekraanitõmmis või kuus kuud tagasi kompromiteeritud arendaja tööjaam. Regulaarne rotatsioon muudab selle määramatuse piiratud riskiks: isegi kui võti kopeeriti sinu teadmata, lakkab see järgmisel rotatsioonil töötamast. Just seda arutluskäiku kasutavad SOC 2 audiitorid; nad eeldavad dokumenteeritud rotatsioonipoliitikat. Seda nimetame ajalise rünnakupinna vähendamiseks: mida kauem võti eksisteerib, seda pikem on vaikse kompromiteerimise ärakasutamise aken.

xAI haldus-API on loodud selle tava valutuks muutmiseks: see pakub spetsiaalset lõpppunkti, mis võimaldab võtit vahetada ilma konfiguratsioone ümber kirjutamata.

Rotatsioon haldus-API kaudu

Rotatsiooni lõpppunkt on lihtne:

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

Enne kasutamist veendu, et mõistad, mida see päring teeb: see genereerib olemasoleva ID jaoks uue salajase võtme ja tühistab vana pöördumatult, säilitades samal ajal võtmega seotud ACL-id, kiirusepiirangud ja konfiguratsioonid. See, mis meeskondi esmakordselt üllatab, on asjaolu, et muudatus on kohene ja pöördumatu. Kui sinu tootmiskeskkonna taustasüsteem kasutab seda võtit rotatsiooni käivitamise hetkel, hakkab see sekundite jooksul vastu võtma autentimisvigu. Armuaega pole, tagasipööramise võimalust pole.

Seetõttu eelistatakse tootmiskeskkonnas katkestuste vältimiseks kaheastmelist protseduuri. Esmalt loo uus võti kasutades POST /auth/teams/{teamId}/api-keys, määrates sellele täpselt samad õigused kui vanal võtmel. Seejärel kontrolli selle levikut käsuga GET /auth/api-keys/{newKeyId}/propagation – värskelt loodud võti ei ole kohe kogu taristus teada ja liiga vara kasutuselevõtt tekitab segaseid vigu. Järgmiseks vii uus võti oma taustasüsteemidesse ja testi, et päringud sellega tegelikult töötavad, mitte ainult ei lõpe deployimine veatult. Alles kui oled selle kinnituse saanud, keela vana võti või lase sellel aeguda, enne kui kustutad selle püsivalt käsuga DELETE /auth/api-keys/{oldKeyId}.

See „uus võti, siis kustuta“ lähenemine annab ülekatteperioodi, kus mõlemad võtmed eksisteerivad paralleelselt: kui deployimine ühel serveril ebaõnnestub, ei katke midagi. Kohapealne rotatsioon on endiselt võimalik, kui soovid säilitada sama võtme ID:

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

Sel juhul planeeri oma taustasüsteemide viivitamatu uuendamine, kuna vana võti sureb hetkel, kui päring lõpeb.

Võtme täielik elutsükkel

Hästi hallataval võtmel on neljavaatuseline lugu. Loomise hetkel, kasutades POST /auth/teams/{teamId}/api-keys, määrad selle nime, ACL-id ja – see on harjumus, mis tuleb juurutada – selle aegumiskuupäeva:

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

Võti ilma expireTime-ta on võti, mis elab igavesti, kui keegi sellele ei mõtle; aegumisega võti sunnib sinu meeskonda kindlal kuupäeval küsimust uuendamisest esitama. Järgneb jälgimine: GET /v1/api-key annab teada võtme oleku (api_key_blocked, api_key_disabled) ja xAI konsool paljastab kasutuse ning anomaaliad. Elutsükli keskel tehtavateks muudatusteks – ümbernimetamine, ACL-ide kohandamine, kiirusepiirangute karmistamine, aegumise edasilükkamine – kasuta PUT https://management-api.x.ai/auth/api-keys/{api_key_id}. Lõpuks, kustutamine DELETE /auth/api-keys/{apiKeyId} on püsiv ja pöördumatu: iga rakendus, mis seda võtit kasutab, lakkab koheselt töötamast. Enne kustutamist veendu, et ükski unustatud teenus – igakuine cron-töö, raporteerimisskript – sellest enam ei sõltu.

Millist rotatsioonistrateegiat peaksid valima?

Õige sagedus sõltub sinu keskkonna tundlikkusest. Igakuine rotatsioon on kohustuslik väga tundlikes kontekstides, nagu rahandus või tervishoid, kus kokkupuuteaken peab jääma minimaalseks. Kvartaalne rotatsioon sobib tavapärastesse professionaalsetesse keskkondadesse: piisavalt sage, et olla efektiivne, piisavalt harv, et meeskondi mitte koormata. Aastane rotatsioon koos määratletud aegumiskuupäevaga on vastuvõetav miinimum – sellest allpool ei ole sinu rotatsioonipoliitika tegelikult poliitika. Kõigil juhtudel päästab automatiseerimine ajastatud skripti abil sind sõltuvusest administraatori mälust.

Sündmustepõhine rotatsioon täiendab seda graafikut, käivitudes asjaolude, mitte kuupäeva põhjal. Kõige sagedamini käivitad selle töötaja lahkumisel, kellel oli juurdepääs võtmetele: isegi kui lahkumine on sõbralik, peab tema teada olev võti samal päeval vahetuma – see on turvahügieeni reegel, mitte usaldamatuse märk. Tee sama kahtlustatava kompromiteerimise, sinu taristus toimunud turvaintsidendi või süsteemidele juurdepääsu omava teenusepakkuja vahetuse korral.

Kakskümmend minutit oma inventuuri kontrolli alla saamiseks

Parim aeg oma võtmete tegeliku seisundi avastamiseks pole auditi päev. Seega loetle kohe kõik oma võtmed käsuga GET /auth/teams/{teamId}/api-keys ja tuvasta need, millel puudub aegumine, et lisada expireTime. Igaühe puhul küsi endalt, kas selle ACL-id vastavad rakenduse jaoks vajalikule rangele miinimumile; prototüübi jaoks loodud ja tootmisse ümber kasutatud võti kannab peaaegu alati liiga palju õigusi.

Seejärel kustuta kasutamata võtmed, sest iga aktiivne võti on potentsiaalne rünnakuvektor, ja võti, mida keegi ei mäleta, on kõige hullem: keegi ei märka selle ebanormaalset kasutust. Lõpeta dokumenteerimisega, kellel on millisele võtmele juurdepääs ja miks. See dokument, rohkem kui võtmed ise, on see, mida võtad välja järgmisel auditil.

Peamised punktid

  • Lõpppunkt POST /auth/api-keys/{id}/rotate tühistab vana võtme pöördumatult, ilma igasuguse armuajata
  • Tootmiskeskkonnas eelista uue võtme loomist ja seejärel vana kustutamist, et vältida katkestusi
  • Määra oma võtmetele alati aegumiskuupäev
  • Automatiseeri rotatsiooni ajastatud skriptiga (igakuine, kvartaalne või aastane, sõltuvalt tundlikkusest)
  • Käivita viivitamatu rotatsioon iga personalimuutuse või turvaintsidendi korral