Ověřování pomocí bearer tokenu
Na této stránce
Zabezpečení volání API
Každý požadavek odeslaný na API xAI musí být ověřen. API využívá schéma Bearer token, což je široce přijímaný standard pro REST API. Tato lekce vysvětluje, jak tento mechanismus funguje, a uvádí osvědčené postupy pro ochranu tvých klíčů v produkčním prostředí.
Schéma Bearer tokenu
Jak název napovídá, přístup k API má každý, kdo token vlastní („nese“). Proto je zásadní ochrana tvého klíče: mimo samotný token neprobíhá žádná další kontrola identity.
Formát hlavičky
Každý požadavek HTTP musí obsahovat hlavičku Authorization s prefixem Bearer, za kterým následuje tvůj klíč:
Authorization: Bearer xai-your-api-key
Při použití cURL to vypadá 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 Pythonu se SDK o tuto hlavičku postarají automaticky, když předáš klíč do konstruktoru klienta.
Chyby ověření
HTTP 401 Unauthorized
Tato chyba znamená, že tvůj klíč chybí, je neplatný nebo byl zrušen. Zkontroluj:
- Zda je nastavena proměnná prostředí
XAI_API_KEY - Zda klíč začíná řetězcem
xai- - Zda nebyl klíč zrušen v konzoli
HTTP 403 Forbidden
Tvůj klíč je platný, ale nemá oprávnění potřebná pro požadovanou akci. K tomu může dojít kvůli omezením týmu na určité operace.
Osvědčené postupy zabezpečení
Nikdy nezveřejňuj klíč v kódu
Klíče se nikdy nesmí objevit v čitelné podobě v:
- Verzovaném zdrojovém kódu (Git)
- Logách aplikací
- URL adresách nebo parametrech dotazu
- Chybových zprávách zobrazovaných uživatelům
- Issues a pull requestech na GitHubu
Používej trezor tajů (Secrets Vault)
V produkčním prostředí ukládej své klíče do vyhrazeného systému:
- AWS Secrets Manager nebo Parameter Store
- Google Secret Manager
- Azure Key Vault
- HashiCorp Vault
- Tajů tvé CI/CD platformy (GitHub Actions, GitLab CI)
Rotace klíčů
Pravidelně měň své klíče a okamžitě tak učiň, pokud máš podezření na únik:
- Vytvoř nový klíč v konzoli xAI
- Aktualizuj klíč ve svém trezoru tajů
- Znovu nasadit svou aplikaci
- Ověř, že vše funguje s novým klíčem
- Zruš starý klíč v konzoli
Omezení oprávnění
Pokud pracuješ v týmu, vytvoř samostatné klíče pro každou službu a prostředí. Pokud dojde k компromitaci jednoho z nich, dopad zůstane omezen pouze na daný kontext.
Detekce úniků
Prefix xai- umožňuje nástrojům pro detekci (skenování tajů GitHubu, GitGuardian, TruffleHog) automaticky identifikovat klíče ve zdrojovém kódu. Aktivuj tyto nástroje ve svých repozitářích, abys byl okamžitě upozorněn v případě náhodného odhalení.
Pokud je klíč detekován ve veřejném commitu:
- Okamžitě jej zruš v konzoli xAI
- Zkontroluj historii využití kvůli podvodnému použití
- Vytvoř nový klíč
- Vyčisti historii Gitu (nebo lépe považuj klíč za kompromitovaný a pokračuj dál)
HTTPS je povinné
API xAI přijímá pouze připojení HTTPS. TLS šifruje tvé požadavky během přenosu, včetně hlavičky Authorization. Nikdy se nepokoušej toto zabezpečení obejít: požadavek přes nešifrované HTTP by odhalil tvůj klíč v síti.
Klíčové poznatky
- API využívá schéma Bearer token prostřednictvím hlavičky
Authorization - Klíč je jediným ověřovacím faktorem: chraň jej jako heslo
- V produkci používej trezor tajů a nikdy klíč nepiš přímo do kódu
- Aktivuj detekci úniků ve svých Git repozitářích
- Pravidelně rotuj klíče a okamžitě zruš jakýkoli kompromitovaný klíč
Ověř si své znalosti
Základy API xAI: poslední kontrola předtím, než začneš tvořit.
1. Co bys měl udělat s API klíčem hned po jeho vytvoření?
Odpověď: Ulož jej na bezpečné místo (je zobrazen pouze jednou), zpřístupni jej prostřednictvím proměnné XAI_API_KEY místo přímého zápisu do kódu, používej jeden klíč pro každé prostředí a okamžitě jej otestuj voláním na /v1/models.
2. Jaká je základní URL a proč je tak důležitá?
Odpověď: https://api.x.ai/v1. Právě ona umožňuje kompatibilitu s OpenAI: změna base_url a klíče stačí k tomu, aby stávající kód pro OpenAI směřoval na Grok.
3. Která SDK můžeš s Grokem používat?
Odpověď: Natívní SDK od xAI, SDK od OpenAI (s base_url pro xAI) a na straně JavaScriptu také Vercel AI SDK, plus cURL pro testování: ekosystém je otevřený.
4. Jaký je hlavní koncový bod pro generování?
Odpověď: POST /v1/responses, což je moderní formát; chat/completions zůstává dostupný jako legacy možnost pro zachování kompatibility.
5. Jak je ověřován každý požadavek?
Odpověď: Pomocí hlavičky Authorization: Bearer a klíče xai-…: standardní schéma Bearer tokenu, stejné bez ohledu na použité SDK nebo nástroj.
Zabezpečený klíč, základní URL, výběr SDK a Bearer všude: základ je položen a další kurzy o API na něm budou stavět.