Validavimo valdymo raktas
Šiame puslapyje
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ą:
| Tipas | Naudojimas | Kas turi prieigą |
|---|---|---|
| Valdymo raktas | Administravimas, sąskaitos, analitika | Infrastruktūros administratoriai |
| Gamybos raktas | API kvietimai gamyboje | Gamybos programa |
| Testavimo raktas | Ikigamybinis testavimas | Kūrėjų komanda |
| Kūrėjo raktas | Vietinis kūrimas | Individualus 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/validationpatikrina 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ą)