Rotacija in brisanje ključev
Na tej strani
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.
- Pripravite svojo infrastrukturo za sprejem novega ključa (spremenljivka okolja, trezor)
- Izvedite rotacijo prek API-ja
- Posodobite tajni ključ v svojem trezorju takoj
- Ponovno uvedite svoje storitve z novim ključem
- Preverite, ali zahteve z novim ključem uspejo
- 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
| Vidik | Rotacija | Brisanje |
|---|---|---|
| Ključ še obstaja | Da | Ne |
| Generiran nov tajni ključ | Da | Ne |
| ACL-ji ohranjeni | Da | Ne |
| Omejitve ohranjene | Da | Ne |
| Povratno | Ne (stari tajni ključ izgubljen) | Ne (ključ izbrisan) |
| Tipična uporaba | Redna obnova | Zastarel 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}/rotaterazveljavi 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