Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Awtentikazzjoni b'token Bearer

Lezzjoni 14 / 14 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Issikura s-sejħiet tal-API tiegħek
  2. L-iskema Bearer token
  3. Żbalji ta’ awtentikazzjoni
  4. Aħjar prattiki tas-sigurtà
  5. Rilevament ta’ tnixxijiet
  6. HTTPS meħtieġ
  7. Punti Ewlenin
  8. Iċċekkja l-fehim tiegħek

Issikura s-sejħiet tal-API tiegħek

Gwida tal-Bidu fid-dokumentazzjoni xAI 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_KEY hija 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:

  1. Oħloq ċavetta ġdida fil-console xAI
  2. Aġġorna ċ-ċavetta fil-vault tas-sigrieti tiegħek
  3. Erġa’ ddispjega l-applikazzjoni tiegħek
  4. Iċċekkja li kollox jaħdem biċ-ċavetta l-ġdida
  5. 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:

  1. Irrevokaha immedjatament fil-console xAI
  2. Iċċekkja l-istorja tal-użu tiegħek għal użu fraudolenti
  3. Oħloq ċavetta ġdida
  4. 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.