Rotacija i brisanje ključeva
Na ovoj stranici
Rotacija: Obnova bez prekida
Rotacija ključeva ključna je sigurnosna praksa. Ona generira novu tajnu (secret key) kojom se zamjenjuje stara, a da se pritom ne briše sam ključ. Stara tajna odmah se i trajno poništava.
Izvrši rotaciju
Rotacija rješava problem koji brisanje ne može: obnavlja tajnu bez gubitka identiteta ključa. Njegove ACL liste, ograničenja brzine (rate limits) i naziv ostaju nepromijenjeni, pa ne moraš ništa ponovno konfigurirati—u tvojem spremištu tajni mijenja se samo tajna. To redovitu rotaciju čini praktičnom; ponovno stvaranje ključa zahtijevalo bi svaki put ponovnu konfiguraciju svega.
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"
Ponašanje pri rotaciji
- Stara tajna ključa odmah se poništava—svaki zahtjev koji je koristi vratit će pogrešku 401
- Generira se nova tajna ključa i vraća u odgovoru
- ID ključa (
apiKeyId), naziv, ACL liste i ograničenja brzine ostaju nepromijenjeni - Nova tajna ključa prikazuje se samo jednom—odmah je pohrani
Siguran postupak rotacije
Jedan dio ovog postupka zaslužuje naglasak jer često iznenadi korisnike: stara tajna poništava se odmah. Ne postoji razdoblje milosti u kojem obje tajne rade. Sve usluge koje još uvijek koriste staru vrijednost prestat će raditi sekundu nakon poziva. To diktira redoslijed šest koraka u nastavku: pripremi svoje spremište tajni prije pokretanja rotacije, a ne nakon.
- Pripremi svoju infrastrukturu za prihvat novog ključa (varijabla okruženja, spremište tajni)
- Izvrši rotaciju putem API-ja
- Ažuriraj tajnu u svom spremištu odmah
- Ponovno implementiraj (redeploy) svoje usluge s novim ključem
- Provjeri uspijevaju li zahtjevi s novim ključem
- Provjeri propagaciju putem
GET /auth/api-keys/{apiKeyId}/propagation
Kada rotirati
Tri situacije pokreću rotaciju, svaka s različitim stupnjem hitnosti. Sumnja na curenje zahtijeva trenutnu rotaciju: član tima s pristupom ključu odlazi, zapisnik (log) koji sadrži ključ javno je izložen ili Git spremište sadrži ključ u čistom tekstu. U tim slučajevima svaki sat čekanja sat je izloženosti, zato rotiraj prije završetka analize incidenta. Rotacija temeljena na politici preventivna je: svakih 30, 60 ili 90 dana, ovisno o tvojim sigurnosnim zahtjevima, ona ograničava vijek trajanja ključa koji je možda curio, a da nisi ni primijetio. Konačno, promjene u okruženju—migracija infrastrukture ili promjena pružatelja usluga—prirodna su prilika za početak ispočetka s čistim ključevima, umjesto nošenja starih u kontekst za koji nisu ni dizajnirani.
Obriši ključ
Brisanje je trajno i nepovratno. Pitanje koje si trebaš postaviti prije brisanja nije „Je li ovaj ključ kompromitiran?“, već „Trebam li još uvijek ovaj opseg pristupa?“. Ako je odgovor potvrdan, trebaš rotaciju: ona neutralizira otkrivenu tajnu uz očuvanje konfiguracije. Brisanje je opravdano samo za ključ koji više nije koristan—zaustavljeni projekt, dobavljač koji je otišao ili decomisionirano okruženje.
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"
Posljedice brisanja
- Ključ i svi njegovi parametri trajno se brišu
- Svi zahtjevi koji koriste ovaj ključ odmah će propasti
- Radnja je nepovratna—morat ćeš stvoriti novi ključ s novim parametrima
- Povijest korištenja ključa ostaje dostupna u analitici
Rotacija naspram brisanja
| Aspekt | Rotacija | Brisanje |
|---|---|---|
| Ključ još postoji | Da | Ne |
| Generira se nova tajna | Da | Ne |
| ACL liste očuvane | Da | Ne |
| Ograničenja očuvana | Da | Ne |
| Povratno | Ne (stara tajna izgubljena) | Ne (ključ obrisan) |
| Tipična uporaba | Redovita obnova | Zastarjeli ključ ili potvrđena kompromitacija |
Automatiziraj rotaciju
Automatizirana rotacija ima smisla samo ako je zapisivanje u spremište tajni dio iste skripte, bez ikakve ručne intervencije između. Inače samo pomičeš rizik: tajna generirana strojem koju netko ručno kopira vjerojatnije će završiti u međuspremniku ili povijesti terminala nego ključ stvoren 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")
# Pohrani u svoje spremište tajni (primjer s .env datotekom)
# U produkciji koristi Vault, AWS Secrets Manager itd.
print(f"Novi ključ generiran. Ažuriraj svoje spremište tajni.")
Zakazana rotacija
Integriraj rotaciju u svoj CI/CD pipeline ili cron zadatak:
# Primjer Crona: rotacija 1. u mjesecu u 3 sata ujutro
0 3 1 * * /opt/scripts/rotate-xai-keys.sh
Ključne točke
POST /auth/api-keys/{apiKeyId}/rotateponištava staru tajnu i generira novu- Poništenje stare tajne je trenutno i trajno
DELETE /auth/api-keys/{apiKeyId}nepovratno briše ključ- Daj prednost rotaciji naspram brisanju kako bi zadržao postojeće ACL liste i ograničenja
- Automatiziraj rotaciju skriptom i spremištem tajni
- Uvijek provjeri propagaciju nakon rotacije