Kulcsok forgatása és törlése
Ezen az oldalon
Forgatás: Megszakítás nélküli megújítás
A kulcsforgatás kritikus biztonsági gyakorlat. Új titkos kulcsot generál a régi helyettesítésére anélkül, hogy magát a kulcsot törölné. A régi titok azonnal és véglegesen érvénytelenné válik.
Forgatás végrehajtása
A forgatás olyan problémát old meg, amelyet a törlés nem: a titok megújítása a kulcs identitásának elvesztése nélkül. A hozzáférés-szabályozási listái (ACL), sebességkorlátai és neve megmaradnak a művelet során, így semmit sem kell újra konfigurálnod – csak a titok változik a tárolódban. Ez teszi gyakorlatiassá a rendszeres forgatást; egy kulcs újbóli létrehozása minden alkalommal mindennek újraconfigurálását igényelné.
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"
A forgatás működése
- A régi titkos kulcs azonnal érvénytelenné válik – minden ezzel végzett kérés 401-es hibával meghiúsul
- Egy új titkos kulcs generálódik, és megjelenik a válaszban
- A kulcsazonosító (
apiKeyId), név, ACL-ek és sebességkorlátok változatlanok maradnak - Az új titkos kulcs csak egyszer jelenik meg – azonnal mentsd el
Biztonságos forgatási folyamat
Ennek az eljárásnak egyik része különös figyelmet érdemel, mert gyakran meglepi a felhasználókat: a régi titok azonnal érvénytelenné válik. Nincs türelmi idő, amikor mindkét titok működne. Minden olyan szolgáltatás, amely még a régi értéket használja, a hívás utáni másodpercben meghibásodik. Ez határozza meg az alábbi hat lépés sorrendjét: készítsd elő a tárolódat mielőtt elindítanád a forgatást, ne utána.
- Készítsd elő az infrastruktúrádat egy új kulcs fogadására (környezeti változó, tároló)
- Hajtsd végre a forgatást az API-n keresztül
- Frissítsd a titkot a tárolódban azonnal
- Telepítsd újra szolgáltatásaidat az új kulccsal
- Ellenőrizd, hogy a kérések sikerrel járnak-e az új kulccsal
- Ellenőrizd a terjedést a
GET /auth/api-keys/{apiKeyId}/propagationvégponttal
Mikor kell forgatni?
Három helyzet indokolja a forgatást, mindegyik eltérő sürgősséggel. Gyanított szivárgás azonnali forgatást igényel: ha egy kulcshoz férő csapattag távozik, egy kulcsot tartalmazó napló nyilvánosságra kerül, vagy egy Git-tároló tartalmaz egy olvasható kulcsot. Ilyen esetekben minden várakozással töltött óra egyben kitettségi óra is, ezért forgass, mielőtt befejeznéd az incidens elemzését. A házirend-alapú forgatás megelőző jellegű: biztonsági követelményeidtől függően minden 30, 60 vagy 90 napban korlátozza annak a kulcsnak az élettartamát, amely észrevétlenül szivároghatott ki. Végül a környezeti változások – infrastruktúra-migráció vagy szolgáltatóváltás – természetes lehetőséget kínálnak arra, hogy tiszta kulcsokkal kezdj újat, ahelyett, hogy régiakat vinnél át olyan kontextusba, amelyre sosem tervezték őket.
Kulcs törlése
A törlés végleges és visszavonhatatlan. A törlés előtt nem azt a kérdést kell feltenned, hogy „Kompromittálódott ez a kulcs?“, hanem azt, hogy „Szükségem van még erre a hozzáférési körre?“ Ha a válasz igen, akkor forgatásra van szükséged: ez semlegesíti a kiszivárgott titkot, miközben megőrzi a konfigurációt. A törlés csak akkor indokolt, ha a kulcs már nem hasznos – egy leállított projekt, egy távozott beszállító vagy egy leállított környezet esetén.
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"
A törlés következményei
- A kulcs és minden paramétere véglegesen törlődik
- Minden ezzel a kulccsal végzett kérés azonnal meghiúsul
- A művelet visszafordíthatatlan – új kulcsot kell létrehoznod új paraméterekkel
- A kulcs használati előzményei továbbra is elérhetők maradnak az elemzésekben
Forgatás kontra törlés
| Szempont | Forgatás | Törlés |
|---|---|---|
| A kulcs tovább létezik | Igen | Nem |
| Új titok generálódik | Igen | Nem |
| ACL-ek megmaradnak | Igen | Nem |
| Korlátok megmaradnak | Igen | Nem |
| Visszafordítható | Nem (a régi titok elveszett) | Nem (a kulcs törölve) |
| Tipikus használat | Rendszeres megújítás | Elavult kulcs vagy igazolt kompromittálódás |
A forgatás automatizálása
Az automatizált forgatás csak akkor van értelme, ha a tárolóba írás ugyanannak a szkriptnek a része, kézi beavatkozás nélkül közöttük. Ellenkező esetben csak eltolod a kockázatot: egy gép által generált titok, amelyet kézzel másolsz, nagyobb valószínűséggel kerül a vágólapra vagy a terminál előzményeibe, mint egy konzolból létrehozott kulcs.
import requests
import json
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
KEY_ID = "key-123"
# Forgatás
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")
# Tárolás a tárolódban (példa .env fájllal)
# Éles környezetben használd a Vaultot, AWS Secrets Managert stb.
print(f"Új kulcs generálva. Frissítsd a tárolódat.")
Ütemezett forgatás
Integráld a forgatást a CI/CD folyamatodba vagy egy cron feladatba:
# Cron példa: forgatás minden hónap 1-jén hajnali 3-kor
0 3 1 * * /opt/scripts/rotate-xai-keys.sh
Főbb megállapítások
- A
POST /auth/api-keys/{apiKeyId}/rotateérvényteleníti a régi titkot és generál egy újat - A régi titok érvénytelenítése azonnali és végleges
- A
DELETE /auth/api-keys/{apiKeyId}visszafordíthatatlanul törli a kulcsot - Részesítsd előnyben a forgatást a törléssel szemben a meglévő ACL-ek és korlátok megőrzése érdekében
- Automatizáld a forgatást egy szkripttel és egy titoktárolóval
- Forgatás után mindig ellenőrizd a terjedést