Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Kaitse oma API-võtit: ära kunagi avalda seda kliendipoolses koodis

Õppetund 6 / 12 Värskendatud 28. juuli 2026 Edasijõudnutele
Sellel lehel
  1. API-võti on salasõna
  2. Levinud lekkimise viisid
  3. Puhverserveri arhitektuur: lahendus
  4. Võtmete turvaline hoidmine
  5. Mida teha, kui su võti on kompromiteeritud
  6. Peamised punktid

API-võti on salasõna

Sinu xAI API-võti toimib nagu salasõna, mis annab täieliku juurdepääsu sinu kontole. Igaüks, kes selle kätte saab, võib teha API-päringuid sinu kulul, kasutada sinu mudeleid ja potentsiaalselt ohustada sinu andmeid. Kuidas see erineb tavalisest salasõnast? Varastatud võtit saab kasutada vaikselt: sa ei märka midagi enne, kui arve saabub või kui sinu rahandusmeeskond häiret tõstab. Reegel on lihtne ja absoluutne: ära kunagi avalda API-võtit kliendipoolses koodis.

Levinud lekkimise viisid

Kõige levinum juhtum on võtme otsene lisamine frontend’i JavaScripti:

// OHT – ÄRA KUNAGI tee nii
const response = await fetch("https://api.x.ai/v1/chat/completions", {
  headers: { "Authorization": "Bearer xai-abc123..." }
});

Kui see kood on avaldatud, on see nähtav kõigile, kes kasutavad brauseri arendajatööriistu. Piisab, kui avada vahekaart Network (Võrk), et lugeda võtit puhtal kujul päringu päistes.

Salakavalam viis, mis tekitab vale turvatunde, on frontend’i keskkonnamuutujad. Muutujad, mille eesliide on NEXT_PUBLIC_, VITE_ või REACT_APP_, pakitakse JavaScripti juba kompileerimise käigus ja on seega avalikud. Arendaja arvab, et on “hoidnud võtme koodist eemal”; tegelikult on see lihtsalt koodi sisse kompileeritud:

# OHT – see muutuja satub paketti
NEXT_PUBLIC_XAI_API_KEY=xai-abc123...

Git-hoidlad on kolmas klassikaline lekkimise koht. Isegi kustutatud commit jääb Giti ajalukku: kui oled võtme kogemata commitinud, ei piisa ajaloo ümberkirjutamisest, sest kloonid ja harud võivad selle alles hoida. Loeda see kompromiteerituks ja tühistada võti. Lõpuks lekivad võtmed ka kaudsete radade kaudu, mida on raskem ette kujutada, kuid mis on väga levinud: rakenduse logid, mis salvestavad täielikud päised, kasutajale kuvatavad veateated või jälgimistööriistad, mis püüavad kinni väljuvaid päringuid.

Puhverserveri arhitektuur: lahendus

Ainus turvaline lähenemine on suunata kõik päringud läbi oma taustasüsteemi (backend):

Klient (brauser/mobiil)
    ↓ päring ilma API-võtmeta
Sinu taustasüsteem (server)
    ↓ lisab API-võtme (keskkonnamuutuja)
xAI API
    ↓ vastus
Sinu taustasüsteem
    ↓ edastab vastuse (vajadusel filtreerituna)
Klient

Siin on minimaalne puhverserver Pythonis:

# Pythoni taustasüsteem (Flask)
import os
from flask import Flask, request, jsonify
import requests

app = Flask(__name__)
XAI_KEY = os.environ["XAI_API_KEY"]  # Ainult serveripoolne muutuja

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

Lisaks võtme kaitsmisele – mida klienti kunagi ei edastata – annab puhverserver sulle kontrollpunkti, mida otsepäringud võimaldada ei saa. Saad filtreerida päringuid: kiiruse piiramine, et takistada kliendil sinu kvooti tühjendamast, sisendi valideerimine, sisu moderatsioon. Sa kontrollid, millised mudelid on ligipääsetavad, takistades kaaperdatud kliendil kutsuda kallist mudelit ja tekitada ootamatuid kulusid. Saad logida päringuid auditeerimiseks – mis on vastavusjuhi jaoks keskne vajadus. Ja saad vahemällu salvestada teatud vastuseid, et vähendada korduvate päringute kulusid.

Võtmete turvaline hoidmine

Serveripoolses osas on baastase keskkonnamuutuja, mis laaditakse .env failist, mida mitte kunagi Gitti ei commitita:

# .env fail (MITTE KUNAGI Gitti ei commitita)
XAI_API_KEY=xai-your-secret-key

Lisa need failid süstemaatiliselt oma .gitignore faili:

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

Tootmiskeskkondades on serverile paigutatud .env fail endiselt habras manuaalne protsess: eelista spetsiaalset saladuste haldurit. Tõestatud valikute hulka kuuluvad AWS Secrets Manager või SSM Parameter Store, Google Secret Manager, Azure Key Vault, HashiCorp Vault või kergemate struktuuride jaoks Doppler ja Infisical. Mida need tööriistad pakuvad võrreldes lihtsa tekstifailiga: automaatne võtmete pööramine, juurdepääsu auditeerimine – kes millist saladust ja millal luges – ning puhkeolekus krüptimine. Need on elemendid, mida saad turvaauditil esitada sellisena, nagu need on, samas kui tekstifail masinal ei tõesta midagi.

Mida teha, kui su võti on kompromiteeritud

Kui kahtlustad, et võti on lekkinud, on toimingute järjekord sama oluline kui toimingud ise. Tühista võti xAI konsoolis (console.x.ai) enne kõike muud: iga minut, mille jooksul kompromiteeritud võti on aktiivne, on minut võimalikku kuritarvitamist, ja teenuse järjepidevuse taastamine tuleb pärast, mitte enne. Seejärel genereeri uus võti ja uuenda oma taustasüsteeme teenuse taastamiseks.

Intsident pole sellega veel lõppenud. Auditeeri kasutust, otsides kahtlasi API-päringuid oma arveldusajaloost – hüpe ebatavalisel ajal, kasutus, mis on omistatud mudelile, mida sa ei kasuta. Tuvasta lekke allikas, vastasel juhul leiab uus võti sama tee kui vana. Lõpeta oma koodi skaneerimisega tööriistadega nagu gitleaks või truffleHog, mis läbivad ka Giti ajaloo ja paljastavad sageli teisi ammu unustatud saladusi.

Peamised punktid

  • API-võti on salasõna, mis annab täieliku juurdepääsu sinu kontole
  • Alati suuna API-päringud läbi oma taustasüsteemi
  • Muutujad NEXT_PUBLIC_, VITE_, REACT_APP_ on avalikud
  • Kasuta tootmiskeskkonnas saladuste haldurit
  • Kui võti on kompromiteeritud, tühista see viivitamatult ja auditeeri kasutust