Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Rotácia a odstraňovanie kľúčov

Lekcia 4 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Rotácia: Obnova bez výpadku
  2. Vykonanie rotácie
  3. Odstránenie kľúča
  4. Automatizácia rotácie
  5. Kľúčové poznatky

Rotácia: Obnova bez výpadku

Rotácia kľúčov je kritickou bezpečnostnou praxou. Generuje nový tajný kľúč, ktorý nahradí starý, pričom samotný kľúč sa neodstráni. Starý tajný kľúč sa okamžite a natrvalo zneplatní.

Vykonanie rotácie

Rotácia rieši problém, ktorý odstránenie vyriešiť nedokáže: obnovu tajného kľúča bez straty identity kľúča. Jeho zoznamy riadenia prístupu (ACL), limity rýchlosti a názov zostanú zachované, takže nemusíš nič prekonfigurovávať – v trezore sa zmení iba tajný kľúč. Vďaka tomu je pravidelná rotácia praktická; opätovné vytvorenie kľúča by si vyžadovalo zakaždým prekonfigurovať všetko.

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"

Správanie pri rotácii

  • Starý tajný kľúč sa okamžite zneplatní – akékoľvek požiadavky s jeho použitím zlyhajú s chybou 401
  • Vygeneruje sa nový tajný kľúč, ktorý sa vráti v odpovedi
  • ID kľúča (apiKeyId), názov, zoznamy ACL a limity rýchlosti zostanú nezmenené
  • Nový tajný kľúč sa zobrazí iba raz – okamžite si ho ulož

Bezpečný proces rotácie

Jedna časť tohto postupu si zasluhuje osobitný dôraz, pretože používateľov často prekvapí: starý tajný kľúč sa zneplatní okamžite. Neexistuje žiadne obdobie milosti, keď by fungovali oba tajné kľúče. Akékoľvek služby, ktoré stále používajú starú hodnotu, zlyhajú hneď po vykonaní volania. To určuje poradie šiestich krokov nižšie: priprav si trezor pred spustením rotácie, nie až po nej.

  1. Priprav svoju infraštruktúru na prijatie nového kľúča (premenná prostredia, trezor)
  2. Vykonaj rotáciu prostredníctvom API
  3. Aktualizuj tajný kľúč vo svojom trezore okamžite
  4. Nasadiť znova svoje služby s novým kľúčom
  5. Over, či požiadavky s novým kľúčom úspešne prechádzajú
  6. Over propagáciu pomocou GET /auth/api-keys/{apiKeyId}/propagation

Kedy rotovať

Rotáciu spúšťajú tri situácie, každá s inou naliehavosťou. Pri podozrení na únik je nutná okamžitá rotácia: keď tím opustí člen s prístupom ku kľúču, keď sa verejne objaví log obsahujúci kľúč, alebo keď Git repozitár obsahuje kľúč v čistom texte. V týchto prípadoch je každá hodina čakania hodinou expozície, preto rotuj ešte pred dokončením analýzy incidentu. Rotácia založená na politike je preventívna: každých 30, 60 alebo 90 dní, v závislosti od tvojich bezpečnostných požiadaviek, obmedzuje životnosť kľúča, ktorý mohol uniknúť bez povšimnutia. Nakoniec, zmeny prostredia – migrácia infraštruktúry alebo zmena poskytovateľa – sú prirodzenou príležitosťou začať odznova s čistými kľúčmi, namiesto toho, aby si staré preniesol do kontextu, na ktorý neboli navrhnuté.

Odstránenie kľúča

Odstránenie je trvalé a nezvratné. Otázka, ktorú si musíš položiť pred odstránením, neznie „Je tento kľúč kompromitovaný?“, ale „Potrebujem stále tento rozsah prístupu?“ Ak je odpoveď áno, potrebuješ rotáciu: tá neutralizuje exponovaný tajný kľúč pri zachovaní konfigurácie. Odstránenie je opodstatnené len pre kľúč, ktorý už nie je užitočný – zastavený projekt, odišlý dodávateľ alebo vyradené prostredie.

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"

Dôsledky odstránenia

  • Kľúč a všetky jeho parametre sa trvalo odstránia
  • Všetky požiadavky používajúce tento kľúč okamžite zlyhajú
  • Akcia je nezvratná – budeš musieť vytvoriť nový kľúč s novými parametrami
  • História používania kľúča zostáva dostupná v analytickej časti

Rotácia verzus odstránenie

AspektRotáciaOdstránenie
Kľúč stále existujeÁnoNie
Vygenerovaný nový tajný kľúčÁnoNie
Zachované zoznamy ACLÁnoNie
Zachované limityÁnoNie
ZvratnéNie (starý tajný kľúč stratený)Nie (kľúč odstránený)
Typické použitiePravidelná obnovaZastaraný kľúč alebo potvrdený kompromis

Automatizácia rotácie

Automatizovaná rotácia má zmysel len vtedy, ak je zápis do trezora súčasťou toho istého skriptu bez manuálneho zásahu medzi tým. Inak len presúvaš riziko: strojovo vygenerovaný tajný kľúč skopírovaný ručne má väčšiu šancu skončiť v schránke alebo histórii terminálu než kľúč vytvorený z konzoly.

import requests
import json

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

# Rotácia
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")

# Uloženie do trezora (príklad so súborom .env)
# V produkčnom prostredí použite Vault, AWS Secrets Manager atď.
print(f"Nový kľúč vygenerovaný. Aktualizujte svoj trezor.")

Plánovaná rotácia

Integruj rotáciu do svojho CI/CD pipeline alebo ako cron úlohu:

# Príklad Cron: rotácia 1. dňa v mesiaci o 3:00 ráno
0 3 1 * * /opt/scripts/rotate-xai-keys.sh

Kľúčové poznatky

  • POST /auth/api-keys/{apiKeyId}/rotate zneplatní starý tajný kľúč a vygeneruje nový
  • Zneplatnenie starého tajného kľúča je okamžité a trvalé
  • DELETE /auth/api-keys/{apiKeyId} nezvratne odstráni kľúč
  • Uprednostni rotáciu pred odstránením, aby si zachoval existujúce zoznamy ACL a limity
  • Automatizuj rotáciu pomocou skriptu a trezora tajných kľúčov
  • Po rotácii vždy over propagáciu