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

Rotacija in brisanje ključev

Lekcija 4 od 14 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Rotacija: Obnova brez prekinitve
  2. Izvedba rotacije
  3. Brisanje ključa
  4. Avtomatizacija rotacije
  5. Ključne ugotovitve

Rotacija: Obnova brez prekinitve

Rotacija ključev je kritična varnostna praksa. Generira nov tajni ključ, ki nadomesti starega, brez da bi sam ključ izbrisali. Stari tajni ključ je takoj in trajno razveljavljen.

Izvedba rotacije

Rotacija rešuje težavo, ki je brisanje ne more: obnovo tajnega ključa brez izgube identitete ključa. Njegovi seznami nadzora dostopa (ACL), omejitve hitrosti in ime preživijo operacijo, zato vam ni treba ničesar ponovno konfigurirati – v vašem trezorju se spremeni le tajni ključ. To naredi redno rotacijo izvedljivo; ponovno ustvarjanje ključa bi zahtevalo vsakič ponovno konfiguracijo vsega.

POST /auth/api-keys/{apiKeyId}/rotate
curl -X POST "https://management-api.x.ai/auth/api-keys/$API_KEY_ID/rotate" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Obnašanje pri rotaciji

  • Stari tajni ključ je takoj razveljavljen – vse zahteve, ki ga uporabljajo, bodo zavrnjene z napako 401
  • Generiran je nov tajni ključ, ki je vrnjen v odgovoru
  • ID ključa (apiKeyId), ime, ACL-ji in omejitve hitrosti ostanejo nespremenjeni
  • Nov tajni ključ je prikazan samo enkrat – takoj ga shranite

Varen postopek rotacije

En del tega postopka si zasluži poudarek, saj pogosto preseneti uporabnike: stari tajni ključ je razveljavljen takoj. Ni obdobja milosti, ko bi delovala oba tajna ključa. Vse storitve, ki še vedno uporabljajo staro vrednost, bodo odpovedale sekundo po klicu. To narekuje vrstni red spodnjih šestih korakov: svoj trezor pripravite pred sprožitvijo rotacije, ne po njej.

  1. Pripravite svojo infrastrukturo za sprejem novega ključa (spremenljivka okolja, trezor)
  2. Izvedite rotacijo prek API-ja
  3. Posodobite tajni ključ v svojem trezorju takoj
  4. Ponovno uvedite svoje storitve z novim ključem
  5. Preverite, ali zahteve z novim ključem uspejo
  6. Preverite propagacijo z GET /auth/api-keys/{apiKeyId}/propagation

Kdaj izvesti rotacijo

Tri situacije sprožijo rotacijo, vsaka z drugačno nujnostjo. Sum na uhajanje zahteva takojšnjo rotacijo: član ekipe z dostopom do ključa odide, dnevnik, ki vsebuje ključ, je javno izpostavljen ali pa Git skladišče vsebuje ključ v navadnem besedilu. V teh primerih je vsaka ura čakanja ura izpostavljenosti, zato rotacijo izvedite pred zaključkom analize incidenta. Rotacija na podlagi pravilnika je preventivna: vsakih 30, 60 ali 90 dni, odvisno od vaših varnostnih zahtev, omeji življenjsko dobo ključa, ki bi se lahko neopazno uhajal. Nazadnje so spremembe okolja – selitev infrastrukture ali zamenjava ponudnika – naravna priložnost za nov začetek s čistimi ključi, namesto da bi stare prenašali v kontekst, za katerega niso bili zasnovani.

Brisanje ključa

Brisanje je trajno in nepovratno. Vprašanje, ki si ga morate zastaviti pred brisanjem, ni „Ali je ta ključ ogrožen?”, temveč „Ali še vedno potrebujem ta obseg dostopa?” Če je odgovor pritrdilen, potrebujete rotacijo: ta nevtralizira izpostavljeni tajni ključ, hkrati pa ohrani konfiguracijo. Brisanje je upravičeno le za ključ, ki ni več uporaben – ustavljen projekt, odšli dobavitelj ali ukinjeno okolje.

DELETE /auth/api-keys/{apiKeyId}
curl -X DELETE "https://management-api.x.ai/auth/api-keys/$API_KEY_ID" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Posledice brisanja

  • Ključ in vsi njegovi parametri so trajno izbrisani
  • Vse zahteve, ki uporabljajo ta ključ, bodo takoj odpovedale
  • Dejanje je nepovratno – ustvariti boste morali nov ključ z novimi parametri
  • Zgodovina uporabe ključa ostane na voljo v analitiki

Rotacija proti brisanju

VidikRotacijaBrisanje
Ključ še obstajaDaNe
Generiran nov tajni ključDaNe
ACL-ji ohranjeniDaNe
Omejitve ohranjeneDaNe
PovratnoNe (stari tajni ključ izgubljen)Ne (ključ izbrisan)
Tipična uporabaRedna obnovaZastarel ključ ali potrjena ogroženost

Avtomatizacija rotacije

Avtomatizirana rotacija ima smisel le, če je zapisovanje v trezor del iste skripte, brez ročnega posredovanja vmes. V nasprotnem primeru tveganje le premaknete: strojno generiran tajni ključ, kopiran ročno, ima večjo verjetnost, da konča v odložišču ali zgodovini terminala, kot ključ, ustvarjen iz konzole.

import requests
import json

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
KEY_ID = "key-123"

# Rotacija
response = requests.post(
    f"{MANAGEMENT_API}/auth/api-keys/{KEY_ID}/rotate",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)

new_key = response.json()
new_secret = new_key.get("secret")

# Shrani v svoj trezor (primer z datoteko .env)
# V proizvodnem okolju uporabite Vault, AWS Secrets Manager itd.
print(f"Nov ključ generiran. Posodobite svoj trezor.")

Načrtovana rotacija

Rotacijo integrirajte v svoj cevovod CI/CD ali opravilo cron:

# Primer Cron: rotacija 1. dan v mesecu ob 3. uri zjutraj
0 3 1 * * /opt/scripts/rotate-xai-keys.sh

Ključne ugotovitve

  • POST /auth/api-keys/{apiKeyId}/rotate razveljavi stari tajni ključ in generira novega
  • Razveljavitev starega tajnega ključa je takojšnja in trajna
  • DELETE /auth/api-keys/{apiKeyId} nepovratno izbriše ključ
  • Prednost dajte rotaciji pred brisanjem, da ohranite obstoječe ACL-je in omejitve
  • Avtomatizirajte rotacijo s skripto in trezorjem za tajne ključe
  • Po rotaciji vedno preverite propagacijo