Protejați-vă cheia API: Nu o expuneți niciodată în partea client
Pe această pagină
O cheie API este o parolă
Cheia dumneavoastră API xAI funcționează ca o parolă cu acces complet la contul dumneavoastră. Oricine o deține poate face apeluri API pe cheltuiala dumneavoastră, poate accesa modelele dumneavoastră și poate compromite potențial datele. Cum diferă aceasta de o parolă standard? O cheie furată poate fi utilizată în tăcere: nu veți observa nimic până la sosirea facturii sau până când echipa financiară declanșează o alertă. Regula este simplă și absolută: nu expuneți niciodată o cheie API în partea client.
Vectori comuni de expunere
Cel mai frecvent caz este includerea directă a cheii în JavaScript-ul din frontend:
// PERICOL - NU faceți niciodată asta
const response = await fetch("https://api.x.ai/v1/chat/completions", {
headers: { "Authorization": "Bearer xai-abc123..." }
});
Odată implementat, acest cod este vizibil pentru oricine utilizează instrumentele de dezvoltare ale browserului. Este suficient să deschideți fila Network (Rețea) pentru a citi cheia în text clar în anteturile cererii.
Un vector mai insidios, deoarece oferă un fals sentiment de securitate: variabilele de mediu din frontend. Variabilele care încep cu NEXT_PUBLIC_, VITE_ sau REACT_APP_ sunt incluse în pachetul JavaScript la momentul compilării și, prin urmare, sunt publice. Dezvoltatorul crede că a „ținut cheia în afara codului“; în realitate, aceasta este pur și simplu compilată în interiorul acestuia:
# PERICOL - această variabilă va fi în pachet
NEXT_PUBLIC_XAI_API_KEY=xai-abc123...
Depozitele Git reprezintă al treilea vector clasic. Chiar și un commit șters rămâne în istoricul Git: dacă ați făcut commit unei chei din greșeală, rescrierea istoricului nu este suficientă, deoarece clonele și fork-urile o pot fi păstrat. Considerați-o compromisă și revocați-o. În final, cheile se scurg și prin căi indirecte, mai greu de imaginat, dar foarte comune: jurnalele de aplicație care înregistrează anteturi complete, mesajele de eroare afișate utilizatorului sau instrumentele de monitorizare care capturează cererile outgoing.
Arhitectura Proxy: Soluția
Singura abordare securizată este să proxy-ați toate apelurile prin backend-ul dumneavoastră:
Client (browser/mobile)
↓ cerere fără cheia API
Backend-ul dumneavoastră (server)
↓ adaugă cheia API (variabilă de mediu)
API xAI
↓ răspuns
Backend-ul dumneavoastră
↓ transmite răspunsul (filtrat dacă este necesar)
Client
Iată un proxy minimalist în Python:
# Backend Python (Flask)
import os
from flask import Flask, request, jsonify
import requests
app = Flask(__name__)
XAI_KEY = os.environ["XAI_API_KEY"] # Variabilă doar pe server
@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())
Dincolo de protejarea cheii – care nu este niciodată transmisă către client – proxy-ul vă oferă un punct de control pe care apelurile directe îl fac imposibil. Puteți filtra cererile: limitarea ratei (rate limiting) pentru a preveni epuizarea cotei de către un client, validarea input-urilor, moderarea conținutului. Controlați care modele sunt accesibile, prevenind ca un client deturnat să apeleze un model costisitor și să genereze costuri neașteptate. Puteți înregistra apelurile pentru audit – o nevoie centrală pentru un responsabil de conformitate. Și puteți stoca în cache anumite răspunsuri pentru a reduce costurile la cererile repetitive.
Stocarea securizată a cheilor
În partea de server, baza o reprezintă variabila de mediu, încărcată dintr-un fișier .env care nu este niciodată făcut commit în Git:
# Fișier .env (NU faceți niciodată commit în Git)
XAI_API_KEY=xai-your-secret-key
Adăugați sistematic aceste fișiere în .gitignore:
# .gitignore
.env
.env.local
.env.production
Pentru mediile de producție, un fișier .env plasat pe un server rămâne un proces manual fragil: preferați un manager de secrete dedicat. Opțiuni dovedite includ AWS Secrets Manager sau SSM Parameter Store, Google Secret Manager, Azure Key Vault, HashiCorp Vault, sau Doppler și Infisical pentru structuri mai ușoare. Ceea ce oferă aceste instrumente în plus față de un fișier simplu: rotația automată a cheilor, auditarea accesului – cine a citit care secret și când – și criptarea în repaus. Acestea sunt elemente pe care le puteți prezenta ca atare în timpul unui audit de securitate, în timp ce un fișier text pe o mașină nu dovedește nimic.
Ce trebuie făcut dacă cheia este compromisă
Dacă suspectați că o cheie a fost expusă, ordinea operațiunilor contează la fel de mult ca și operațiunile în sine. Revocați cheia în consola xAI (console.x.ai) înainte de orice altceva: fiecare minut în care cheia compromisă rămâne activă este un minut de posibilă exploatare, iar continuitatea serviciului se gestionează după, nu înainte. Apoi generați o nouă cheie și actualizați backend-urile pentru a restabili serviciul.
Incidentul nu este încă închis. Auditați utilizarea căutând apeluri API suspecte în istoricul de facturare – un vârf într-o fereastră de timp neobișnuită, utilizare atribuită unui model pe care nu îl folosiți. Identificați sursa scurgerii, altfel noua cheie va urma aceeași cale ca cea veche. Terminați prin scanarea codului cu instrumente precum gitleaks sau truffleHog, care traversează și istoricul Git și dezvăluie adesea alte secrete uitate de mult timp.
Puncte cheie
- O cheie API este o parolă cu acces complet la contul dumneavoastră
- Întotdeauna proxy-ați apelurile API prin backend-ul dumneavoastră
- Variabilele
NEXT_PUBLIC_,VITE_,REACT_APP_sunt publice - Utilizați un manager de secrete în producție
- Dacă o cheie este compromisă, revocați-o imediat și auditați utilizarea