Rotácia a odstraňovanie kľúčov
Na tejto strane
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.
- Priprav svoju infraštruktúru na prijatie nového kľúča (premenná prostredia, trezor)
- Vykonaj rotáciu prostredníctvom API
- Aktualizuj tajný kľúč vo svojom trezore okamžite
- Nasadiť znova svoje služby s novým kľúčom
- Over, či požiadavky s novým kľúčom úspešne prechádzajú
- 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
| Aspekt | Rotácia | Odstránenie |
|---|---|---|
| Kľúč stále existuje | Áno | Nie |
| Vygenerovaný nový tajný kľúč | Áno | Nie |
| Zachované zoznamy ACL | Áno | Nie |
| Zachované limity | Áno | Nie |
| Zvratné | Nie (starý tajný kľúč stratený) | Nie (kľúč odstránený) |
| Typické použitie | Pravidelná obnova | Zastaraný 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}/rotatezneplatní 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