Validacija upravljačkog ključa
Na ovoj stranici
Provjera integriteta tvojih ključeva
Validacija upravljačkog ključa prva je linija obrane tvoje API infrastrukture. Prije bilo koje kritične operacije—implementacije, rotacije, promjena naplate—provjeri je li tvoj ključ valjan i ima li ispravne dozvole.
Krajnja točka za validaciju
GET /auth/management-keys/validation
curl "https://management-api.x.ai/auth/management-keys/validation" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odgovor potvrđuje da je ključ aktivan i vraća podatke o timu, dozvolama i povezanim datumima. Nemoj previdjeti datum isteka: to je jedina informacija koja ti omogućuje da predvidiš prekida rada umjesto da ga pretrpiš, jer istekli ključ ne šalje upozorenje—jednostavno vraća 401 na prvi poziv koji uslijedi.
Slučajevi pogrešaka
- 401 Unauthorized: Ključ je nevažeći, istekao je ili je izbrisan
- 403 Forbidden: Ključ je valjan, ali nema potrebne dozvole za zatraženu operaciju
Integracija u tvoje skripte
Provjera pri pokretanju
Validacija pri pokretanju premješta kvar na mjesto gdje najmanje košta. Bez ove provjere, nevažeći ključ manifestira se tek pri prvom korisnom pozivu—dakle, usred obrade, ponekad nakon što je već izvršeno nekoliko koraka. S njom, skripta se zaustavlja u tri sekunde s porukom koja imenuje uzrok.
import requests
import sys
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
def validate_management_key():
"""Provjerava je li upravljački ključ valjan."""
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("Upravljački ključ je valjan")
return True
elif response.status_code == 401:
print("GREŠKA: Upravljački ključ je nevažeći ili je istekao")
return False
else:
print(f"GREŠKA: Neočekivani status {response.status_code}")
return False
except requests.exceptions.RequestException as e:
print(f"GREŠKA VEZE: {e}")
return False
if not validate_management_key():
sys.exit(1)
Periodična provjera zdravstvenog stanja
Periodična provjera zdravstvenog stanja pokriva ono što validacija pri pokretanju propušta: usluge dugog trajanja, pokrenute prije tjedana, čiji ključ može isteci ili biti opozvan usput. Satna provjera je dovoljna—krajnja točka je lagana i ne troši tokene za zaključivanje.
#!/bin/bash
# healthcheck-xai.sh — pokreći svaki sat putem crona
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 "UPOZORENJE: xAI upravljački ključ je nevažeći (HTTP $STATUS)"
# Pošalji upozorenje (PagerDuty, Slack, e-pošta)
fi
Revizija ključeva za zaključivanje
Periodična revizija odgovara na tri pitanja koja nijedno upozorenje neće postaviti umjesto tebe: koji ključevi još uvijek imaju zamjenski znak (wildcard), koji nemaju ograničenja stope i koji nisu korišteni mjesecima. Prva dva su rizici, treće prilika za čišćenje—i sva tri se rješavaju u jednom prolazu.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
def audit_api_keys():
"""Revizija svih API ključeva za tim."""
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"=== Revizija API ključeva — {datetime.now().strftime('%d/%m/%Y %H:%M')} ===")
print(f"Ukupan broj ključeva: {len(keys)}")
for key in keys:
name = key.get("name", "Neimenovano")
acls = key.get("acls", [])
expire = key.get("expireTime", "Nikada")
created = key.get("createdAt", "N/A")
# Upozorenja
warnings = []
# Ključ s pristupom zamjenskim znakom
if "api-key:endpoint:*" in acls and "api-key:model:*" in acls:
warnings.append("POTPUNI PRISTUP (zamjenski znakovi)")
# Ključ bez isteka
if expire == "Nikada" or not expire:
warnings.append("NEMA ISTeka")
# Ključ bez ograničenja stope
if not key.get("qps") and not key.get("qpm"):
warnings.append("NEMA OGRANIČENJA STOPE")
status = " | ".join(warnings) if warnings else "OK"
print(f" [{name}] ACL-ovi: {len(acls)} | Istek: {expire} | {status}")
audit_api_keys()
Kontrolni popis sigurnosti ključeva
Upravljački ključevi
Upravljački ključevi kontroliraju sve ostalo—njihova kompromitacija daje pristup za stvaranje, modificiranje i brisanje svih ključeva za zaključivanje. Stoga zahtijevaju najstrože postupanje: isključivo pohranjivanje u sefu (vault), nikada u čistom tekstu u kodu ili verzioniranoj konfiguraciji; pristup ograničen samo na administratore infrastrukture, a ne na developere aplikacija; i redovita validacija putem GET /auth/management-keys/validation, idealno automatizirana kao provjera zdravstvenog stanja—otkrivanje isteklog upravljačkog ključa kada ti hitno treba najgori je operativni scenarij.
Ključevi za zaključivanje (API ključevi)
Za ključeve za zaključivanje, vodeće načelo je izolacija: svaka aplikacija dobiva vlastiti ključ, nikada ključ koji se dijeli između usluga—inače rotacija kompromitiranog ključa ruši sve usluge odjednom, a analitika više ne omogućuje pripisivanje potrošnje. Svaki ključ nosi restriktivne ACL-ove kalibrirane prema stvarnoj upotrebi (bez zamjenskih znakova u produkciji), ograničenja stope prilagođena očekivanom prometu i datum isteka kada je upotreba privremena—POC namijenjen trajanju od dva tjedna ne treba vječni ključ. Redovita revizija putem gornje skripte zatvara krug: otkriva zaboravljene, preovlaštene ili ključeve kojima ističe rok prije nego postanu problemi.
Načelo razdvajanja dužnosti
Održavaj jasno razdvajanje između ključeva:
| Vrsta | Upotreba | Tko ima pristup |
|---|---|---|
| Upravljački ključ | Administracija, naplata, analitika | Administratori infrastrukture |
| Produkcijski ključ | API pozivi u produkciji | Produkcijska aplikacija |
| Staging ključ | Testiranje pred-produkcije | Razvojni tim |
| Dev ključ | Lokalni razvoj | Pojedinačni developer |
Svaki ključ ima definirani opseg. Ako developer napusti tim, briše se samo njegov dev ključ—ostali ostaju netaknuti.
Ključne točke
GET /auth/management-keys/validationprovjerava valjanost tvog upravljačkog ključa- Integriraj validaciju u pokretanje svoje skripte i nadzor
- Redovito revidiraj sve ključeve kako bi otkrio preširok pristup
- Razdvajaj ključeve prema okruženju i odgovornosti
- Odmah upozori na nevažeći ključ (istekao ili izbrisan)