Awtentikazzjoni b'token Bearer
F'din il-paġna
Issikura s-sejħiet tal-API tiegħek
Kull talba mibgħuta lill-API xAI trid tiġi awtentikata. L-API tuża l-iskema Bearer token, standard adottat b’mod wiesa’ għall-APIs REST. Din il-lezzjoni tispjega kif jaħdem dan il-mekkaniżmu u l-aħjar prattiki biex tipproteġi ċ-ċwievet tiegħek fil-produzzjoni.
L-iskema Bearer token
Kif jissuġġerixxi l-isem, min ikollu (“ibear”) t-token jista’ jaċċessa l-API. Għalhekk huwa fundamentali li tipproteġi ċ-ċavetta tiegħek: m’hemm l-ebda verifika tal-identità lil hinn mit-token innifsu.
Format tal-header
Kull talba HTTP trid tinkludi l-header Authorization bil-prefiss Bearer segwit miċ-ċavetta tiegħek:
Authorization: Bearer xai-your-api-key
B’cURL, dan jagħti:
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "grok-4.5", "input": "Hello"}'
F’Python, l-SDKs jittrattaw dan l-header awtomatikament meta tgħaddi ċ-ċavetta lill-kostruttur tal-klijent.
Żbalji ta’ awtentikazzjoni
HTTP 401 Unauthorized
Dan l-iżball ifisser li ċ-ċavetta tiegħek nieqsa, mhux valida, jew ġiet irrevokata. Iċċekkja:
- Li l-varjabbli tal-ambjent
XAI_API_KEYhija stabbilita - Li ċ-ċavetta tibda b’
xai- - Li ċ-ċavetta ma ġietx irrevokata fil-console
HTTP 403 Forbidden
Iċ-ċavetta tiegħek hija valida iżda m’għandhiex il-permessi meħtieġa għall-azzjoni mitluba. Dan jista’ jiġri b’restrizzjonijiet tat-tim fuq ċerti operazzjonijiet.
Aħjar prattiki tas-sigurtà
Qatt ma tesponi ċavetta fil-kodiċi
Iċ-ċwievet qatt m’għandhom jidhru b’test ċar f’:
- Kodiċi sors bil-verżjoni (Git)
- Logs tal-applikazzjoni
- URLs jew parametri tal-mistoqsija
- Messaġġi ta’ żball murija lill-utenti
- Kwistjonijiet u talbiet ta’ ġbid (pull requests) ta’ GitHub
Uża vault tas-sigrieti
Fil-produzzjoni, aħżen iċ-ċwievet tiegħek f’sistema ddedikata:
- AWS Secrets Manager jew Parameter Store
- Google Secret Manager
- Azure Key Vault
- HashiCorp Vault
- Sigrieti tal-pjattaforma CI/CD tiegħek (GitHub Actions, GitLab CI)
Rotazzjoni taċ-ċwievet
Ibdel iċ-ċwievet tiegħek regolarment, u immedjatament jekk tissuspetta tnixxija:
- Oħloq ċavetta ġdida fil-console xAI
- Aġġorna ċ-ċavetta fil-vault tas-sigrieti tiegħek
- Erġa’ ddispjega l-applikazzjoni tiegħek
- Iċċekkja li kollox jaħdem biċ-ċavetta l-ġdida
- Irrevoka ċ-ċavetta l-qadima fil-console
Illimita l-permessi
Jekk taħdem f’tim, oħloq ċwievet separati għal kull servizz u ambjent. Jekk waħda tiġi kompromessa, l-impatt jibqa’ limitat għal kuntest wieħed.
Rilevament ta’ tnixxijiet
Il-prefiss xai- jippermetti lill-għodod ta’ rilevament (skanning tas-sigrieti ta’ GitHub, GitGuardian, TruffleHog) li jidentifikaw iċ-ċwievet fil-kodiċi sors awtomatikament. Ixgħel dawn l-għodod fir-repożitorji tiegħek biex tiġi avżat immedjatament fil-każ ta’ esponiment aċċidentali.
Jekk tiġi rilevata ċavetta f’commit pubbliku:
- Irrevokaha immedjatament fil-console xAI
- Iċċekkja l-istorja tal-użu tiegħek għal użu fraudolenti
- Oħloq ċavetta ġdida
- Naddaf l-istorja ta’ Git tiegħek (jew aħjar, ittratta ċ-ċavetta bħala kompromessa u kompli ‘l quddiem)
HTTPS meħtieġ
L-API xAI taċċetta biss konnessjonijiet HTTPS. TLS tikkriptja t-talbiet tiegħek waqt it-trażmissjoni, inkluż l-header Authorization. Qatt ma tipprova ddur ma’ din il-protezzjoni: talba fuq HTTP mhux ikkriptjat tesponi ċ-ċavetta tiegħek fuq in-network.
Punti Ewlenin
- L-API tuża l-iskema Bearer token permezz tal-header
Authorization - Iċ-ċavetta hija l-uniku fattur ta’ awtentikazzjoni: ipproteġiha bħal password
- Uża vault tas-sigrieti fil-produzzjoni, u qatt ma tħalli ċ-ċavetta fil-kodiċi (hard-code)
- Ixgħel ir-rilevament ta’ tnixxijiet fir-repożitorji Git tiegħek
- Dawwar iċ-ċwievet regolarment u irrevoka kwalunkwe ċavetta kompromessa immedjatament
Iċċekkja l-fehim tiegħek
Il-fondamenti tal-API xAI: verifika finali qabel ma tibni.
1. X'għandek tagħmel b'ċavetta tal-API hekk kif toħloqha?
Tweġiba: Aħżinha f’post sikur (tintwera darba biss), esponiha permezz tal-varjabbli XAI_API_KEY minflok ma tħalliha fil-kodiċi, uża ċavetta waħda għal kull ambjent, u ttestjaha minnufih b’sejħa lejn /v1/models.
2. X'inhu l-URL bażi, u għaliex huwa daqshekk importanti?
Tweġiba: https://api.x.ai/v1. Dan huwa dak li jagħmel possibbli l-kompatibbiltà ma’ OpenAI: tibdil fil-base_url u fiċ-ċavetta huwa biżżejjed biex tipponta kodiċi eżistenti ta’ OpenAI lejn Grok.
3. Liema SDKs tista' tuża ma' Grok?
Tweġiba: L-SDK nativ xAI, l-SDK ta’ OpenAI (bil-base_url ta’ xAI), u l-Vercel AI SDK fuq in-naħa ta’ JavaScript, flimkien ma’ cURL għall-ittestjar: l-ekosistema hija miftuħa.
4. X'inhu l-endpoint prinċipali tal-ġenerazzjoni?
Tweġiba: POST /v1/responses, il-format modern; chat/completions jibqa’ disponibbli bħala għażla legacy għall-kompatibbiltà.
5. Kif tiġi awtentikata kull talba?
Tweġiba: Bl-header Authorization: Bearer u ċ-ċavetta xai-…: l-iskema standard Bearer token, l-istess x’inhu l-SDK jew l-għodda.
Ċavetta ssikurata, l-URL bażi, l-għażla tal-SDK tiegħek, Bearer kullimkien: il-fondament huwa fil-post, u l-korsijiet li jmiss tal-API jibnu fuqu.