Autentifikācija ar Bearer marķieri
Šajā lapā
Nodrošini savus API izsaukumus
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:
- Izveido jaunu atslēgu xAI konsolē
- Atjaunini atslēgu savā noslēpumu glabātuvē
- Atkārtoti izvieto savu lietotni
- Pārbaudi, vai viss darbojas ar jauno atslēgu
- 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ā:
- Nekavējoties atsauc to xAI konsolē
- Pārbaudi savu lietojuma vēsturi, lai noteiktu krāpniecisku izmantošanu
- Izveido jaunu atslēgu
- 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
Authorizationgalveni - 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.