Bailíochtú an Eochair Bhainistíochta
Ar an leathanach seo
Fíoraigh sláine do chuid eochracha
Is é bailíochtú an eochair bhainistíochta an chéad líne cosanta ag do bhonneagar API. Sula ndéanfaidh tú aon oibríocht chriticiúil—imlonnú, rothlú, athruithe billeála—fíoraigh go bhfuil d’eochair bailí agus go bhfuil na ceadanna cearta aige.
Críochphointe bailíochtaithe
GET /auth/management-keys/validation
curl "https://management-api.x.ai/auth/management-keys/validation" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Deimhníonn an freagra go bhfuil an eochair gníomhach agus filleann sé an fhoireann, na ceadanna, agus na dátaí gaolmhara. Ná déan dearmad faoin dáta éaga: is é seo an t-aon fhaisnéis a ligeann duit briseadh seirbhíse a réamh-mheas seachas fulaingt leis, toisc nach dtabharfaidh eochair éagtha rabhadh duit—ní dhéanfaidh sé ach 401 a thabhairt ar ais ar an gcéad ghla a thagann ina dhiaidh.
Cásanna earráide
- 401 Neamhúdaraithe: Tá an eochair neamhbhailí, éagtha, nó scriosta
- 403 Toirmiscthe: Tá an eochair bailí ach easnaíonn na ceadanna riachtanacha don oibríocht iarrtha
Comhtháthú i do chuid scripteanna
Fíorú ag am tosaithe
Bogann fíorú ag am tosaithe an teip go dtí an pointe is lú costas. Gan an seiceáil seo, léiríonn eochair neamhbhailí é féin ar an gcéad ghla úsáideach—sin le rá, i lár próiseála, uaireanta tar éis roinnt céimeanna a bheith curtha i gcrích cheana féin. Leis an seiceáil, stopann an script i dtrí shoicind le teachtaireacht a ainmníonn an chúis.
import requests
import sys
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
def validate_management_key():
"""Seiceálann sé go bhfuil an eochair bhainistíochta bailí."""
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("Tá an eochair bhainistíochta bailí")
return True
elif response.status_code == 401:
print("EARRÁID: Tá an eochair bhainistíochta neamhbhailí nó éagtha")
return False
else:
print(f"EARRÁID: Stádas gan choinne {response.status_code}")
return False
except requests.exceptions.RequestException as e:
print(f"EARRÁID CEANGAIL: {e}")
return False
if not validate_management_key():
sys.exit(1)
Seiceáil sláinte tréimhsiúil
Clúdaíonn an tseiceáil sláinte tréimhsiúil na rudaí a fhágann fíorú tosaithe ar lár: seirbhísí fadraoin, a tosaíodh seachtainí ó shin, ar féidir lena n-eochair éagú nó a bheith cúlghairthe ar an mbealach. Tá seiceáil uair an chloig go leor—tá an críochphointe éadrom agus ní itheann sé aon chomharthaí infhálaithe.
#!/bin/bash
# healthcheck-xai.sh — rith gach uair an chloig trí 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 "ALÁRAM: Eochair bhainistíochta xAI neamhbhailí (HTTP $STATUS)"
# Seol aláram (PagerDuty, Slack, ríomhphost)
fi
Iniúchadh ar eochracha infhálaithe
Freagraíonn iniúchadh tréimhsiúil trí cheist nach iarrfaidh aon aláram ar do shon: cé na heochracha a bhfuil cárta fiáin acu fós, cé acu nach bhfuil teorainneacha ráta acu, agus cé acu nár úsáideadh le míonna iad. Is rioscaí iad an dá cheann chun tosaigh, is deis glantacháin an ceann deireanach—agus déileáiltear leis na trí cinn in aon pas amháin.
import requests
from datetime import datetime
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
def audit_api_keys():
"""Déanann sé iniúchadh ar gach eochair API don fhoireann."""
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"=== Iniúchadh Eochracha API — {datetime.now().strftime('%d/%m/%Y %H:%M')} ===")
print(f"Líon iomlán na n-eochracha: {len(keys)}")
for key in keys:
name = key.get("name", "Gan ainm")
acls = key.get("acls", [])
expire = key.get("expireTime", "Riamh")
created = key.get("createdAt", "N/A")
# Aláraim
warnings = []
# Eochair le rochtain chárta fiáin
if "api-key:endpoint:*" in acls and "api-key:model:*" in acls:
warnings.append("ROCHTAIN IOMLÁN (cártaí fiáine)")
# Eochair gan dáta éaga
if expire == "Riamh" or not expire:
warnings.append("GAN DÁTA ÉAGA")
# Eochair gan teorainneacha ráta
if not key.get("qps") and not key.get("qpm"):
warnings.append("GAN TEORAINNEACHA RÁTA")
status = " | ".join(warnings) if warnings else "OK"
print(f" [{name}] ACLanna: {len(acls)} | Éagann: {expire} | {status}")
audit_api_keys()
Seicliosta slándála eochracha
Eochracha bainistíochta
Rialaíonn eochracha bainistíochta gach rud eile—tugann a gcur i mbaol rochtain chun gach eochair infhálaithe a chruthú, a mhodhnú, agus a scriosadh. Dá bhrí sin, éilíonn siad an láimhseáil is doichte: stóráil eisiach i stórfa, riamh i ngnáth-théacs i gcód nó i gcumraíocht leaganaithe; rochtain teoranta do riarthóirí bonneagair amháin, ní d’fhorbróirí feidhmchlár; agus bailíochtú rialta trí GET /auth/management-keys/validation, idealach mar sheiceáil sláinte uathoibrithe—is é eochair bhainistíochta éagtha a fháil amach nuair atá géarghá leis an scéim oibríochta is measa.
Eochracha infhálaithe (eochracha API)
Maidir le heochracha infhálaithe, is é an prionsabal treorach ná leithlisiú: faigheann gach feidhmchlár a eochair féin, riamh eochair a roinntear idir seirbhísí—mura sin, briseann rothlú eochrach curtha i mbaol gach seirbhís ag an am céanna, agus ní ligeann anailísíocht a thuilleadh tomhaltas a shannadh. Iompraíonn gach eochair ACLanna sriantacha atá calabraithe dá úsáid iarbhír (gan cártaí fiáine sa táirgeadh), teorainneacha ráta atá méadaithe don trácht a bhfuiltear ag súil leis, agus dáta éaga nuair atá an úsáid sealadach—ní gá eochair shíoraí do POC atá ceaptha maireachtáil dhá sheachtain. Dúnann iniúchadh rialta tríd an script thuas an lúb: nochtann sé eochracha dearmadta, ró-cheadaithe, nó atá ar tí éag sula n-éiríonn siad ina bhfadhbanna.
Prionsabal scartha dualgas
Coinnigh deighilt shoiléir idir eochracha:
| Cineál | Úsáid | Cé a bhfuil rochtain aige |
|---|---|---|
| Eochair bhainistíochta | Riarachán, billeáil, anailísíocht | Riarthóirí bonneagair |
| Eochair Táirgeachta | Glaonna API sa táirgeadh | Feidhmchlár táirgeachta |
| Eochair Staging | Tástáil réamh-tháirgeachta | Foireann forbartha |
| Eochair Forbartha | Forbairt áitiúil | Forbróir aonair |
Tá raon feidhme sainithe ag gach eochair. Má fhágann forbróir an fhoireann, ní scriostar ach a n-eochair forbartha—fanann na cinn eile slán.
Príomhphointí
- Seiceálann
GET /auth/management-keys/validationbailíocht do eochair bhainistíochta - Comhtháthaigh bailíochtú i dtosú do scripte agus i do mhonatóireacht
- Déan iniúchadh rialta ar gach eochair chun rochtain ró-leathan a bhrath
- Deighil eochracha de réir timpeallachta agus freagrachta
- Seol aláram láithreach ar eochair neamhbhailí (éagtha nó scriosta)