Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Rotácia kľúčov a ich životný cyklus

Lekcia 7 z 12 Aktualizované 28. júla 2026 Pokročilý
Na tejto strane
  1. Prečo je rotácia kľúčov nevyhnutná
  2. Rotácia prostredníctvom Manažérskeho API
  3. Kompletný životný cyklus kľúča
  4. Akú stratégiu rotácie by si mal prijať?
  5. Dvadsať minút na získanie kontroly nad inventárom
  6. Kľúčové poznatky

Prečo je rotácia kľúčov nevyhnutná

Častou námietkou na školeniach býva: „Môj kľúč sa nikdy neunikol, prečo ho meniť?“ Odpoveď sa dá zhrnúť do jedného slova: neistota. Nikdy nedokážeš, že kľúč nebol vystavený – zabudnutý podrobný log na serveri, screenshot zdieľaný v support tickete alebo kompromitovaná pracovná stanica vývojára spred šiestich mesiacov. Pravidelná rotácia mení túto neistotu na ohraničené riziko: aj keby bol kľúč skopírovaný bez tvojho vedomia, pri ďalšej rotácii prestane fungovať. Presne takto uvažujú audítori SOC 2; očakávajú zdokumentovanú politiku rotácie. Hovoríme tomu zmenšovanie časového povrchu útoku: čím dlhšie kľúč žije, tým dlhšie je okno na zneužitie pri tichom kompromise.

Manažérske API od xAI je navrhnuté tak, aby bola táto prax bezbolestná: poskytuje vyhradený koncový bod, ktorý ti umožní rotovať kľúč bez prepisovania konfigurácií.

Rotácia prostredníctvom Manažérskeho API

Koncový bod pre rotáciu je priamočiary:

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

Pred použitím si musíš jasne uvedomiť, čo tento volanie robí: generuje nový tajný kľúč pre existujúce ID a trvalo zneplatní ten starý, pričom zachová ACL, limity rýchlosti a konfigurácie pripojené ku kľúču. Čo tímy prvýkrát zaskočí, je okamžitá a nezvratná zmena. Ak tvoj produkčný backend používa tento kľúč v momente, keď spustíš rotáciu, do niekoľkých sekúnd začne dostávať chyby overenia. Neexistuje žiadna lehota na prechod, ani spôsob, ako vrátiť zmeny späť.

Preto v produkcii všeobecne uprednostňuješ dvojkrokový postup, aby si sa vyhol akémukoľvek výpadku. Najprv vytvor nový kľúč cez POST /auth/teams/{teamId}/api-keys s presne rovnakými oprávneniami ako ten starý. Následne over jeho šírenie pomocou GET /auth/api-keys/{newKeyId}/propagation – novo vytvorený kľúč nie je okamžite známy v celej infraštruktúre a príliš skoré nasadenie spôsobuje mätúce chyby. Ďalej nasaď nový kľúč na svoje backendy a otestuj, že volania skutočne fungujú, nielen že nasadenie prebehlo bez chýb. Až keď máš toto potvrdenie, deaktivuj starý kľúč alebo počkaj, kým vyprší jeho platnosť, a následne ho trvalo odstráň pomocou DELETE /auth/api-keys/{oldKeyId}.

Tento prístup „najprv nový kľúč, potom zmazať“ ti dáva prekryvné obdobie, keď koexistujú oba kľúče: ak nasadenie na jednom serveri zlyhá, nič sa nerozbije. Rotácia na mieste zostáva dostupná, ak chceš zachovať rovnaké ID kľúča:

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

V tomto prípade si naplánuj okamžitú aktualizáciu backendov, pretože starý kľúč zomrie v okamihu dokončenia volania.

Kompletný životný cyklus kľúča

Dobre spravovaný kľúč má príbeh rozdelený do štyroch dejstiev. Pri vytvorení cez POST /auth/teams/{teamId}/api-keys definuješ jeho názov, ACL a – toto je zvyk, ktorý si musíš osvojiť – dátum vypršania platnosti:

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

