Zaštiti svoj API ključ: nikada ga ne izlaži na strani klijenta
Na ovoj stranici
API ključ je lozinka
Tvoj xAI API ključ djeluje poput lozinke s punim pristupom tvojem računu. Svatko tko ga posjeduje može vršiti API pozive o tvom trošku, pristupati tvojim modelima i potencijalno ugroziti tvoje podatke. Kako se razlikuje od standardne lozinke? Ukradeni ključ može se koristiti tiho: nećeš ništa primijetiti dok ne stigne račun ili dok tvoja financijska ekipa ne podigne uzbunu. Pravilo je jednostavno i apsolutno: nikada ne izlaži API ključ na strani klijenta.
Uobičajeni vektori izlaganja
Najčešći slučaj je izravno uključivanje ključa u frontend JavaScript:
// OPASNOST - NIKADA ovo ne radi
const response = await fetch("https://api.x.ai/v1/chat/completions", {
headers: { "Authorization": "Bearer xai-abc123..." }
});
Nakon implementacije, ovaj je kod vidljiv svakome tko koristi razvojne alate preglednika. Dovoljno je otvoriti karticu Mreža (Network) da bi se ključ pročitao u običnom tekstu unutar zaglavlja zahtjeva.
Podmukliji vektor, jer stvara lažan osjećaj sigurnosti, su varijable okruženja na frontendu. Varijable s prefiksom NEXT_PUBLIC_, VITE_ ili REACT_APP_ pakiraju se u JavaScript tijekom izgradnje i stoga su javne. Programer misli da je „ključ zadržao izvan koda“; u stvarnosti, on je jednostavno kompajliran u njega:
# OPASNOST - ova varijabla bit će u paketu
NEXT_PUBLIC_XAI_API_KEY=xai-abc123...
Git repozitoriji treći su klasični vektor. Čak i obrisana commit poruka ostaje u Git povijesti: ako si greškom commitao ključ, prepisivanje povijesti nije dovoljno jer su klonovi i forkovi mogli zadržati taj podatak. Smatraj ga kompromitiranim i opozovi ga. Konačno, ključevi curi i kroz neizravne putove, teže zamislive, ali vrlo česte: zapisnici aplikacija (logovi) koji prate cijela zaglavlja, poruke o pogreškama prikazane korisniku ili alati za nadzor koji hvataju odlazne zahtjeve.
Arhitektura proxyja: Rješenje
Jedini siguran pristup je proxyiranje svih poziva kroz tvoj backend:
Klijent (preglednik/mobilni)
↓ zahtjev bez API ključa
Tvoj Backend (poslužitelj)
↓ dodaje API ključ (varijabla okruženja)
xAI API
↓ odgovor
Tvoj Backend
↓ prosljeđuje odgovor (filtriran po potrebi)
Klijent
Evo minimalističkog proxyja u Pythonu:
# Python Backend (Flask)
import os
from flask import Flask, request, jsonify
import requests
app = Flask(__name__)
XAI_KEY = os.environ["XAI_API_KEY"] # Samo varijabla na strani poslužitelja
@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())
Osim zaštite ključa – koji se nikada ne prenosi klijentu – proxy ti daje kontrolnu točku koju izravni pozivi onemogućuju. Možeš filtrirati zahtjeve: ograničenje stope (rate limiting) kako bi spriječio da klijent isprazni tvoju kvotu, validacija unosa, moderacija sadržaja. Kontroliraš koji su modeli dostupni, sprječavajući da oteti klijent pozove skup model i generira neočekivane troškove. Možeš bilježiti pozive radi revizije – što je središnja potreba za voditelja usklađenosti. Također možeš keširati određene odgovore kako bi smanjio troškove kod ponavljajućih zahtjeva.
Sigurno pohranjivanje ključeva
Na strani poslužitelja, osnova je varijabla okruženja, učitana iz .env datoteke koja se nikada ne commita u Git:
# .env datoteka (NIKADA se ne commita u Git)
XAI_API_KEY=xai-tvoj-tajni-ključ
Sustavno dodaj ove datoteke u svoj .gitignore:
# .gitignore
.env
.env.local
.env.production
Za produkcijska okruženja, .env datoteka postavljena na poslužitelj ostaje krhak ručni proces: preferiraj namjenskog upravitelja tajnama (secrets manager). Provjerene opcije uključuju AWS Secrets Manager ili SSM Parameter Store, Google Secret Manager, Azure Key Vault, HashiCorp Vault, ili Doppler i Infisical za lakše strukture. Ono što ovi alati pružaju više od obične datoteke: automatska rotacija ključeva, revizija pristupa – tko je čitao koju tajnu i kada – te šifriranje u mirovanju. To su elementi koje možeš predstaviti kakvi jesu tijekom sigurnosne revizije, dok tekstualna datoteka na stroju ne dokazuje ništa.
Što učiniti ako je tvoj ključ kompromitiran
Ako sumnjaš da je ključ otkriven, redoslijed operacija jednako je važan kao i same operacije. Opozovi ključ u xAI konzoli (console.x.ai) prije bilo čega drugog: svaka minuta dok kompromitirani ključ ostaje aktivan minuta je moguće eksploatacije, a kontinuitet usluge rješava se nakon toga, a ne prije. Zatim generiraj novi ključ i ažuriraj svoje backende kako bi obnovio uslugu.
Incident još nije zatvoren. Revidiraj upotrebu traženjem sumnjivih API poziva u svojoj povijesti naplate – skok tijekom neuobičajenog vremenskog okvira, upotreba pripisana modelu koji ne koristiš. Identificiraj izvor curenja, inače će novi ključ slijediti isti put kao i stari. Završi skeniranjem svog koda alatima poput gitleaks ili truffleHog, koji također prolaze kroz Git povijest i često otkrivaju druge tajne zaboravljene davno.
Ključne točke
- API ključ je lozinka s punim pristupom tvojem računu
- Uvijek proxyiraj API pozive kroz svoj backend
- Varijable
NEXT_PUBLIC_,VITE_,REACT_APP_su javne - Koristi upravitelja tajnama u produkciji
- Ako je ključ kompromitiran, odmah ga opozovi i revidiraj upotrebu