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

A kezelői kulcs érvényesítése

13. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Ellenőrizd a kulcsaid integritását
  2. Érvényesítési végpont
  3. Integrálás a szkriptjeidbe
  4. Következtetési kulcsok auditálása
  5. Kulcsbiztonsági ellenőrzőlista
  6. A feladatok szétválasztásának elve
  7. Főbb megállapítások

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ípusHasználatKinek van hozzáférése
Kezelői kulcsAdminisztráció, számlázás, elemzésInfrastruktúra-adminisztrátorok
Éles kulcsAPI-hívások éles környezetbenÉles alkalmazás
Teszt kulcsÉles előtti tesztelésFejlesztői csapat
Fejlesztői kulcsHelyi fejlesztésEgyedi 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/validation ellenő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