Apsaugokite savo API raktą: niekada neatskleiskite jo kliento pusėje
Šiame puslapyje
API raktas yra slaptažodis
Tavo xAI API raktas veikia kaip slaptažodis, suteikiantis visišką prieigą prie tavo paskyros. Bet kas, jį turintis, gali vykdyti API užklausas tavo lėšomis, pasiekti tavo modelius ir potencialiai pažeisti tavo duomenis. Kuo jis skiriasi nuo įprasto slaptažodžio? Pavogtas raktas gali būti naudojamas tyliai: nieko nepastebėsi, kol neatkeliaus sąskaita arba kol tavo finansų komanda neiškvies pavojaus signalo. Taisyklė paprasta ir absoliuti: niekada neatskleisk API rakto kliento pusėje.
Dažniausi atskleidimo būdai
Dažniausias atvejis – tiesioginis rakto įtraukimas į „frontend“ JavaScript kodą:
// PAVOJUS – NIEKADA taip nedaryk
const response = await fetch("https://api.x.ai/v1/chat/completions", {
headers: { "Authorization": "Bearer xai-abc123..." }
});
Įdiegus šį kodą, jis matomas bet kam, naudojančiam naršyklės kūrėjo įrankius. Tereikia atidaryti skirtuką „Network“ (Tinklas) ir perskaityti raktą grynuoju tekstu užklausos antraštėse.
Klastingesnis būdas, sukuriantis klaidingą saugumo jausmą – „frontend“ aplinkos kintamieji. Kintamieji, prasidedantys NEXT_PUBLIC_, VITE_ arba REACT_APP_, surišami į JavaScript kodą kūrimo metu, todėl tampa vieši. Kūrėjas mano „paslėpęs raktą nuo kodo“, tačiau iš tikrųjų jis tiesiog įkompiliuojamas į jį:
# PAVOJUS – šis kintamasis atsidurs surištame kode
NEXT_PUBLIC_XAI_API_KEY=xai-abc123...
„Git“ saugyklos yra trečiasis klasikinis būdas. Net ir ištrintas įsipareigojimas (commit) lieka „Git“ istorijoje: jei klaidingai įkėlei raktą, istorijos perrašymo nepakanka, nes jo kopijos ir šakos galėjo jį išsaugoti. Laikyk jį pažeistu ir anuliuok. Galiausiai, raktai nuteka ir netiesioginiais keliais, kuriuos sunkiau įsivaizduoti, tačiau jie labai dažni: programos žurnalai, fiksuojančios visas antraštes, vartotojui rodomi klaidų pranešimai arba stebėsenos įrankiai, fiksuoja išeinančias užklausas.
Proxy architektūra: sprendimas
Vienintelis saugus būdas – visas užklausas nukreipti per savo serverinę dalį (backend):
Klientas (naršyklė/mobilioji)
↓ užklausa be API rakto
Tavo serverinė dalis
↓ pridėja API raktą (aplinkos kintamasis)
xAI API
↓ atsakymas
Tavo serverinė dalis
↓ persiunčia atsakymą (prireikus filtruotą)
Klientas
Štai minimalus proxy pavyzdys naudojant „Python“:
# Python Backend (Flask)
import os
from flask import Flask, request, jsonify
import requests
app = Flask(__name__)
XAI_KEY = os.environ["XAI_API_KEY"] # Tik serverio pusės kintamasis
@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())
Be rakto apsaugos – kuris niekada nesiunčiamas klientui – proxy suteikia kontrolės tašką, kurio tiesioginės užklausos užtikrinti negali. Gali filtruoti užklausas: riboti greitį (rate limiting), kad klientas neišnaudotų tavo kvotos, tikrinti įvestį, moderuoti turinį. Tu kontroliuoji, kurie modeliai yra pasiekiami, neleidžiant perimtam klientui išsikviesti brangaus modelio ir sukurti netikėtų išlaidų. Gali registruoti užklausas audito tikslais – tai esminis reikalavimas atitikties vadovui. Be to, gali talpykloje saugoti tam tikrus atsakymus, kad sumažintum išlaidas pasikartojančioms užklausoms.
Saugus raktų saugojimas
Serverio pusėje bazinis lygmuo yra aplinkos kintamasis, įkeliamas iš .env failo, kuris niekada neįkeliamas į „Git“:
# .env failas (NIKADA neįkeliamas į Git)
XAI_API_KEY=xai-your-secret-key
Sistemingai įtrauk šiuos failus į savo .gitignore:
# .gitignore
.env
.env.local
.env.production
Gamybinėse aplinkose .env failas, paliktas serveryje, lieka trapus rankinis procesas: geriau naudoti specializuotą paslapčių valdyklę. Patikrinti variantai: „AWS Secrets Manager“ arba „SSM Parameter Store“, „Google Secret Manager“, „Azure Key Vault“, „HashiCorp Vault“ arba lengvesnėms struktūroms – „Doppler“ ir „Infisical“. Ką šie įrankiai suteikia daugiau nei paprastas failas: automatinį raktų atnaujinimą, prieigos auditą (kas, kada ir kokią paslaptį skaitė) bei duomenų šifravimą ramybės būsenoje. Tai elementai, kuriuos saugumo audito metu gali pateikti kaip yra, tuo tarpu tekstinis failas kompiuteryje nieko neįrodo.
Ką daryti, jei tavo raktas pažeistas
Jei įtari, kad raktas buvo atskleistas, veiksmų eiliškumas yra toks pat svarbus kaip ir patys veiksmai. Prieš viską anuliuok raktą xAI konsolėje (console.x.ai): kiekviena minutė, kai pažeistas raktas lieka aktyvus, yra galimo išnaudojimo minutė, o paslaugos tęstinumas tvarkomas po to, o ne prieš tai. Tada sugeneruok naują raktą ir atnaujink savo serverines dalis, kad atkurtum paslaugą.
Incidentas dar nėra baigtas. Atlik naudojimo auditą, ieškodamas įtartinų API užklausų savo sąskaitų istorijoje: šuolio neįprastu laiku arba naudojimo, priskirto modeliui, kurio nenaudoji. Nustatyk nutekėjimo šaltinį, kitaip naujas raktas nueis tuo pačiu keliu kaip ir senasis. Pabaigai nuskaityk savo kodą tokiais įrankiais kaip gitleaks arba truffleHog, kurie taip pat peržiūri „Git“ istoriją ir dažnai atskleidžia kitas seniai pamirštas paslaptis.
Svarbiausi punktai
- API raktas yra slaptažodis, suteikiantis visišką prieigą prie tavo paskyros
- Visada nukreipk API užklausas per savo serverinę dalį
- Kintamieji
NEXT_PUBLIC_,VITE_,REACT_APP_yra vieši - Gamyboje naudok paslapčių valdyklę
- Jei raktas pažeistas, nedelsiant jį anuliuok ir patikrink naudojimą