Kľúč bez expireTime je kľúč, ktorý bude žiť večne, ak si naň nikto nespomenie; kľúč s dátumom vypršania núti tvoj tím položiť si otázku obnovy v stanovený termín. Ďalej prichádza monitorovanie: GET /v1/api-key ti povie stav kľúča (api_key_blocked, api_key_disabled) a konzola xAI zobrazuje využitie a anomálie. Pre úpravy počas životnosti – premenovanie, úpravu ACL, sprísnenie limitov rýchlosti, posunutie dátumu vypršania – použi PUT https://management-api.x.ai/auth/api-keys/{api_key_id}. Nakoniec, vymazanie cez DELETE /auth/api-keys/{apiKeyId} je trvalé a nezvratné: akákoľvek aplikácia používajúca tento kľúč okamžite prestane fungovať. Pred vymazaním sa uisti, že na ňom nezávisí žiadna zabudnutá služba – mesačný cron, skript na reportovanie.

Akú stratégiu rotácie by si mal prijať?

Správna frekvencia závisí od citlivosti tvojho prostredia. Mesačná rotácia je povinná vo vysoko citlivých kontextoch, ako sú financie alebo zdravotníctvo, kde musí zostať okno expozície minimálne. Štvrťročná rotácia vyhovuje štandardným profesionálnym prostrediam: dostatočne častá na efektivitu, dostatočne rozložená, aby nezaťažovala tímy. Ročná rotácia spolu s definovaným dátumom vypršania je prijateľné minimum – pod touto hranicou tvoja politika rotácie nie je skutočne politikou. Vo všetkých prípadoch ťa automatizácia pomocou naplánovaného skriptu zbaví závislosti na pamäti administrátora.

K tomuto harmonogramu pridávaš rotáciu riadenú udalosťami, spúšťanú okolnosťami namiesto dátumu. Najčastejšie ju spustíš pri odchode zamestnanca, ktorý mal prístup ku kľúčom: aj keď je rozlúčka priateľská, kľúč, ktorý poznal, sa musí rotovať v ten istý deň – toto je pravidlo bezpečnostnej hygieny, nie znak nedôvery. To isté urob v prípade podozrenia na kompromitáciu, bezpečnostného incidentu v tvojej infraštruktúre alebo zmeny dodávateľa, ktorý mal prístup k tvojim systémom.

Dvadsať minút na získanie kontroly nad inventárom

Najlepší čas na zistenie skutočného stavu tvojich kľúčov nie je deň auditu. Preto si teraz vypíš všetky svoje kľúče pomocou GET /auth/teams/{teamId}/api-keys a identifikuj tie bez dátumu vypršania, aby si im pridal expireTime. Pri každom si polož otázku, či jeho ACL zodpovedajú striktnému minimu požadovanému aplikáciou, ktorá ho používa; kľúč vytvorený pre prototyp a recyklovaný do produkcie takmer vždy nesie príliš veľa práv.

Následne odstráň nepoužívané kľúče, pretože každý aktívny kľúč je potenciálnym vektorom útoku a kľúč, na ktorý si nikto nespomína, je tým najhorším: nikto si nevšimne jeho abnormálne použitie. Na záver zdokumentuj, kto má prístup ku ktorému kľúču a prečo. Tento dokument, viac než samotné kľúče, je to, čo vytiahneš pri ďalšom audite.

Kľúčové poznatky

  • Koncový bod POST /auth/api-keys/{id}/rotate trvalo zneplatní starý kľúč bez lehoty na prechod
  • V produkcii uprednostni vytvorenie nového kľúča a následné vymazanie starého, aby sa predišlo výpadkom
  • Vždy nastav kľúčom dátum vypršania platnosti
  • Automatizuj rotáciu pomocou naplánovaného skriptu (mesačne, štvrťročne alebo ročne podľa úrovne citlivosti)
  • Okamžite spusti rotáciu pri akejkoľvek zmene personálu alebo bezpečnostnom incidente