Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Ověřování pomocí bearer tokenu

Lekce 14 z 14 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. Zabezpečení volání API
  2. Schéma Bearer tokenu
  3. Chyby ověření
  4. Osvědčené postupy zabezpečení
  5. Detekce úniků
  6. HTTPS je povinné
  7. Klíčové poznatky
  8. Ověř si své znalosti

Zabezpečení volání API

Průvodce začátky v dokumentaci xAI 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:

  1. Vytvoř nový klíč v konzoli xAI
  2. Aktualizuj klíč ve svém trezoru tajů
  3. Znovu nasadit svou aplikaci
  4. Ověř, že vše funguje s novým klíčem
  5. 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:

  1. Okamžitě jej zruš v konzoli xAI
  2. Zkontroluj historii využití kvůli podvodnému použití
  3. Vytvoř nový klíč
  4. 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.