Autentifikacija pomoću Bearer tokena
Na ovoj stranici
Osiguraj svoje API pozive
Svaki zahtjev poslan xAI API-ju mora biti autentificiran. API koristi shemu Bearer tokena, široko prihvaćeni standard za REST API-je. Ova lekcija objašnjava kako mehanizam funkcionira i koje su najbolje prakse za zaštitu tvojih ključeva u produkcijskom okruženju.
Shema Bearer tokena
Kao što ime sugerira, svatko tko posjeduje („nosi“) token može pristupiti API-ju. Zato je zaštita tvog ključa temeljna: ne postoji provjera identiteta osim samog tokena.
Format zaglavlja
Svaki HTTP zahtjev mora uključivati zaglavlje Authorization s prefiksom Bearer nakon kojeg slijedi tvoj ključ:
Authorization: Bearer xai-your-api-key
Uz cURL, to izgleda ovako:
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"}'
U Pythonu, SDK-ovi automatski obrađuju ovo zaglavlje kada proslijediš ključ konstruktoru klijenta.
Pogreške autentifikacije
HTTP 401 Unauthorized
Ova pogreška znači da tvoj ključ nedostaje, nije valjan ili je opozvan. Provjeri:
- Je li postavljena varijabla okoline
XAI_API_KEY - Počinje li ključ s
xai- - Je li ključ opozvan u konzoli
HTTP 403 Forbidden
Tvoj ključ je valjan, ali nema dopuštenja potrebna za traženu radnju. To se može dogoditi zbog ograničenja tima na određene operacije.
Najbolje sigurnosne prakse
Nikada ne izlaži ključ u kodu
Ključevi se nikada ne smiju pojavljivati u čistom tekstu u:
- Verzioniranom izvornom kodu (Git)
- Zapisnicima aplikacije (logovima)
- URL-ovima ili parametrima upita
- Porukama o pogreškama prikazanima korisnicima
- GitHub issueima i pull requestovima
Koristi trezor tajni
U produkcijskom okruženju pohrani svoje ključeve u namjenski sustav:
- AWS Secrets Manager ili Parameter Store
- Google Secret Manager
- Azure Key Vault
- HashiCorp Vault
- Tajne tvoje CI/CD platforme (GitHub Actions, GitLab CI)
Rotacija ključeva
Redovito mijenjaj svoje ključeve, a odmah ako sumnjaš na curenje:
- Stvori novi ključ u xAI konzoli
- Ažuriraj ključ u svom trezoru tajni
- Ponovno implementiraj svoju aplikaciju
- Provjeri radi li sve s novim ključem
- Opozovi stari ključ u konzoli
Ograniči dopuštenja
Ako radiš u timu, stvori zasebne ključeve za svaku uslugu i okruženje. Ako je jedan kompromitiran, utjecaj ostaje ograničen na jedan kontekst.
Otkrivanje curenja
Prefiks xai- omogućuje alatima za otkrivanje (GitHub secret scanning, GitGuardian, TruffleHog) automatsku identifikaciju ključeva u izvornom kodu. Uključi ove alate u svoja spremišta kako bi bio odmah upozoren u slučaju slučajnog izlaganja.
Ako se ključ otkrije u javnom commitu:
- Odmah ga opozovi u xAI konzoli
- Provjeri povijest korištenja radi prijevarne uporabe
- Stvori novi ključ
- Očisti svoju Git povijest (ili još bolje, tretiraj ključ kao kompromitiran i nastavi dalje)
HTTPS je obavezan
xAI API prihvaća isključivo HTTPS veze. TLS enkriptira tvoje zahtjeve tijekom prijenosa, uključujući zaglavlje Authorization. Nikada ne pokušavaj zaobići ovu zaštitu: zahtjev preko neenkriptiranog HTTP-a izložio bi tvoj ključ na mreži.
Ključne točke
- API koristi shemu Bearer tokena putem zaglavlja
Authorization - Ključ je jedini faktor autentifikacije: štiti ga kao lozinku
- U produkciji koristi trezor tajni i nikada ne hardkodiraj ključ
- Uključi otkrivanje curenja u svoja Git spremišta
- Redovito rotiraj ključeve i odmah opozovi svaki kompromitirani ključ
Provjeri svoje razumijevanje
Temelji xAI API-ja: zadnja provjera prije nego što počneš graditi.
1. Što trebaš učiniti s API ključem čim ga stvoriš?
Odgovor: Pohrani ga na sigurno mjesto (prikazuje se samo jednom), izloži ga putem varijable XAI_API_KEY umjesto hardkodiranja, koristi jedan ključ po okruženju i odmah ga testiraj pozivom na /v1/models.
2. Koja je osnovna URL adresa i zašto je toliko važna?
Odgovor: https://api.x.ai/v1. Ona omogućuje kompatibilnost s OpenAI-jem: promjena base_url i ključa dovoljna je da se postojeći OpenAI kod usmjeri na Grok.
3. Koje SDK-ove možeš koristiti s Grokom?
Odgovor: Izvorni xAI SDK, OpenAI SDK (s xAI base_url) i Vercel AI SDK na JavaScript strani, plus cURL za testiranje: ekosustav je otvoren.
4. Koja je glavna krajnja točka za generiranje?
Odgovor: POST /v1/responses, moderni format; chat/completions ostaje dostupan kao legacy opcija radi kompatibilnosti.
5. Kako se autentificira svaki zahtjev?
Odgovor: S zaglavljem Authorization: Bearer i ključem xai-…: standardna shema Bearer tokena, ista bez obzira na SDK ili alat.
Osiguran ključ, osnovni URL, tvoj izbor SDK-a, Bearer svugdje: temelj je postavljen, a sljedeći tečajevi o API-ju nadograđuju se na njega.