Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Autentifikacija pomoću Bearer tokena

Lekcija 14 od 14 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. Osiguraj svoje API pozive
  2. Shema Bearer tokena
  3. Pogreške autentifikacije
  4. Najbolje sigurnosne prakse
  5. Otkrivanje curenja
  6. HTTPS je obavezan
  7. Ključne točke
  8. Provjeri svoje razumijevanje

Osiguraj svoje API pozive

Vodič za početak u xAI dokumentaciji 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:

  1. Stvori novi ključ u xAI konzoli
  2. Ažuriraj ključ u svom trezoru tajni
  3. Ponovno implementiraj svoju aplikaciju
  4. Provjeri radi li sve s novim ključem
  5. 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:

  1. Odmah ga opozovi u xAI konzoli
  2. Provjeri povijest korištenja radi prijevarne uporabe
  3. Stvori novi ključ
  4. 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.