Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Zavrtanje ključev in življenjski cikel

Lekcija 7 od 12 Posodobljeno 28. julij 2026 Napredni
Na tej strani
  1. Zakaj je zavrtanje ključev nujno
  2. Zavrtanje prek upravnega API-ja
  3. Celoten življenjski cikel ključa
  4. Katero strategijo zavrtanja naj sprejmeš?
  5. Dvajset minut za ponovni prevzem nadzora nad svojim inventarjem
  6. Ključne ugotovitve

Zakaj je zavrtanje ključev nujno

Pogost ugovor na usposabljanjih se glasi: „Moj ključ še nikoli ni uhajal, zakaj bi ga menjal?” Odgovor se skriva v eni sami besedi: negotovost. Nikoli ne moreš dokazati, da ključ ni bil razkrit – pozabljen obsežen dnevnik na strežniku, posnetek zaslona, deljen v podpori, ali ogrožena delovna postaja razvijalca pred šestimi meseci. Redno zavrtanje to negotovost spremeni v omejeno tveganje: tudi če je bil ključ kopiran brez tvoje vednosti, bo ob naslednjem zavrtanju prenehal delovati. Točno tako razmišljajo revizorji SOC 2; pričakujejo dokumentirano politiko zavrtanja. Temu pravimo zmanjševanje časovne napadalne površine: dlje kot ključ živi, daljše je okno za izkoriščanje tihega vdora.

Upravni API xAI je zasnovan tako, da je ta praksa neboleča: ponuja namensko končno točko, ki ti omogoča zavrtanje ključa brez prepisovanja konfiguracij.

Zavrtanje prek upravnega API-ja

Končna točka za zavrtanje je preprosta:

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

Pred uporabo tega klica se prepričaj, da razumeš, kaj počne: ustvari nov tajni ključ za obstoječi ID in trajno razveljavi starega, pri čemer ohrani sezname nadzora dostopa (ACL), omejitve hitrosti in konfiguracije, povezane s ključem. Ekipam se prvič zgodi presenečenje, ker je sprememba takojšnja in nepovratna. Če tvoje produkcijsko zaledje uporablja ta ključ, ko sprožiš zavrtanje, bo v nekaj sekundah začelo prejemati napake pri overjanju. Ni obdobja milosti, ni možnosti za povrnitev.

Zato v produkcijskem okolju običajno raje uporabiš dvostopenjski postopek, da se izogneš kakršnim koli prekinitvam. Najprej ustvari nov ključ prek POST /auth/teams/{teamId}/api-keys z enakimi dovoljenji kot stari. Nato preveri njegovo širjenje z GET /auth/api-keys/{newKeyId}/propagation – na novo ustvarjen ključ ni takoj znan po celotni infrastrukturi in prezgodnja uvedba povzroči zmedene napake. Nato uvedeš novi ključ v svoja zaledja in preizkusiš, ali klici z njim dejansko delujejo, ne le, da se je uvedba končala brez napak. Šele ko imaš to potrditev, onemogoči stari ključ ali počakaj, da poteče, preden ga trajno izbrišeš z DELETE /auth/api-keys/{oldKeyId}.

Ta pristop „najprej novi ključ, nato brisanje” ti daje obdobje prekrivanja, ko sobivata oba ključa: če uvedba na enem strežniku ne uspe, se nič ne pokvari. Zavrtanje na mestu ostaja na voljo, če želiš ohraniti isti ID ključa:

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

V tem primeru načrtuj takojšnjo posodobitev svojih zaledij, saj stari ključ umre v trenutku, ko se klic zaključi.

Celoten življenjski cikel ključa

Dobro upravljan ključ ima zgodbo v štirih dejanjih. Ob ustvarjanju, prek POST /auth/teams/{teamId}/api-keys, določiš njegovo ime, sezname nadzora dostopa (ACL) in – to je navada, ki jo moraš utrditi – datum poteka:

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

