Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Overovanie pomocou nosného tokenu (Bearer token)

Lekcia 14 z 14 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. Zabezpečenie volaní API
  2. Schéma Bearer token
  3. Chyby pri overovaní
  4. Osvedčené postupy zabezpečenia
  5. Detekcia únikov
  6. HTTPS je povinné
  7. Kľúčové poznatky
  8. Overte si svoje vedomosti

Zabezpečenie volaní API

Sprievodca začiatkom v dokumentácii xAI Každá požiadavka odoslaná na API xAI musí byť overená. API využíva schému Bearer token, čo je široko prijímaný štandard pre REST API. Táto lekcia vysvetľuje, ako tento mechanizmus funguje, a uvádza osvedčené postupy na ochranu vašich kľúčov v produkčnom prostredí.

Schéma Bearer token

Ako už názov napovedá, každý, kto vlastní („nesie“) token, môže pristupovať k API. Preto je ochrana vášho kľúča zásadná: neexistuje žiadna ďalšia kontrola identity okrem samotného tokenu.

Formát hlavičky

Každá požiadavka HTTP musí obsahovať hlavičku Authorization s predponou Bearer, za ktorou nasleduje váš kľúč:

Authorization: Bearer xai-your-api-key

Pri použití cURL to vyzerá takto:

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

V Pythone sa SDK o túto hlavičku postarajú automaticky, keď odovzdáte kľúč konštruktorovi klienta.

Chyby pri overovaní

HTTP 401 Unauthorized

Táto chyba znamená, že váš kľúč chýba, je neplatný alebo bol zrušený. Skontrolujte:

  • či je nastavená premenná prostredia XAI_API_KEY
  • či kľúč začína reťazcom xai-
  • či kľúč nebol zrušený v konzole

HTTP 403 Forbidden

Váš kľúč je platný, ale nemá oprávnenia potrebné na požadovanú akciu. K tomu môže dôjsť pri obmedzeniach tímu na určité operácie.

Osvedčené postupy zabezpečenia

Nikdy nezverejňujte kľúč v kóde

Kľúče sa nikdy nesmú objavovať v plain texte v:

  • verzionovanom zdrojovom kóde (Git)
  • logoch aplikácie
  • URL adresách alebo parametroch dotazu
  • chybových správach zobrazovaných používateľom
  • issue a pull requestoch na GitHub-e

Používajte trezor tajomstiev (Secrets Vault)

V produkčnom prostredí ukladajte svoje kľúče do vyhradeného systému:

  • AWS Secrets Manager alebo Parameter Store
  • Google Secret Manager
  • Azure Key Vault
  • HashiCorp Vault
  • Tajomstvá vašej CI/CD platformy (GitHub Actions, GitLab CI)

Rotácia kľúčov

Pravidelne meňte svoje kľúče a okamžite tak urobte, ak máte podozrenie na únik:

  1. Vytvorte nový kľúč v konzole xAI
  2. Aktualizujte kľúč vo svojom trezore tajomstiev
  3. Znova nasaďte svoju aplikáciu
  4. Skontrolujte, či všetko funguje s novým kľúčom
  5. Zrušte starý kľúč v konzole

Obmedzenie oprávnení

Ak pracujete v tíme, vytvorte samostatné kľúče pre každú službu a prostredie. Ak dôjde ku kompromitácii jedného z nich, dopad zostane obmedzený na jediný kontext.

Detekcia únikov

Predpona xai- umožňuje nástrojom na detekciu (skenovanie tajomstiev GitHub, GitGuardian, TruffleHog) automaticky identifikovať kľúče v zdrojovom kóde. Tieto nástroje zapnite vo svojich repozitároch, aby ste boli okamžite upozornení v prípade náhodného zverejnenia.

Ak sa kľúč zistí vo verejnom commite:

  1. Okamžite ho zrušte v konzole xAI
  2. Skontrolujte históriu využívania na známky podvodného použitia
  3. Vytvorte nový kľúč
  4. Vyčistite históriu Gitu (alebo ešte lepšie, považujte kľúč za kompromitovaný a pokračujte ďalej)

HTTPS je povinné

API xAI prijíma iba pripojenia HTTPS. TLS šifruje vaše požiadavky počas prenosu, vrátane hlavičky Authorization. Nikdy sa nepokúšajte obísť túto ochranu: požiadavka cez nešifrované HTTP by odhalila váš kľúč v sieti.

Kľúčové poznatky

  • API využíva schému Bearer token prostredníctvom hlavičky Authorization
  • Kľúč je jediným faktorom overovania: chráňte ho ako heslo
  • V produkčnom prostredí používajte trezor tajomstiev a nikdy kľúč nezakódujte natvrdo
  • Zapnite detekciu únikov vo svojich Git repozitároch
  • Pravidelne rotujte kľúče a okamžite zrušte akýkoľvek kompromitovaný kľúč

Overte si svoje vedomosti

Základy API xAI: posledná kontrola predtým, než začnete stavať.

1. Čo by ste mali urobiť s API kľúčom hneď po jeho vytvorení?

Odpoveď: Uložte ho na bezpečné miesto (zobrazí sa len raz), sprístupnite ho cez premennú XAI_API_KEY namiesto zakódovania natvrdo, používajte jeden kľúč na prostredie a okamžite ho otestujte volaním na /v1/models.

2. Aká je základná URL a prečo je taká dôležitá?

Odpoveď: https://api.x.ai/v1. Umožňuje kompatibilitu s OpenAI: zmena base_url a kľúča stačí na nasmerovanie existujúceho kódu pre OpenAI na Grok.

3. Ktoré SDK môžete používať s Grok?

Odpoveď: Natívne xAI SDK, OpenAI SDK (so základnou URL xAI) a Vercel AI SDK na strane JavaScriptu, plus cURL na testovanie: ekosystém je otvorený.

4. Aký je hlavný koncový bod pre generovanie?

Odpoveď: POST /v1/responses, moderný formát; chat/completions zostáva dostupný ako legacy možnosť pre kompatibilitu.

5. Ako sa overuje každá požiadavka?

Odpoveď: Pomocou hlavičky Authorization: Bearer a kľúča xai-…: štandardná schéma Bearer token, rovnaká bez ohľadu na použité SDK alebo nástroj.

Zabezpečený kľúč, základná URL, váš výber SDK, Bearer všade: základ je položený a ďalšie kurzy o API na ňom budú stavať.