Beskyt din API-nøgle: Eksponér den aldrig på klientsiden
På denne side
En API-nøgle er et adgangskode
Din xAI API-nøgle fungerer som et adgangskode med fuld adgang til din konto. Alle, der har den, kan foretage API-kald på din regning, få adgang til dine modeller og potentielt kompromittere dine data. Hvordan adskiller den sig fra et almindeligt adgangskode? En stjålen nøgle kan bruges i stilhed: Du ser ingenting, før regningen lander, eller indtil dit økonomiteam udløser en alarm. Reglen er enkel og absolut: Eksponér aldrig en API-nøgle på klientsiden.
Almindelige eksponeringsveje
Det mest almindelige tilfælde er direkte inkludering af nøglen i frontend-JavaScript:
// FARE - Gør ALDRIG dette
const response = await fetch("https://api.x.ai/v1/chat/completions", {
headers: { "Authorization": "Bearer xai-abc123..." }
});
Når koden er deployet, er den synlig for alle, der bruger browserens udviklingsværktøjer. Du behøver blot at åbne fanen Network for at læse nøglen i klartekst i anmodningsheadere.
En mere snigende vej, fordi den giver en falsk følelse af sikkerhed, er frontend-miljøvariabler. Variabler med præfikset NEXT_PUBLIC_, VITE_ eller REACT_APP_ pakkes ind i JavaScript-koden ved build-tidspunktet og er derfor offentlige. Udvikleren tror, at man har “holdt nøglen ude af koden”; i virkeligheden er den blot kompileret ind i den:
# FARE - denne variabel havner i bundlen
NEXT_PUBLIC_XAI_API_KEY=xai-abc123...
Git-repositorier er den tredje klassiske vej. Selv en slettet commit forbliver i Git-historikken: Hvis du ved en fejl har committet en nøgle, er det ikke nok at omskrive historikken, fordi clones og forks kan have beholdt den. Betragt den som kompromitteret og tilbagekald den. Endelig lækker nøgler også gennem indirekte veje, der er sværere at forestille sig, men meget almindelige: Applikationslogs, der sporer fulde headers, fejlmeddelelser vist til brugeren, eller overvågningsværktøjer, der fanger udgående anmodninger.
Proxy-arkitektur: Løsningen
Den eneste sikre tilgang er at proxy’e alle kald gennem din backend:
Klient (browser/mobil)
↓ anmodning uden API-nøgle
Din Backend (server)
↓ tilføjer API-nøgle (miljøvariabel)
xAI API
↓ svar
Din Backend
↓ videresender svar (filtreret om nødvendigt)
Klient
Her er en minimalistisk proxy i Python:
# Python Backend (Flask)
import os
from flask import Flask, request, jsonify
import requests
app = Flask(__name__)
XAI_KEY = os.environ["XAI_API_KEY"] # Kun server-side variabel
@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())
Udover at beskytte nøglen – som aldrig transmitteres til klienten – giver proxy’en dig et kontrolpunkt, som direkte kald gør umuligt. Du kan filtrere anmodninger: rate limiting for at forhindre, at en klient tømmer din kvote, input-validering og indholdsmoderation. Du styrer, hvilke modeller der er tilgængelige, hvilket forhindrer en kapret klient i at kalde en dyr model og generere uventede omkostninger. Du kan logge kald til revision – et centralt behov for en compliance-ansvarlig. Og du kan cache visse svar for at reducere omkostningerne ved gentagne anmodninger.
Sikker opbevaring af nøgler
På serversiden er baseline miljøvariablen, indlæst fra en .env-fil, som aldrig committes til Git:
# .env-fil (ALDRIG committet til Git)
XAI_API_KEY=xai-din-hemmelige-nøgle
Tilføj systematisk disse filer til din .gitignore:
# .gitignore
.env
.env.local
.env.production
Til produktionsmiljøer er en .env-fil placeret på en server stadig en skrøbelig manuel proces: Foretræk en dedikeret secrets manager. Beviste muligheder inkluderer AWS Secrets Manager eller SSM Parameter Store, Google Secret Manager, Azure Key Vault, HashiCorp Vault eller Doppler og Infisical til lettere strukturer. Hvad disse værktøjer tilbyder ud over en flad fil: automatisk nøglerotation, adgangsovervågning – hvem læste hvilken hemmelighed, hvornår – og kryptering i hviletilstand. Dette er elementer, du kan præsentere som de er under en sikkerhedsrevision, hvorimod en tekstfil på en maskine beviser intet.
Hvad gør du, hvis din nøgle er kompromitteret?
Hvis du har mistanke om, at en nøgle er blevet eksponeret, er rækkefølgen af handlinger lige så vigtig som handlingerne selv. Tilbagekald nøglen i xAI-konsollen (console.x.ai) før alt andet: Hvert minut den kompromitterede nøgle forbliver aktiv, er et minut med mulig udnyttelse, og servicekontinuitet håndteres bagefter, ikke før. Generér derefter en ny nøgle og opdater dine backends for at genoprette servicen.
Incidenten er ikke lukket endnu. Revider brugen ved at kigge efter mistænkelige API-kald i din faktureringshistorik – en top i et usædvanligt tidsvindue, brug tilskrevet en model, du ikke bruger. Identificér kilden til lækagen, ellers vil den nye nøgle følge samme vej som den gamle. Afslut med at scanne din kode med værktøjer som gitleaks eller truffleHog, som også gennemsøger Git-historikken og ofte afslører andre hemmeligheder, der er blevet glemt for længe siden.
Vigtige pointer
- En API-nøgle er et adgangskode med fuld adgang til din konto
- Proxy altid API-kald gennem din backend
- Variablerne
NEXT_PUBLIC_,VITE_,REACT_APP_er offentlige - Brug en secrets manager i produktion
- Hvis en nøgle er kompromitteret, tilbagekald den straks og revider brugen