Overovanie pomocou nosného tokenu (Bearer token)
Na tejto strane
Zabezpečenie volaní API
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:
- Vytvorte nový kľúč v konzole xAI
- Aktualizujte kľúč vo svojom trezore tajomstiev
- Znova nasaďte svoju aplikáciu
- Skontrolujte, či všetko funguje s novým kľúčom
- 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:
- Okamžite ho zrušte v konzole xAI
- Skontrolujte históriu využívania na známky podvodného použitia
- Vytvorte nový kľúč
- 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ť.