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

Chraň svůj klíč API: Nikdy ho neodhaluj na straně klienta

Lekce 6 z 12 Aktualizováno 28. července 2026 Pokročilý
Na této stránce
  1. Klíč API je jako heslo
  2. Běžné vektory úniku
  3. Architektura proxy: Řešení
  4. Bezpečné ukládání klíčů
  5. Co dělat při kompromitaci klíče
  6. Klíčové poznatky

Klíč API je jako heslo

Tvůj klíč API xAI funguje jako heslo s plným přístupem k tvému účtu. Kdokoli jej získá, může provádět volání API na tvé náklady, přistupovat k tvým modelům a potenciálně ohrozit tvá data. Jak se liší od běžného hesla? Ukradený klíč lze využít potichu: nic nezaznamenáš, dokud nepřijde faktura nebo dokud tvůj finanční tým nezvedne poplach. Pravidlo je jednoduché a absolutní: nikdy neodhaluj klíč API na straně klienta.

Běžné vektory úniku

Nejčastějším případem je přímé zahrnutí klíče do frontendového JavaScriptu:

// NEBEZPEČÍ - Nikdy nedělej toto
const response = await fetch("https://api.x.ai/v1/chat/completions", {
  headers: { "Authorization": "Bearer xai-abc123..." }
});

Jakmile je tento kód nasazen, je viditelný pro každého, kdo používá vývojářské nástroje prohlížeče. Stačí otevřít kartu Síť (Network) a přečíst si klíč v prostém textu v hlavičkách požadavku.

Zrádnějším vektorem, protože vytváří falešný pocit bezpečí, jsou proměnné prostředí na frontendu. Proměnné s prefixem NEXT_PUBLIC_, VITE_ nebo REACT_APP_ jsou při sestavení zabalené do JavaScriptu, a jsou tedy veřejné. Vývojář si myslí, že „udržel klíč mimo kód“; ve skutečnosti je do něj pouze zkompilován:

# NEBEZPEČÍ - tato proměnná bude ve svazku
NEXT_PUBLIC_XAI_API_KEY=xai-abc123...

Git repozitáře jsou třetím klasickým vektorem. I smazaný commit zůstává v historii Gitu: pokud jsi omylem commitnul klíč, přepsání historie nestačí, protože klony a forky si jej mohly ponechat. Považuj jej za kompromitovaný a zruš jej. Nakonec klíče unikají i nepřímými cestami, které si hůře představíš, ale jsou velmi časté: aplikační logy, které zaznamenávají celé hlavičky, chybové zprávy zobrazované uživateli nebo monitorovací nástroje, které zachycují odchozí požadavky.

Architektura proxy: Řešení

Jediným bezpečným přístupem je proxyrovat všechna volání přes tvůj backend:

Klient (prohlížeč/mobil)
    ↓ požadavek bez klíče API
Tvůj Backend (server)
    ↓ přidá klíč API (proměnná prostředí)
xAI API
    ↓ odpověď
Tvůj Backend
    ↓ přepošle odpověď (případně filtrovanou)
Klient

Zde je minimalistické proxy v Pythonu:

# Python Backend (Flask)
import os
from flask import Flask, request, jsonify
import requests

app = Flask(__name__)
XAI_KEY = os.environ["XAI_API_KEY"]  # Pouze proměnná na straně serveru

@app.route("/api/chat", methods=["POST"])
def proxy_chat():
    user_message = request.json.get("message")

    response = requests.post(
        "https://api.x.ai/v1/chat/completions",
        headers={"Authorization": f"Bearer {XAI_KEY}"},
        json={
            "model": "grok-4.3",
            "messages": [{"role": "user", "content": user_message}]
        }
    )

    return jsonify(response.json())

Kromě ochrany klíče – který se nikdy nepřenáší ke klientovi – ti proxy poskytuje kontrolní bod, který přímá volání neumožňují. Můžeš filtrovat požadavky: omezování rychlosti (rate limiting), aby klient nevyčerpal tvou kvótu, validace vstupu, moderování obsahu. Ty rozhoduješ, které modely jsou přístupné, čímž zabráníš tomu, aby převzatý klient volal drahý model a generoval neočekávané náklady. Můžeš logovat volání pro účely auditu – což je klíčová potřeba pro vedoucího compliance. A můžeš cacheovat určité odpovědi, abys snížil náklady na opakující se požadavky.

Bezpečné ukládání klíčů

Na straně serveru je základem proměnná prostředí, načtená ze souboru .env, který se nikdy necommituje do Gitu:

# Soubor .env (NIKDY necommitovat do Gitu)
XAI_API_KEY=xai-tvuj-tajny-klíč

Systematicky přidávej tyto soubory do svého .gitignore:

# .gitignore
.env
.env.local
.env.production

Pro produkční prostředí zůstává soubor .env umístěný na serveru křehkým manuálním procesem: upřednostni vyhrazeného správce tajných klíčů (secrets manager). Osvědčené možnosti zahrnují AWS Secrets Manager nebo SSM Parameter Store, Google Secret Manager, Azure Key Vault, HashiCorp Vault nebo Doppler a Infisical pro lehčí struktury. Co tyto nástroje poskytují navíc oproti prostému souboru: automatickou rotaci klíčů, audit přístupu – kdo a kdy četl které tajemství – a šifrování v klidovém stavu (at rest). To jsou prvky, které můžeš předložit tak, jak jsou během bezpečnostního auditu, zatímco textový soubor na stroji nic nedokazuje.

Co dělat při kompromitaci klíče

Pokud máš podezření, že byl klíč odhalen, záleží na pořadí operací stejně jako na nich samotných. Nejdříve zruš klíč v konzoli xAI (console.x.ai): každá minuta, kdy kompromitovaný klíč zůstává aktivní, je minutou možného zneužití, a kontinuita služby se řeší až poté, ne předtím. Poté vygeneruj nový klíč a aktualizuj své backends, abys obnovil službu.

Incident tím ještě není uzavřen. Proveď audit využití hledáním podezřelých volání API v historii fakturace – nárůst v neobvyklém časovém okně, využití připisované modelu, který nepoužíváš. Identifikuj zdroj úniku, jinak půjde nový klíč stejnou cestou jako ten starý. Nakonec naskenuj svůj kód nástroji jako gitleaks nebo truffleHog, které procházejí i historii Gitu a často odhalí další tajemství zapomenutá před dávnou dobou.

Klíčové poznatky

  • Klíč API je heslo s plným přístupem k tvému účtu
  • Vždy proxyruj volání API přes svůj backend
  • Proměnné NEXT_PUBLIC_, VITE_, REACT_APP_ jsou veřejné
  • V produkci používej správce tajných klíčů (secrets manager)
  • Pokud je klíč kompromitován, okamžitě jej zruš a zaudituj využití