Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Bailíochtú an Eochair Bhainistíochta

Ceacht 13 as 14 Nuashonraithe 29 Iúil 2026 Forbróir
Ar an leathanach seo
  1. Fíoraigh sláine do chuid eochracha
  2. Críochphointe bailíochtaithe
  3. Comhtháthú i do chuid scripteanna
  4. Iniúchadh ar eochracha infhálaithe
  5. Seicliosta slándála eochracha
  6. Prionsabal scartha dualgas
  7. Príomhphointí

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áidCé a bhfuil rochtain aige
Eochair bhainistíochtaRiarachán, billeáil, anailísíochtRiarthóirí bonneagair
Eochair TáirgeachtaGlaonna API sa táirgeadhFeidhmchlár táirgeachta
Eochair StagingTástáil réamh-tháirgeachtaFoireann forbartha
Eochair ForbarthaForbairt áitiúilForbró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/validation bailí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)