Védd meg az API-kulcsodat: Soha ne tedd ki a kliens oldalon
Ezen az oldalon
Az API-kulcs egy jelszó
Az xAI API-kulcsod olyan, mint egy teljes hozzáférést biztosító jelszó a fiókodhoz. Bárki, aki megszerzi, a te költségedre hívhatja le az API-t, elérheti a modelljeidet, és potenciálisan veszélyeztetheti az adataidat. Miben tér el egy szabványos jelszótól? Egy ellopott kulcsot csendben lehet használni: addig nem veszel észre semmit, amíg meg nem érkezik a számla, vagy amíg a pénzügyi csapatod nem jelez riasztást. A szabály egyszerű és abszolút: soha ne tedd ki az API-kulcsot a kliens oldalon.
Gyakori kitettségi vektorok
A leggyakoribb eset a kulcs közvetlen beleírása a frontend JavaScript kódba:
// VESZÉLY - SOHA ne csináld ezt
const response = await fetch("https://api.x.ai/v1/chat/completions", {
headers: { "Authorization": "Bearer xai-abc123..." }
});
Miután ezt deployoltad, a kód bárki számára láthatóvá válik a böngésző fejlesztői eszközeivel. Csak meg kell nyitnod a Hálózat (Network) fület, és máris olvashatod a kulcsot nyílt szöveges formátumban a kérés fejlécében.
Egy alattomosabb vektor, mert hamis biztonságérzetet kelt: a frontend környezeti változók. A NEXT_PUBLIC_, VITE_ vagy REACT_APP_ előtaggal rendelkező változók a build folyamat során belekerülnek a JavaScript csomagba, így nyilvánossá válnak. A fejlesztő azt hiszi, hogy „kint hagyta a kulcsot a kódból“; a valóságban egyszerűen belefordította a fordított állományba:
# VESZÉLY - ez a változó benne lesz a csomagban
NEXT_PUBLIC_XAI_API_KEY=xai-abc123...
A Git tárolók a harmadik klasszikus vektor. Még egy törölt commit is benne marad a Git előzményeiben: ha véletlenül commitoltál egy kulcsot, az előzmények átírása nem elég, mert a klónok és forkok megőrizhették azt. Tekintsed kompromittáltnak, és vond vissza azonnal. Végül a kulcsok közvetett utakon is kiszivároghatnak, amit nehezebb elképzelni, mégis nagyon gyakori: olyan alkalmazásnaplók, amelyek teljes fejléceket rögzítenek, a felhasználónak megjelenített hibaüzenetek, vagy olyan monitorozó eszközök, amelyek elkapják a kimenő kéréseket.
Proxy architektúra: A megoldás
Az egyetlen biztonságos megközelítés, ha minden hívást a backendeden keresztül proxyzol:
Kliens (böngésző/mobil)
↓ kérés API-kulcs nélkül
A te backended (szerver)
↓ hozzáadja az API-kulcsot (környezeti változó)
xAI API
↓ válasz
A te backended
↓ továbbítja a választ (szükség esetén szűrve)
Kliens
Íme egy minimalista proxy Pythonban:
# Python Backend (Flask)
import os
from flask import Flask, request, jsonify
import requests
app = Flask(__name__)
XAI_KEY = os.environ["XAI_API_KEY"] # Csak szerveroldali változó
@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())
A kulcs védelmén túl – amelyet soha nem küldünk el a kliensnek – a proxy egy olyan kontrollpontot biztosít, amit a közvetlen hívások lehetetlenné tesznek. Szűrheted a kéréseket: sebességkorlátozást (rate limiting) alkalmazhatsz, hogy megakadályozd, egy kliens lemerítse a kvótádat, validálhatod a bemenetet, és tartalommoderációt végezhetsz. Te kontrollálod, mely modellek érhetők el, megakadályozva, hogy egy feltört kliens drága modellt hívjon meg váratlan költségeket generálva. Naplózhatod a hívásokat auditálás céljából – ez központi igény egy megfelelőségi vezető számára. És gyorsítótárazhatsz bizonyos válaszokat, hogy csökkentsd a költségeket az ismétlődő kéréseknél.
Biztonságos kulcstárolás
Szerveroldalon az alapvetés a környezeti változó használata, amelyet egy .env fájlból töltünk be, és amelyet soha nem commitolunk a Gitbe:
# .env fájl (SOHA ne commitold Gitbe)
XAI_API_KEY=xai-your-secret-key
Szisztematikusan add hozzá ezeket a fájlokat a .gitignore állományodhoz:
# .gitignore
.env
.env.local
.env.production
Éles környezetben egy szerverre helyezett .env fájl továbbra is törékeny, manuális folyamatnak számít: részesítsd előnyben a dedikált titokkezelőket (secrets manager). Bevált lehetőségek az AWS Secrets Manager vagy SSM Parameter Store, a Google Secret Manager, az Azure Key Vault, a HashiCorp Vault, illetve könnyebb struktúrákhoz a Doppler és az Infisical. Amit ezek az eszközök nyújtanak egy sima fájl felett: automatikus kulcsrotáció, hozzáférés-auditálás – ki melyik titkot olvasta és mikor –, valamint nyugalmi állapotban történő titkosítás. Ezeket az elemeket változatlan formában bemutathatod egy biztonsági audit során, míg egy gépen lévő szöveges fájl semmit sem bizonyít.
Mi a teendő kompromittált kulcs esetén?
Ha gyanakszol arra, hogy egy kulcs kiszivárgott, a műveletek sorrendje ugyanolyan fontos, mint maguk a műveletek. Vonjd vissza a kulcsot az xAI konzolon (console.x.ai) minden más előtt: minden perc, amíg a kompromittált kulcs aktív marad, egy perc a lehetséges kihasználásra, és a szolgáltatás folytonosságát ezután, nem pedig előtte kell kezelni. Ezután generálj egy új kulcsot, és frissítsd a backendjeidet a szolgáltatás helyreállításához.
Az incidens még nem zárult le. Vizsgáld felül a használatot, és keress gyanús API-hívásokat a számlázási előzményeidben – kiugrást szokatlan időablakban, vagy olyan modellhez kötött használatot, amelyet nem te használsz. Azonosítsd a szivárgás forrását, különben az új kulcs ugyanazon az úton fog elveszni, mint a régi. Zárásként pásztázd át a kódodat olyan eszközökkel, mint a gitleaks vagy a truffleHog, amelyek szintén átvizsgálják a Git előzményeit, és gyakran tárnak fel egyéb, régóta elfelejtett titkokat.
Főbb megállapítások
- Az API-kulcs egy jelszó, amely teljes hozzáférést biztosít a fiókodhoz
- Mindig proxyzold az API-hívásokat a backendeden keresztül
- A
NEXT_PUBLIC_,VITE_,REACT_APP_változók nyilvánosak - Éles környezetben használj titokkezelőt (secrets manager)
- Ha egy kulcs kompromittálódik, azonnal vond vissza, és vizsgáld felül a használatot