Ključ brez expireTime je ključ, ki bo živel večno, če se nihče ne spomni nanj; ključ z datumom poteka prisili tvojo ekipo, da si na določen datum zastavi vprašanje o podaljšanju. Nato sledi spremljanje: GET /v1/api-key ti pove stanje ključa (api_key_blocked, api_key_disabled), konzola xAI pa prikazuje uporabo in anomalije. Za spremembe sredi življenjske dobe – preimenovanje, prilagajanje ACL, zaostritev omejitev hitrosti, podaljšanje poteka – uporabi PUT https://management-api.x.ai/auth/api-keys/{api_key_id}. Končno je brisanje, DELETE /auth/api-keys/{apiKeyId}, trajno in nepovratno: vsaka aplikacija, ki uporablja ta ključ, takoj preneha delovati. Pred brisanjem se prepričaj, da nobena pozabljena storitev – mesečni cron, skript za poročanje – ni več odvisna od njega.

Katero strategijo zavrtanja naj sprejmeš?

Prava pogostost je odvisna od občutljivosti tvojega okolja. Mesečno zavrtanje je obvezno v zelo občutljivih kontekstih, kot so finance ali zdravstvo, kjer mora biti okno izpostavljenosti minimalno. Četrtletno zavrtanje ustreza standardnim poslovnim okoljem: dovolj pogosto, da je učinkovito, dovolj razmaknjeno, da ne obremenjuje ekip. Letno zavrtanje v povezavi z določenim datumom poteka je sprejemljiv minimum – pod tem tvoja politika zavrtanja v resnici ni politika. V vseh primerih te avtomatizacija prek načrtovanega skripta reši odvisnosti od spomina skrbnika.

Temu razporedu dodaja še zavrtanje, gonjeno z dogodki, ki ga sprožijo okoliščine in ne datum. Najpogosteje ga sprožiš ob odhodu zaposlenega, ki je imel dostop do ključev: tudi če je ločitev prijateljska, se mora ključ, ki ga je poznal, zavrteti isti dan – to je pravilo varnostne higiene, ne znak nezaupanja. Enako stori v primeru suma na vdor, varnostnega incidenta v tvoji infrastrukturi ali spremembe ponudnika, ki je imel dostop do tvojih sistemov.

Dvajset minut za ponovni prevzem nadzora nad svojim inventarjem

Najboljši čas za odkrivanje dejanskega stanja tvojih ključev ni dan revizije. Zato zdaj izpiši vse svoje ključe z GET /auth/teams/{teamId}/api-keys in identificiraj tiste brez poteka, da jim dodaš expireTime. Za vsakega se vprašaj, ali njegovi ACL ustrezajo strogo najmanjšemu obsegu, ki ga zahteva aplikacija, ki ga uporablja; ključ, ustvarjen za prototip in ponovno uporabljen v produkciji, skoraj vedno nosi preveč pravic.

Nato izbriši neuporabljene ključe, saj je vsak aktivni ključ potencialen napadalni vektor, ključ, na katerega se nihče ne spomni, pa je najslabši od vseh: nihče ne bo opazil njegove nenormalne uporabe. Zaključi z dokumentiranjem, kdo ima dostop do katerega ključa in zakaj. Ta dokument, bolj kot sami ključi, je tisto, kar boš potegnil ven ob naslednji reviziji.

Ključne ugotovitve

  • Končna točka POST /auth/api-keys/{id}/rotate trajno razveljavi stari ključ brez obdobja milosti
  • V produkciji raje ustvari nov ključ, nato pa izbriši starega, da se izogneš prekinitvam
  • Vedno nastavi datum poteka za svoje ključe
  • Avtomatiziraj zavrtanje z načrtovanim skriptom (mesečno, četrtletno ali letno glede na občutljivost)
  • Sproži takojšnje zavrtanje ob vsaki spremembi osebja ali varnostnem incidentu