Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Zavaruj svoj ključ API: nikoli ga ne izpostavi na strani odjemalca

Lekcija 6 od 12 Posodobljeno 28. julij 2026 Napredni
Na tej strani
  1. Ključ API je geslo
  2. Pogosti vektorji izpostavljenosti
  3. Arhitektura posrednika: rešitev
  4. Varno shranjevanje ključev
  5. Kaj storiti, če je tvoj ključ ogrožen
  6. Ključne ugotovitve

Ključ API je geslo

Tvoj ključ API za xAI deluje kot geslo s polnim dostopom do tvojega računa. Vsakdo, ki ga ima, lahko v tvojem imenu izvaja klice API-ja, dostopa do tvojih modelov in potencialno ogrozi tvoje podatke. Kako se razlikuje od običajnega gesla? Ukraden ključ lahko uporabijo tiho: ničesar ne boš opazil, dokler ne prispe račun ali dokler tvoja finančna ekipa ne sproži alarma. Pravilo je preprosto in absolutno: nikoli ne izpostavi ključa API na strani odjemalca.

Pogosti vektorji izpostavljenosti

Najpogostejši primer je neposredna vključitev ključa v JavaScript na sprednji strani:

// NEVARNO - tega nikoli ne stori
const response = await fetch("https://api.x.ai/v1/chat/completions", {
  headers: { "Authorization": "Bearer xai-abc123..." }
});

Ko je koda objavljena, je vidna vsakomur, ki uporablja razvijalska orodja brskalnika. Dovolj je, da odpreš zavihek Omrežje (Network), in ključ lahko prebereš v navadnem besedilu v glavah zahteve.

Bolj zahrbtni vektor, ki daje lažen občutek varnosti, so spremenljivke okolja na sprednji strani. Spremenljivke s predpono NEXT_PUBLIC_, VITE_ ali REACT_APP_ so ob času gradnje vključene v JavaScript in so zato javne. Razvijalec misli, da je „ključ obdržal izven kode”; v resnici je preprosto preveden vanjo:

# NEVARNO - ta spremenljivka bo v paketu
NEXT_PUBLIC_XAI_API_KEY=xai-abc123...

Skladišča Git so tretji klasični vektor. Tudi izbrisana potrditev ostane v zgodovini Gita: če si pomotoma potrdil ključ, prepisovanje zgodovine ne zadošča, saj so ga kloni in razcepi morda ohranili. Štej ga za ogroženega in ga prekliči. Končno, ključi uhajajo tudi po posrednih poteh, ki si jih težje zamisliti, a so zelo pogoste: dnevniki aplikacij, ki beležijo celotne glave, sporočila o napakah, prikazana uporabniku, ali orodja za nadzor, ki zajemajo odhodne zahteve.

Arhitektura posrednika: rešitev

Edini varen pristop je usmeriti vse klice prek tvojega zaledja:

Odjemalec (brskalnik/mobilna naprava)
    ↓ zahteva brez ključa API
Tvoje zaledje (strežnik)
    ↓ doda ključ API (spremenljivka okolja)
API xAI
    ↓ odgovor
Tvoje zaledje
    ↓ posreduje odgovor (po potrebi filtriran)
Odjemalec

Tukaj je minimalističen posrednik v Pythonu:

# Python Backend (Flask)
import os
from flask import Flask, request, jsonify
import requests

app = Flask(__name__)
XAI_KEY = os.environ["XAI_API_KEY"]  # Spremenljivka samo na strani strežnika

@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())

Poleg zaščite ključa – ki nikoli ni poslan odjemalcu – ti posrednik omogoča nadzorno točko, ki jo neposredni klici onemogočajo. Zahteve lahko filtriraš: omejevanje hitrosti za preprečevanje izčrpavanja tvoje kvote s strani odjemalca, validacija vnosa, moderiranje vsebine. Nadzoruješ, kateri modeli so dostopni, s čimer preprečiš, da bi ugrabljen odjemalec poklical drag model in povzročil nepričakovane stroške. Klice lahko beležiš za revizijo – kar je osrednja potreba za vodjo skladnosti. Določene odgovore lahko tudi predpomniš, da zmanjšaš stroške pri ponavljajočih se zahtevah.

Varno shranjevanje ključev

Na strani strežnika je osnova spremenljivka okolja, naložena iz datoteke .env, ki nikoli ni potrjena v Git:

# Datoteka .env (NIKOLI potrjena v Git)
XAI_API_KEY=xai-your-secret-key

Te datoteke sistematično dodaj v svoj .gitignore:

# .gitignore
.env
.env.local
.env.production

Za produkcijska okolja je datoteka .env, postavljena na strežnik, še vedno krhek ročni postopek: raje uporabi namenskega upravitelja skrivnosti. Preizkušene možnosti vključujejo AWS Secrets Manager ali SSM Parameter Store, Google Secret Manager, Azure Key Vault, HashiCorp Vault ali Doppler in Infisical za lažje strukture. Kaj ta orodja ponujajo več kot navadna datoteka: samodejno rotacijo ključev, revizijo dostopa – kdo je kdaj prebral katero skrivnost – in šifriranje v mirovanju. To so elementi, ki jih lahko med varnostno revizijo predložiš takšne, kot so, medtem ko besedilna datoteka na stroju ne dokazuje ničesar.

Kaj storiti, če je tvoj ključ ogrožen

Če sumiš, da je bil ključ razkrit, je vrstni red operacij prav tako pomemben kot same operacije. Ključ prekliči v konzoli xAI (console.x.ai) pred vsem drugim: vsaka minuta, ko ogroženi ključ ostane aktiven, je minuta možne zlorabe, neprekinjenost storitve pa se obravnava kasneje, ne prej. Nato ustvari nov ključ in posodobi svoja zaledja za obnovitev storitve.

Incident še ni zaključen. Opravi revizijo uporabe tako, da v zgodovini obračunov poiščeš sumljive klice API-ja – skok med nenavadnim časovnim oknom, uporabo, pripisano modelu, ki ga ne uporabljaš. Ugotovi vir uhajanja, sicer bo novi ključ sledil isti poti kot stari. Zaključi s pregledom svoje kode z orodji, kot sta gitleaks ali truffleHog, ki prav tako prečkata zgodovino Gita in pogosto razkrijeta druge skrivnosti, pozabljene že zdavnaj.

Ključne ugotovitve

  • Ključ API je geslo s polnim dostopom do tvojega računa
  • Klice API-ja vedno usmeri prek svojega zaledja
  • Spremenljivke NEXT_PUBLIC_, VITE_, REACT_APP_ so javne
  • V produkciji uporabi upravitelja skrivnosti
  • Če je ključ ogrožen, ga takoj prekliči in revidiraj uporabo