A kezelői kulcs érvényesítése
Ezen az oldalon
Ellenőrizd a kulcsaid integritását
A kezelői kulcs érvényesítése az API-infrastruktúrád első védelmi vonala. Minden kritikus művelet – telepítés, kulcscsere, számlázási módosítás – előtt győződj meg arról, hogy a kulcsod érvényes, és a jogosultságai megfelelnek a célnak.
Érvényesítési végpont
GET /auth/management-keys/validation
curl "https://management-api.x.ai/auth/management-keys/validation" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
A válasz megerősíti, hogy a kulcs aktív, és visszaadja a csapatra, a jogosultságokra és a kapcsolódó dátumokra vonatkozó adatokat. Ne hagyd figyelmen kívül a lejárati dátumot: ez az egyetlen információ, amely lehetővé teszi, hogy előre jelezd a kiesést ahelyett, hogy elszenvednéd, mivel egy lejárt kulcs nem figyelmeztet – egyszerűen 401-es hibakódot ad vissza az első azt követő híváskor.
Hibaesetek
- 401 Unauthorized: A kulcs érvénytelen, lejárt vagy törölték
- 403 Forbidden: A kulcs érvényes, de hiányoznak a kért művelethez szükséges jogosultságok
Integrálás a szkriptjeidbe
Indítási ellenőrzés
Az indításkori érvényesítés oda helyezi a hibakezelést, ahol az a legkisebb költséggel jár. Ezen ellenőrzés nélkül egy érvénytelen kulcs csak az első hasznos híváskor nyilvánul meg – vagyis a feldolgozás kellős közepén, néha több lépés végrehajtása után. Ezzel szemben a szkript három másodperc alatt leáll, és egy üzenetben megnevezi az okot.
import requests
import sys
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
def validate_management_key():
"""Ellenőrzi, hogy a kezelői kulcs érvényes-e."""
try:
response = requests.get(
f"{MANAGEMENT_API}/auth/management-keys/validation",
headers={"Authorization": f"Bearer {MGMT_KEY}"},
timeout=10
)
if response.status_code == 200:
print("A kezelői kulcs érvényes")
return True
elif response.status_code == 401:
print("HIBA: A kezelői kulcs érvénytelen vagy lejárt")
return False
else:
print(f"HIBA: Váratlan állapot: {response.status_code}")
return False
except requests.exceptions.RequestException as e:
print(f"KAPCSOLÓDÁSI HIBA: {e}")
return False
if not validate_management_key():
sys.exit(1)
Időszakos állapotellenőrzés (Healthcheck)
Az időszakos állapotellenőrzés pótolja azt, amit az indításkori ellenőrzés nem fed le: a hosszú ideig futó szolgáltatásokat, amelyeket hetekkel ezelőtt indítottak, és amelyek kulcsa időközben lejárhat vagy visszavonhatóvá válhat. Egy óránkénti ellenőrzés elegendő – a végpont könnyű, és nem fogyaszt következtetési tokeneket.
#!/bin/bash
# healthcheck-xai.sh — óránként futtatva cron segítségével
STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
"https://management-api.x.ai/auth/management-keys/validation" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY")
if [ "$STATUS" != "200" ]; then
echo "RIASZTÁS: Az xAI kezelői kulcs érvénytelen (HTTP $STATUS)"
# Riasztás küldése (PagerDuty, Slack, e-mail)
fi
Következtetési kulcsok auditálása
Az időszakos auditálás három olyan kérdésre ad választ, amelyet egyetlen riasztás sem tesz fel helyetted: mely kulcsok tartalmaznak még wildcardot, melyeknél nincs sebességkorlátozás, és melyeket nem használták hónapok óta. Az első kettő kockázatot jelent, a harmadik pedig lehetőséget a tisztításra – és mindhármat egyetlen futtatással kezelheted.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
def audit_api_keys():
"""Auditálja a csapat összes API-kulcsát."""
response = requests.get(
f"{MANAGEMENT_API}/auth/teams/{TEAM_ID}/api-keys",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
keys = response.json().get("apiKeys", [])
print(f"=== API-kulcs audit — {datetime.now().strftime('%d/%m/%Y %H:%M')} ===")
print(f"Kulcsok teljes száma: {len(keys)}")
for key in keys:
name = key.get("name", "Névtelen")
acls = key.get("acls", [])
expire = key.get("expireTime", "Soha")
created = key.get("createdAt", "N/A")
# Riasztások
warnings = []
# Kulcs wildcard hozzáféréssel
if "api-key:endpoint:*" in acls and "api-key:model:*" in acls:
warnings.append("TELJES HOZZÁFÉRÉS (wildcardok)")
# Kulcs lejárat nélkül
if expire == "Soha" or not expire:
warnings.append("NINCS LEJÁRAT")
# Kulcs sebességkorlátozás nélkül
if not key.get("qps") and not key.get("qpm"):
warnings.append("NINCS SEBESSÉGKORLÁTOZÁS")
status = " | ".join(warnings) if warnings else "RENDBEN"
print(f" [{name}] ACL-ek: {len(acls)} | Lejárat: {expire} | {status}")
audit_api_keys()
Kulcsbiztonsági ellenőrzőlista
Kezelői kulcsok
A kezelői kulcsok mindent irányítanak – kompromittálódásuk hozzáférést biztosít az összes következtetési kulcs létrehozásához, módosításához és törléséhez. Ezért szigorú bánásmódot igényelnek: kizárólagos tárolás trezorban (vault), soha nem plain text formátumban a kódban vagy verziókezelt konfigurációban; a hozzáférés kizárólag az infrastruktúra-adminisztrátorok számára korlátozott, nem az alkalmazásfejlesztőknek; valamint rendszeres érvényesítés a GET /auth/management-keys/validation végponton keresztül, ideális esetben állapotellenőrzésként automatizálva – egy lejárt kezelői kulcs, amelyet csak sürgős szükség esetén fedezel fel, a legrosszabb operatív forgatókönyv.
Következtetési kulcsok (API-kulcsok)
A következtetési kulcsok esetén az irányelv az elszigeteltség: minden alkalmazás saját kulcsot kap, soha nem szolgáltatások között megosztottat – ellenkező esetben egy kompromittálódott kulcs cseréje egyszerre tör el minden szolgáltatást, és az elemzések sem teszik lehetővé a fogyasztás hozzárendelését. Minden kulcs szigorú, a tényleges használathoz igazított ACL-eket hordoz (nincsenek wildcardok éles környezetben), a várt forgalomhoz méretezett sebességkorlátozásokat, és lejárati dátumot, ha a használat ideiglenes – egy két hétig tartó POC-nak nincs szüksége örök kulcsra. A fenti szkripttel végzett rendszeres auditálás lezárja a kört: feltárja az elfelejtett, túljogosultsággal rendelkező vagy lejáró kulcsokat, mielőtt problémává válnának.
A feladatok szétválasztásának elve
Tartsd fenn a kulcsok közötti világos elválasztást:
| Típus | Használat | Kinek van hozzáférése |
|---|---|---|
| Kezelői kulcs | Adminisztráció, számlázás, elemzés | Infrastruktúra-adminisztrátorok |
| Éles kulcs | API-hívások éles környezetben | Éles alkalmazás |
| Teszt kulcs | Éles előtti tesztelés | Fejlesztői csapat |
| Fejlesztői kulcs | Helyi fejlesztés | Egyedi fejlesztő |
Minden kulcsnak meghatározott hatóköre van. Ha egy fejlesztő elhagyja a csapatot, csak az ő fejlesztői kulcsát törlik – a többi érintetlen marad.
Főbb megállapítások
- A
GET /auth/management-keys/validationellenőrzi a kezelői kulcs érvényességét - Építsd be az érvényesítést a szkriptjeid indításába és a monitoringba
- Rendszeresen auditáld az összes kulcsot a túl széles hozzáférés észlelésére
- Válaszd szét a kulcsokat környezet és felelősség szerint
- Azonnal riaszd a rendszert érvénytelen (lejárt vagy törölt) kulcs esetén