Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Kulcsok forgatása és törlése

4. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Forgatás: Megszakítás nélküli megújítás
  2. Forgatás végrehajtása
  3. Kulcs törlése
  4. A forgatás automatizálása
  5. Főbb megállapítások

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.

  1. Készítsd elő az infrastruktúrádat egy új kulcs fogadására (környezeti változó, tároló)
  2. Hajtsd végre a forgatást az API-n keresztül
  3. Frissítsd a titkot a tárolódban azonnal
  4. Telepítsd újra szolgáltatásaidat az új kulccsal
  5. Ellenőrizd, hogy a kérések sikerrel járnak-e az új kulccsal
  6. Ellenőrizd a terjedést a GET /auth/api-keys/{apiKeyId}/propagation vé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

SzempontForgatásTörlés
A kulcs tovább létezikIgenNem
Új titok generálódikIgenNem
ACL-ek megmaradnakIgenNem
Korlátok megmaradnakIgenNem
VisszafordíthatóNem (a régi titok elveszett)Nem (a kulcs törölve)
Tipikus használatRendszeres megújításElavult 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