Chráň svoj API kľúč: Nikdy ho neodhaľuj na strane klienta
Na tejto strane
API kľúč je heslo
Tvoj API kľúč xAI funguje ako heslo s plným prístupom k tvojmu účtu. Ktokoľvek, kto ho má, môže robiť volania API na tvoje náklady, pristupovať k tvojim modelom a potenciálne ohroziť tvoje dáta. V čom sa líši od bežného hesla? Ukradnutý kľúč možno použiť potichu: nič nezbadáš, kým nepríde faktúra alebo kým tvoj finančný tím nevyvolá poplach. Pravidlo je jednoduché a absolútne: nikdy neodhaľuj API kľúč na strane klienta.
Bežné vektory úniku
Najčastejším prípadom je priame zahrnutie kľúča do frontendového JavaScriptu:
// NEBEZPEČENSTVO - Nikdy to nerob takto
const response = await fetch("https://api.x.ai/v1/chat/completions", {
headers: { "Authorization": "Bearer xai-abc123..." }
});
Po nasadení je tento kód viditeľný pre každého, kto používa vývojárske nástroje prehliadača. Stačí otvoriť kartu Sieť (Network) a kľúč si prečítaš v čistom texte v hlavičkách požiadavky.
Záludnejším vektorom, pretože vytvára falošný pocit bezpečia, sú premenné prostredia na fronte. Premenné s prefixom NEXT_PUBLIC_, VITE_ alebo REACT_APP_ sú zabalené do JavaScriptu už počas zostavenia (build), a sú teda verejné. Vývojár si myslí, že „udržal kľúč mimo kódu“; v skutočnosti je doňho jednoducho skompilovaný:
# NEBEZPEČENSTVO - táto premenná bude vo finálnom balíku
NEXT_PUBLIC_XAI_API_KEY=xai-abc123...
Git repozitáre sú tretím klasickým vektorom. Aj odstránený commit zostáva v histórii Gitu: ak si omylom commitol kľúč, prepísanie histórie nestačí, pretože klony a forky si ho mohli zachovať. Pokladaj ho za kompromitovaný a zruš ho. Nakoniec, kľúče unikajú aj nepriamymi cestami, ktoré si ťažšie predstaviť, no sú veľmi časté: aplikačné logy, ktoré zaznamenávajú celé hlavičky, chybové hlášky zobrazované používateľovi alebo monitorovacie nástroje, ktoré zachytávajú odchádzajúce požiadavky.
Architektúra proxy: Riešenie
Jediný bezpečný prístup je smerovať všetky volania cez tvoj backend:
Klient (prehliadač/mobil)
↓ požiadavka bez API kľúča
Tvoj Backend (server)
↓ pridá API kľúč (premenná prostredia)
API xAI
↓ odpoveď
Tvoj Backend
↓ prepíše odpoveď (v prípade potreby filtrovanú)
Klient
Tu je minimalistické proxy v Pythone:
# Python Backend (Flask)
import os
from flask import Flask, request, jsonify
import requests
app = Flask(__name__)
XAI_KEY = os.environ["XAI_API_KEY"] # Premenná len na strane servera
@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())
Okrem ochrany kľúča – ktorý sa nikdy neprenáša ku klientovi – ti proxy poskytuje kontrolný bod, ktorý pri priamych volaniach nie je možný. Môžeš filtrovať požiadavky: obmedzovanie rýchlosti (rate limiting), aby klient vyčerpal tvoju kvótu, validácia vstupu, moderovanie obsahu. Ty rozhoduješ, ktoré modely sú dostupné, čím zabraňuješ tomu, aby unesený klient volal drahý model a generoval neočakávané náklady. Môžeš logovať volania na účely auditu – čo je kľúčová potreba pre vedúceho compliance. A môžeš ukladať do vyrovnávacej pamäte (cache) určité odpovede, aby si znížil náklady na opakujúce sa požiadavky.
Bezpečné ukladanie kľúčov
Na strane servera je základom premenná prostredia, načítaná zo súboru .env, ktorý sa nikdy necommituje do Gitu:
# Súbor .env (NIKDY necommitovať do Gitu)
XAI_API_KEY=xai-tvoj-tajny-kluc
Systematicky pridávaj tieto súbory do svojho .gitignore:
# .gitignore
.env
.env.local
.env.production
Pre produkčné prostredia zostáva súbor .env umiestnený na serveri krehkým manuálnym procesom: uprednostni vyhradeného správcu tajomstiev (secrets manager). Overené možnosti zahŕňajú AWS Secrets Manager alebo SSM Parameter Store, Google Secret Manager, Azure Key Vault, HashiCorp Vault, alebo Doppler a Infisical pre ľahšie štruktúry. Čo tieto nástroje poskytujú navyše oproti plochému súboru: automatické otáčanie kľúčov, audit prístupu – kto čítal ktoré tajomstvo a kedy – a šifrovanie v pokoji (at rest). Toto sú prvky, ktoré môžeš predložiť tak, ako sú počas bezpečnostného auditu, zatiaľ čo textový súbor na stroji nepreukazuje nič.
Čo robiť, ak je tvoj kľúč kompromitovaný
Ak máš podozrenie, že bol kľúč odhalený, poradie operácií je rovnako dôležité ako samotné operácie. Ešte pred čímkoľvek iným zruš kľúč v konzole xAI (console.x.ai): každá minúta, počas ktorej zostáva kompromitovaný kľúč aktívny, je minútou možného zneužitia a kontinuita služby sa rieši až potom, nie predtým. Následne vygeneruj nový kľúč a aktualizuj svoje backends, aby si obnovil službu.
Incident tým ešte nie je uzavretý. Audituj využitie hľadaním podozrivých volaní API v histórii fakturácie – nárast počas nezvyčajného časového okna, využitie pripísané modelu, ktorý nepoužívaš. Identifikuj zdroj úniku, inak pôjde nový kľúč rovnakou cestou ako ten starý. Na záver preskenuj svoj kód nástrojmi ako gitleaks alebo truffleHog, ktoré prechádzajú aj históriou Gitu a často odhalia ďalšie tajomstvá zabudnuté už dávno.
Kľúčové poznatky
- API kľúč je heslo s plným prístupom k tvojmu účtu
- Volania API vždy smeruj cez tvoj backend
- Premenné
NEXT_PUBLIC_,VITE_,REACT_APP_sú verejné - V produkcii používaj správcu tajomstiev (secrets manager)
- Ak je kľúč kompromitovaný, okamžite ho zruš a audituj využitie