Validazzjoni taċ-Ċavetta tal-Ġestjoni
F'din il-paġna
Ivvverifika l-integrità taċ-ċavetti tiegħek
Il-validazzjoni taċ-ċavetta tal-ġestjoni hija l-ewwel linja ta’ difiża tal-infrastruttura tal-API tiegħek. Qabel kwalunkwe operazzjoni kritika—bħal dispjegament, rotazzjoni, jew bidliet fil-fatturazzjoni—ivverifika li ċ-ċavetta tiegħek hija valida u li l-permessi tagħha huma korretti.
Endpoint tal-validazzjoni
GET /auth/management-keys/validation
curl "https://management-api.x.ai/auth/management-keys/validation" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Ir-risposta tikkonferma li ċ-ċavetta hija attiva u tirritorna t-tim, il-permessi, u d-dati assoċjati. Tinjorax id-data ta’ skadenza: din hija l-unika informazzjoni li tippermettilek tanticipa interruzzjoni minflok ma tbati minnha, peress li ċavetta skaduta ma twissikx—hija sempliċiment tirritorna 401 fl-ewwel sejħa li ssegwi.
Każijiet ta’ żball
- 401 Unauthorized: Iċ-ċavetta mhix valida, skadiet, jew tħassret
- 403 Forbidden: Iċ-ċavetta hija valida iżda ma għandiex il-permessi meħtieġa għall-operazzjoni mitluba
Integrazzjoni fl-iskritts tiegħek
Verifika fil-bidu (Startup)
Il-validazzjoni fil-bidu tċaqlaq il-falliment fejn jiswef l-inqas. Mingħajr din iċ-ċekka, ċavetta mhux valida timmanifesta ruħha fl-ewwel sejħa utli—jiġifieri, f’nofs l-ipproċessar, xi drabi wara li jkunu eżegwew diversi passi. B’din iċ-ċekka, l-iskritt jieqaf fi tliet sekondi b’messaġġ li jsemmi l-kawża.
import requests
import sys
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
def validate_management_key():
"""Iċċekkja li ċ-ċavetta tal-ġestjoni hija valida."""
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("Management key valid")
return True
elif response.status_code == 401:
print("ERROR: Management key invalid or expired")
return False
else:
print(f"ERROR: Unexpected status {response.status_code}")
return False
except requests.exceptions.RequestException as e:
print(f"CONNECTION ERROR: {e}")
return False
if not validate_management_key():
sys.exit(1)
Healthcheck perjodiku
Il-healthcheck perjodiku jkopri dak li l-validazzjoni fil-bidu titlef: servizzi li joperaw għal żmien twil, mibdija ġimgħat ilu, li ċ-ċavetta tagħhom tista’ tiskadi jew tiġi rrevokata matul it-triq. Ċekka kull siegħa hija biżżejjed—l-endpoint huwa ħafif u ma jikkonsmax tokens ta’ inferenza.
#!/bin/bash
# healthcheck-xai.sh — imħaddem kull siegħa permezz ta' 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 "ALERT: xAI management key invalid (HTTP $STATUS)"
# Ibghat allert (PagerDuty, Slack, email)
fi
Awditjar taċ-ċavetti ta’ inferenza
L-awditjar perjodiku jwieġeb tliet mistoqsijiet li l-ebda allert mhux se jistaqsi għalik: liema ċavetti għadhom iġorru wildcard, liema m’għandhomx limiti ta’ rata, u liema ma ntużawx għal xhur. L-ewwel tnejn huma riskji, it-tielet hija opportunità biex tnaddaf—u t-tlieta huma ġestiti f’daqqa waħda.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
def audit_api_keys():
"""Jawditja l-ċavetti kollha tal-API għat-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"=== API Key Audit — {datetime.now().strftime('%d/%m/%Y %H:%M')} ===")
print(f"Total number of keys: {len(keys)}")
for key in keys:
name = key.get("name", "Unnamed")
acls = key.get("acls", [])
expire = key.get("expireTime", "Never")
created = key.get("createdAt", "N/A")
# Allerti
warnings = []
# Ċavetta b'aċċess wildcard
if "api-key:endpoint:*" in acls and "api-key:model:*" in acls:
warnings.append("TOTAL ACCESS (wildcards)")
# Ċavetta mingħajr skadenza
if expire == "Never" or not expire:
warnings.append("NO EXPIRATION")
# Ċavetta mingħajr limiti ta' rata
if not key.get("qps") and not key.get("qpm"):
warnings.append("NO RATE LIMITS")
status = " | ".join(warnings) if warnings else "OK"
print(f" [{name}] ACLs: {len(acls)} | Expire: {expire} | {status}")
audit_api_keys()
Lista ta’ kontroll tas-sigurtà taċ-ċavetti
Ċavetti tal-ġestjoni
Iċ-ċavetti tal-ġestjoni jikkontrollaw kollox l-ieħor—il-kompromess tagħhom jagħti aċċess biex toħloq, timmodifika, u tħassar iċ-ċavetti kollha ta’ inferenza. Għalhekk jeħtieġu l-aktar trattament strett: ħażna esklużiva f’vault, qatt mhux bħala test ċar fil-kodiċi jew fil-konfigurazzjoni verżjonata; aċċess limitat għall-amministraturi tal-infrastruttura biss, mhux għall-iżviluppaturi tal-applikazzjonijiet; u validazzjoni regolari permezz ta’ GET /auth/management-keys/validation, idealment awtomatizzata bħala healthcheck—ċavetta tal-ġestjoni skaduta skoperta meta tkun teħtieġha b’mod urġenti hija l-agħar xenarju operattiv.
Ċavetti ta’ inferenza (Ċavetti tal-API)
Għaċ-ċavetti ta’ inferenza, il-prinċipju gwida huwa l-iżolament: kull applikazzjoni tirċievi ċ-ċavetta tagħha stess, qatt ċavetta kondiviża bejn is-servizzi—inkella r-rotazzjoni ta’ ċavetta kompromessa tkisser is-servizzi kollha f’daqqa, u l-analitika ma tibqax tippermetti li tattribwixxi l-konsum. Kull ċavetta ġġorr ACLs restrittivi kkalkolati għall-użu attwali tagħha (l-ebda wildcard fil-produzzjoni), limiti ta’ rata ddimensjonati għat-traffiku mistenni, u data ta’ skadenza meta l-użu huwa temporanju—POC maħsub biex idum ġimagħtejn ma għandux bżonn ċavetta eterna. L-awditjar regolari permezz tal-iskritt ta’ hawn fuq jagħlaq iċ-ċirku: jikxef ċavetti minsija, b’privileġġi eċċessivi, jew li qed jiskadu qabel ma jsiru problemi.
Prinċipju tas-separazzjoni tad-doveri
Żomm separazzjoni ċara bejn iċ-ċavetti:
| Tip | Użu | Min għandu aċċess |
|---|---|---|
| Ċavetta tal-ġestjoni | Amministrazzjoni, fatturazzjoni, analitika | Amministraturi tal-infrastruttura |
| Ċavetta tal-Prod | Sejħiet tal-API fil-produzzjoni | Applikazzjoni tal-produzzjoni |
| Ċavetta tal-Istaging | Ittestjar qabel il-produzzjoni | Tim tal-iżvilupp |
| Ċavetta tad-Dev | Żvilupp lokali | Żviluppatur individwali |
Kull ċavetta għandha ambitu definit. Jekk żviluppatur iħalli t-tim, titħassar biss iċ-ċavetta tad-dev tiegħu—l-oħrajn jibqgħu intatti.
Punti Ewlenin
GET /auth/management-keys/validationjiċċekkja l-validità taċ-ċavetta tal-ġestjoni tiegħek- Integra l-validazzjoni fil-bidu tal-iskritt tiegħek u fil-monitoraġġ
- Awditja regolarment iċ-ċavetti kollha biex tiskopri aċċess wiesa’ wisq
- Separa ċ-ċavetti skont l-ambjent u r-responsabbiltà
- Issib allert immedjatament fuq ċavetta mhux valida (skaduta jew imħassra)