Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Validavimo valdymo raktas

Paskaita 13 iš 14 Atnaujinta 2026 m. liepos 29 d. Kūrėjas
Šiame puslapyje
  1. Patikrink savo raktų vientisumą
  2. Validavimo galinis taškas
  3. Integravimas į tavo skriptus
  4. Išvedimo raktų auditas
  5. Raktų saugumo kontrolinis sąrašas
  6. Pareigų atskyrimo principas
  7. Svarbiausi punktai

Patikrink savo raktų vientisumą

Valdymo rakto validavimas yra pirmoji tavo API infrastruktūros gynybos linija. Prieš atliekant bet kokią kritinę operaciją – diegimą, rotaciją, sąskaitų pakeitimus – įsitikink, kad tavo raktas galioja ir jo leidimai yra teisingi.

Validavimo galinis taškas

GET /auth/management-keys/validation
curl "https://management-api.x.ai/auth/management-keys/validation" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Atsakymas patvirtina, kad raktas yra aktyvus, ir grąžina komandą, leidimus bei susijusias datas. Neignoruok galiojimo pabaigos datos: tai vienintelė informacija, leidžianti numatyti sutrikimą, o ne patirti jį, nes pasibaigusio rakto sistema neįspėja – jis tiesiog grąžina 401 klaidą pirmojo bandymo metu.

Klaidų atvejai

  • 401 Unauthorized: Raktas negalioja, yra pasibaigęs arba ištrintas
  • 403 Forbidden: Raktas galioja, tačiau neturi būtinų leidimų prašomai operacijai atlikti

Integravimas į tavo skriptus

Patikra paleidimo metu

Validavimas paleidimo metu perkelia gedimą ten, kur jis kainuoja mažiausiai. Be šio patikrinimo negaliojantis raktas pasireiškia pirmojo naudingo kvietimo metu – tai yra, vykdymo proceso viduryje, kartais jau atlikus kelis žingsnius. Su juo skriptas sustoja per tris sekundes su pranešimu, nurodančiu priežastį.

import requests
import sys

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."

def validate_management_key():
    """Patikrina, ar valdymo raktas galioja."""
    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("Valdymo raktas galioja")
            return True
        elif response.status_code == 401:
            print("KLAIDA: Valdymo raktas negalioja arba pasibaigė")
            return False
        else:
            print(f"KLAIDA: Netikėtas būsenos kodas {response.status_code}")
            return False
    except requests.exceptions.RequestException as e:
        print(f"RYŠIO KLAIDA: {e}")
        return False

if not validate_management_key():
    sys.exit(1)

Periodinė būsenos patikra

Periodinė būsenos patikra apima tai, ko nepastebi paleidimo validavimas: ilgai veikiančios tarnybos, paleistos prieš savaites, kurių raktas gali pasibaigti arba būti atšauktas vėliau. Valandinis patikrinimas yra pakankamas – galinis taškas yra lengvas ir nesunaudoja jokių išvedimo tokenų.

#!/bin/bash
# healthcheck-xai.sh — vykdyti kas valandą per cron

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 "ĮSPĖJIMAS: xAI valdymo raktas negalioja (HTTP $STATUS)"
    # Siųsti įspėjimą (PagerDuty, Slack, el. paštas)
fi

Išvedimo raktų auditas

Periodinis auditas atsako į tris klausimus, kurių joks įspėjimas tau neužduos: kurie raktai vis dar turi pakaitinį simbolį (wildcard), kurie neturi greičio ribų ir kurie nebuvo naudojami mėnesius. Pirmieji du yra rizikos veiksniai, trečiasis – proga išsivalyti, ir visi trys sprendžiami vienu ypu.

import requests
from datetime import datetime

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."

def audit_api_keys():
    """Atlieka visų komandos API raktų auditą."""
    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 raktų auditas — {datetime.now().strftime('%d/%m/%Y %H:%M')} ===")
    print(f"Iš viso raktų: {len(keys)}")

    for key in keys:
        name = key.get("name", "Be pavadinimo")
        acls = key.get("acls", [])
        expire = key.get("expireTime", "Niekada")
        created = key.get("createdAt", "N/A")

        # Įspėjimai
        warnings = []

        # Raktas su prieiga per pakaitinius simbolius
        if "api-key:endpoint:*" in acls and "api-key:model:*" in acls:
            warnings.append("VISIŠKA PRIEIGA (pakaitiniai simboliai)")

        # Raktas be galiojimo pabaigos
        if expire == "Niekada" or not expire:
            warnings.append("NĖRA GALIOJIMO PABAIGOS")

        # Raktas be greičio ribų
        if not key.get("qps") and not key.get("qpm"):
            warnings.append("NĖRA GREIČIO RIBŲ")

        status = " | ".join(warnings) if warnings else "GERAI"
        print(f"  [{name}] ACL: {len(acls)} | Galioja iki: {expire} | {status}")

audit_api_keys()

Raktų saugumo kontrolinis sąrašas

Valdymo raktai

Valdymo raktai valdo viską kitą – jų kompromitacija suteikia prieigą kurti, modifikuoti ir trinti visus išvedimo raktus. Todėl jiems taikomas griežčiausias tvarkymas: saugojimas tik saugykloje (vault), niekada kaip grynas tekstas kode ar versijuojamoje konfigūracijoje; prieiga suteikiama tik infrastruktūros administratoriams, o ne programų kūrėjams; ir reguliarus validavimas naudojant GET /auth/management-keys/validation, idealu – automatizuotas kaip būsenos patikra. Valdymo rakto galiojimo pabaiga, aptikta tik tada, kai jo skubiai reikia, yra blogiausias operacinis scenarijus.

Išvedimo raktai (API raktai)

Išvedimo raktams galioja izoliacijos principas: kiekviena programa gauna savo raktą, niekada nenaudokite rakto, bendro tarp tarnybų – kitaip kompromituoto rakto rotacija sustabdytų visas tarnybas vienu metu, o analitika nebeleis priskirti sunaudojimo. Kiekvienas raktas turi ribojančius ACL, suderintus su faktiniu naudojimu (jokių pakaitinių simbolių gamyboje), greičio ribas, pritaikytas numatomam srautui, ir galiojimo pabaigos datą, jei naudojimas laikinas – POC, skirtas dviem savaitėms, nereikalauja amžino rakto. Reguliarus auditas naudojant aukščiau pateiktą skriptą užbaigia ciklą: jis atskleidžia pamirštus, per daug privilegijuotus arba baigiančius galioti raktus, kol jie netapo problemomis.

Pareigų atskyrimo principas

Išlaikyk aiškų raktų atskyrimą:

TipasNaudojimasKas turi prieigą
Valdymo raktasAdministravimas, sąskaitos, analitikaInfrastruktūros administratoriai
Gamybos raktasAPI kvietimai gamybojeGamybos programa
Testavimo raktasIkigamybinis testavimasKūrėjų komanda
Kūrėjo raktasVietinis kūrimasIndividualus kūrėjas

Kiekvienas raktas turi apibrėžtą taikymo sritį. Jei kūrėjas palieka komandą, ištrinamas tik jo kūrėjo raktas – kiti lieka nepaliesti.

Svarbiausi punktai

  • GET /auth/management-keys/validation patikrina tavo valdymo rakto galiojimą
  • Integruok validavimą į savo skriptų paleidimą ir stebėseną
  • Reguliariai atlik visų raktų auditą, kad aptiktum per plačią prieigą
  • Atskirk raktus pagal aplinką ir atsakomybę
  • Nedelsiant siųsk įspėjimą apie negaliojantį raktą (pasibaigusį arba ištrintą)