Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Rotacija i brisanje ključeva

Lekcija 4 od 14 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Rotacija: Obnova bez prekida
  2. Izvrši rotaciju
  3. Obriši ključ
  4. Automatiziraj rotaciju
  5. Ključne točke

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.

  1. Pripremi svoju infrastrukturu za prihvat novog ključa (varijabla okruženja, spremište tajni)
  2. Izvrši rotaciju putem API-ja
  3. Ažuriraj tajnu u svom spremištu odmah
  4. Ponovno implementiraj (redeploy) svoje usluge s novim ključem
  5. Provjeri uspijevaju li zahtjevi s novim ključem
  6. 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

AspektRotacijaBrisanje
Ključ još postojiDaNe
Generira se nova tajnaDaNe
ACL liste očuvaneDaNe
Ograničenja očuvanaDaNe
PovratnoNe (stara tajna izgubljena)Ne (ključ obrisan)
Tipična uporabaRedovita obnovaZastarjeli 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}/rotate poniš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