Suojaa API-avaimesi: Älä koskaan paljasta sitä asiakaspuolella
Tällä sivulla
API-avain on salasana
xAI API-avaimesi toimii kuin salasana, jolla on täysi pääsy tilillesi. Kuka tahansa, jolla se on hallussaan, voi tehdä API-kutsuja kustannuksellasi, käyttää mallejasi ja mahdollisesti vaarantaa tietosi. Miten se eroaa tavallisesta salasanasta? Varkauden kohteeksi joutunutta avainta voidaan käyttää hiljaa: et huomaa mitään, ennen kuin lasku saapuu tai talousosastosi hälyttää. Sääntö on yksinkertainen ja ehdoton: älä koskaan paljasta API-avainta asiakaspuolella.
Yleisimmät paljastumisreitit
Yleisin tapaus on avaimen suora sisällyttäminen frontend-JavaScriptiin:
// VAARA - ÄLÄ koskaan tee näin
const response = await fetch("https://api.x.ai/v1/chat/completions", {
headers: { "Authorization": "Bearer xai-abc123..." }
});
Kun tämä koodi on otettu käyttöön, se on näkyvissä kaikille, jotka käyttävät selaimen kehittäjätyökaluja. Riittää, että avaat Network-välilehden lukeaksesi avaimen selväkielisenä pyynnön otsikoista.
Salakavalampi reitti, joka luo väärän turvallisuudentunteen, ovat frontend-ympäristömuuttujat. Muuttujat, joiden etuliite on NEXT_PUBLIC_, VITE_ tai REACT_APP_, niputetaan JavaScriptiin käännösvaiheessa, joten ne ovat julkisia. Kehittäjä luulee “pitäneensä avaimen poissa koodista”, mutta todellisuudessa se on vain käännetty osaksi sitä:
# VAARA - tämä muuttuja päätyy bundleen
NEXT_PUBLIC_XAI_API_KEY=xai-abc123...
Git-tietovarastot ovat kolmas klassinen reitti. Jopa poistettu commit pysyy Git-historiassa: jos olet vahingossa committanut avaimen, historian uudelleenkirjoittaminen ei riitä, koska kloonit ja forkatut versiot ovat voineet säilyttää sen. Pidä avainta vaarantuneena ja mitätöi se. Lopuksi avaimet vuotavat myös epäsuoria reittejä pitkin, joita on vaikeampi kuvitella mutta jotka ovat hyvin yleisiä: sovelluslokit, jotka tallentavat koko otsikot, käyttäjälle näytetyt virheilmoitukset tai valvontatyökalut, jotka kaappaavat lähteviä pyyntöjä.
Välityspalvelinarkkitehtuuri: Ratkaisu
Ainoa turvallinen lähestymistapa on välittää kaikki kutsut backendisi kautta:
Asiakas (selain/mobiili)
↓ pyyntö ilman API-avainta
Oma backend (palvelin)
↓ lisää API-avaimen (ympäristömuuttuja)
xAI API
↓ vastaus
Oma backend
↓ välittää vastauksen (suodatettuna tarvittaessa)
Asiakas
Tässä on minimalistinen välityspalvelin Pythonilla:
# Python Backend (Flask)
import os
from flask import Flask, request, jsonify
import requests
app = Flask(__name__)
XAI_KEY = os.environ["XAI_API_KEY"] # Vain palvelinpuolen muuttuja
@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())
Avaimen suojaamisen lisäksi – sitä ei koskaan lähetetä asiakkaalle – välityspalvelin antaa sinulle valvontapisteen, jota suorat kutsut eivät mahdollista. Voit suodattaa pyyntöjä: rajoittaa nopeutta estääksesi asiakasta tyhjentämästä kiintiötäsi, validoida syötteitä ja moderoida sisältöä. Hallitset, mitkä mallit ovat käytettävissä, estäen kaapatun asiakkaan kutsumasta kallista mallia ja aiheuttamasta odottamattomia kustannuksia. Voit lokittaa kutsut tarkastusta varten – mikä on keskeinen tarve vaatimustenmukaisuudesta vastaavalle. Voit myös välimuistiin tallentaa tiettyjä vastauksia vähentääksesi kustannuksia toistuvissa pyynnöissä.
Avainten turvallinen tallennus
Palvelinpuolella perustaso on ympäristömuuttuja, joka ladataan .env-tiedostosta, jota ei koskaan commitoida Gitiin:
# .env-tiedosto (ÄLÄ koskaan commitoi Gitiin)
XAI_API_KEY=xai-your-secret-key
Lisää nämä tiedostot systemaattisesti .gitignore-tiedostoosi:
# .gitignore
.env
.env.local
.env.production
Tuotantoympäristöissä palvelimelle sijoitettu .env-tiedosto on edelleen hauras manuaalinen prosessi: suosikinna on omistettu salaisuuksien hallintajärjestelmä. Todistettuja vaihtoehtoja ovat AWS Secrets Manager tai SSM Parameter Store, Google Secret Manager, Azure Key Vault, HashiCorp Vault tai kevyempiin rakenteisiin Doppler ja Infisical. Mitä nämä työkalut tarjoavat enemmän kuin pelkkä tekstitiedosto: automaattisen avainten kierron, pääsyn tarkastuksen – kuka luki mitäkin salaista ja milloin – sekä levossa olevan datan salauksen. Nämä ovat elementtejä, jotka voit esittää sellaisinaan tietoturvatarkastuksessa, kun taas koneella oleva tekstitiedosto ei todista mitään.
Mitä tehdä, jos avaimesi vaarantuu
Jos epäilet avaimen paljastuneen, toimintajärjestys on yhtä tärkeä kuin itse toimet. Mitätöi avain xAI-konsolissa (console.x.ai) ennen kaikkea muuta: jokainen minuutti, jonka vaarantunut avain pysyy aktiivisena, on minuutti mahdollista hyväksikäyttöä, ja palvelun jatkuvuus hoidetaan jälkeenpäin, ei ennen. Sen jälkeen luo uusi avain ja päivitä backendisi palvelun palauttamiseksi.
Tapaus ei ole vielä päättynyt. Tarkista käyttö etsimällä epäilyttäviä API-kutsuja laskutushistoriastasi – piikki epätavallisena ajankohtana, käyttö, joka on kohdistettu malliin, jota et käytä. Selvitä vuodon lähde, muuten uusi avain kulkee samaa reittiä kuin vanha. Viimeistele skannaamalla koodisi työkaluilla kuten gitleaks tai truffleHog, jotka käyvät läpi myös Git-historian ja paljastavat usein muita kauan sitten unohdettuja salaisuuksia.
Keskeiset asiat
- API-avain on salasana, jolla on täysi pääsy tilillesi
- Aina välitä API-kutsut backendisi kautta
- Muuttujat
NEXT_PUBLIC_,VITE_,REACT_APP_ovat julkisia - Käytä salaisuuksien hallintajärjestelmää tuotannossa
- Jos avain vaarantuu, mitätöi se välittömästi ja tarkista käyttö