Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Autentifikācija ar Bearer marķieri

Nodarbība 14 no 14 Atjaunota 2026. gada 30. jūlijs Programmētājs
Šajā lapā
  1. Nodrošini savus API izsaukumus
  2. Bearer marķiera shēma
  3. Autentifikācijas kļūdas
  4. Drošības labākā prakse
  5. Noplūdes noteikšana
  6. HTTPS ir obligāts
  7. Galvenās atziņas
  8. Pārbaudi savas zināšanas

Nodrošini savus API izsaukumus

Sākuma rokasgrāmata xAI dokumentācijā Katrs pieprasījums, kas nosūtīts uz xAI API, ir jāautentificē. API izmanto Bearer marķiera shēmu, kas ir plaši pieņemts standarts REST API. Šī nodarbība paskaidro, kā šis mehānisms darbojas, un iepazīstina ar labāko praksi atslēgu aizsardzībai darbības vidē.

Bearer marķiera shēma

Kā liecina nosaukums, ikviens, kuram ir (“nes”) marķieris, var piekļūt API. Tieši tāpēc tavas atslēgas aizsardzība ir fundamentāla: aiz marķiera nav nekādas papildu identitātes pārbaudes.

Galvenes formāts

Katram HTTP pieprasījumam ir jāiekļauj Authorization galvene ar prefiksu Bearer, kam seko tava atslēga:

Authorization: Bearer xai-your-api-key

Izmantojot cURL, tas izskatās šādi:

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"}'

Python valodā SDK automātiski apstrādā šo galveni, kad nodev atslēgu klienta konstruktoram.

Autentifikācijas kļūdas

HTTP 401 Unauthorized (Nesankcionēta piekļuve)

Šī kļūda nozīmē, ka tava atslēga trūkst, ir nederīga vai atsaukta. Pārbaudi:

  • Vai ir iestatīts vides mainīgais XAI_API_KEY
  • Vai atslēga sākas ar xai-
  • Vai atslēga nav atsaukta konsolē

HTTP 403 Forbidden (Aizliegts)

Tava atslēga ir derīga, taču tai nav nepieciešamo atļauju pieprasītās darbības veikšanai. Tas var notikt, ja komandai ir noteikti ierobežojumi konkrētām operācijām.

Drošības labākā prakse

Nekad neizpauž atslēgu kodā

Atslēgām nekad nevajadzētu parādīties skaidrā tekstā:

  • Versijās kontrolētā pirmkodā (Git)
  • Lietotņu žurnālos (logos)
  • URL adresēs vai vaicājuma parametros
  • Kļūdas ziņojumos, kas tiek rādīti lietotājiem
  • GitHub problēmās (issues) un vilkšanas pieprasījumos (pull requests)

Izmanto noslēpumu glabātuvi

Darbības vidē glabā savas atslēgas specializētā sistēmā:

  • AWS Secrets Manager vai Parameter Store
  • Google Secret Manager
  • Azure Key Vault
  • HashiCorp Vault
  • Tavas CI/CD platformas noslēpumi (GitHub Actions, GitLab CI)

Atslēgu rotācija

Maini savas atslēgas regulāri un nekavējoties, ja ir aizdomas par noplūdi:

  1. Izveido jaunu atslēgu xAI konsolē
  2. Atjaunini atslēgu savā noslēpumu glabātuvē
  3. Atkārtoti izvieto savu lietotni
  4. Pārbaudi, vai viss darbojas ar jauno atslēgu
  5. Atsauc veco atslēgu konsolē

Ierobežo atļaujas

Ja strādā komandā, izveido atsevišķas atslēgas katram servisam un videi. Ja viena tiek apdraudēta, ietekme paliek ierobežota tikai vienā kontekstā.

Noplūdes noteikšana

Prefikss xai- ļauj noteikšanas rīkiem (GitHub secret scanning, GitGuardian, TruffleHog) automātiski identificēt atslēgas pirmkodā. Aktivizē šos rīkus savos repozitorijos, lai tiktu brīdināts uzreiz nejaušas izpaušanas gadījumā.

Ja atslēga tiek konstatēta publiskā commitā:

  1. Nekavējoties atsauc to xAI konsolē
  2. Pārbaudi savu lietojuma vēsturi, lai noteiktu krāpniecisku izmantošanu
  3. Izveido jaunu atslēgu
  4. Notīri savu Git vēsturi (vai, vēl labāk, uzskati atslēgu par apdraudētu un dodies tālāk)

HTTPS ir obligāts

xAI API pieņem tikai HTTPS savienojumus. TLS šifrē tavus pieprasījumus pārsūtīšanas laikā, tostarp Authorization galveni. Nekad nemēģini apiet šo aizsardzību: pieprasījums pa nešifrētu HTTP pakļautu tavu atslēgu tīklā.

Galvenās atziņas

  • API izmanto Bearer marķiera shēmu, izmantojot Authorization galveni
  • Atslēga ir vienīgais autentifikācijas faktors: aizsargā to kā paroli
  • Darbības vidē izmanto noslēpumu glabātuvi un nekad neiekodē atslēgu tieši kodā
  • Aktivizē noplūdes noteikšanu savos Git repozitorijos
  • Regulāri rotē atslēgas un nekavējoties atsauc jebkuru apdraudētu atslēgu

Pārbaudi savas zināšanas

xAI API pamati: pēdējā pārbaude pirms būvniecības uzsākšanas.

1. Kas jādara ar API atslēgu tūlīt pēc tās izveides?

Atbilde: Glabā to drošā vietā (tā tiek parādīta tikai vienreiz), eksponē to caur mainīgo XAI_API_KEY, nevis iekodējot to tieši, izmanto vienu atslēgu katrai videi un nekavējoties pārbaudi to, veicot izsaukumu uz /v1/models.

2. Kāda ir bāzes URL un kāpēc tā ir tik svarīga?

Atbilde: https://api.x.ai/v1. Tieši tā padara iespējamu saderību ar OpenAI: mainot base_url un atslēgu, pietiek, lai novirzītu esošo OpenAI kodu uz Grok.

3. Kurus SDK vari izmantot kopā ar Grok?

Atbilde: Natīvo xAI SDK, OpenAI SDK (ar xAI base_url) un Vercel AI SDK JavaScript pusē, kā arī cURL testēšanai: ekosistēma ir atvērta.

4. Kāds ir galvenais ģenerēšanas galapunkts?

Atbilde: POST /v1/responses, kas ir modernais formāts; chat/completions joprojām ir pieejams kā mantots variants saderībai.

5. Kā tiek autentificēts katrs pieprasījums?

Atbilde: Izmantojot Authorization: Bearer galveni un xai-… atslēgu: standarta Bearer marķiera shēma, kas ir vienāda neatkarīgi no SDK vai rīka.

Nodrošināta atslēga, bāzes URL, tavas izvēles SDK, Bearer visur: pamats ir likts, un nākamie API kursi balstīsies uz to.