Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Ephemere tokens til WebSocket-forbindelser

Lektion 5 af 12 Opdateret 28. juli 2026 Avanceret
På denne side
  1. Problemet: Godkendelse af en klient uden at afsløre din nøgle
  2. Sådan fungerer ephemere tokens
  3. Valg af den rette varighed
  4. Backend-implementering
  5. Vigtige pointer

Problemet: Godkendelse af en klient uden at afsløre din nøgle

Når du bygger en tale- eller realtidsapp med Grok API, skal du etablere en WebSocket-forbindelse direkte fra browseren eller mobilklienten. Hvis du sender trafikken gennem din egen server, tilføjer du latency, der ødelægger flydende talesamtaler. Men direkte forbindelser skaber et godkendelsesproblem: Du må aldrig inkludere din API-nøgle i klient-side kode.

Årsagen er enkel: Enhver nøgle, der er indlejret i frontend JavaScript, en mobilapp, der kan dekompileres, eller en distribueret binær fil, er kompromitteret i det øjeblik, du publicerer den. Enhver bruger kan åbne deres browserens udviklingsværktøjer og læse den. For at løse dette tilbyder xAI ephemere tokens: midlertidige tokens, som klienter kan bruge uden nogensinde at se hovednøglen.

600s
Standardvarighed
3600s
Maksimal varighed
POST
/v1/realtime/client_secrets
Bearer
Midlertidigt token

Sådan fungerer ephemere tokens

Arkitekturen følger ét princip: API-nøglen forlader aldrig din server, og klienten modtager kun et kortlivet token. Forløbet er kort. Klienten anmoder om et token fra din backend, som kalder POST /v1/realtime/client_secrets med din API-nøgle. Dette kald er det eneste sted, nøglen optræder, og det sker udelukkende på serveren. xAI returnerer et ephemeret token med dets udløbsdato, som din backend sender videre til klienten. Klienten åbner derefter WebSocket-forbindelsen til wss://api.x.ai/v1/realtime og præsenterer dette token. På intet tidspunkt ser browseren hovednøglen; den håndterer et token, der udløber af sig selv.

Oprettelseskaldet fra din backend ser sådan ud:

curl -X POST https://api.x.ai/v1/realtime/client_secrets \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"expires_after": {"seconds": 600}}'

Og svaret:

{
  "value": "Bearer eyJhbGciOiJSUzI1NiIs...",
  "expires_at": 1712001200
}

Med hensyn til varighed har du tre referencepunkter: Der er ingen dokumenteret nedre grænse (få sekunder er mulige), standardværdien er 600 sekunder (10 minutter), og maksimum er 3600 sekunder (1 time).

Valg af den rette varighed

Token-varigheden skal matche dit brugstilfælde, og dette valg er en reel sikkerhedsbeslutning. Til lejlighedsvise taleinteraktioner – et spørgsmål-svar, en talekommando, diktering – er et vindue på 300 til 600 sekunder rigeligt: sessionen vil slutte længe før udløb. Til vedvarende talesamtaler som kundesupport, et interview eller et assisteret møde bør du sigte efter 600 til 1800 sekunder for at undgå at blive afbrudt midt i samtalen. Langvarige arbejdssessioner – realtids-transskription, løbende taleovervågning – kan berettige 1800 til 3600 sekunder, men brug maksimal varighed med forsigtighed: det udvider udnyttelsesvinduet, hvis tokenet stjæles.

Den gyldne regel kan opsummeres sådan: Vælg altid den korteste varighed, der er kompatibel med dit brugstilfælde. Hvis et token opsnappes, gør en udløbstid på ti minutter en potentielt alvorlig hændelse til en mindre gener.

Backend-implementering

Her er et eksempel på en sikker proxy i Node.js:

// Backend-rute - MÅ IKKE eksponeres på klient-siden
app.post("/api/realtime-token", authenticateUser, async (req, res) => {
  const response = await fetch(
    "https://api.x.ai/v1/realtime/client_secrets",
    {
      method: "POST",
      headers: {
        "Authorization": `Bearer ${process.env.XAI_API_KEY}`,
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        expires_after: { seconds: 600 }
      })
    }
  );

  const token = await response.json();
  res.json({ token: token.value, expires_at: token.expires_at });
});

Tre detaljer i dette eksempel bærer hele sikkerheden i opsætningen. API-nøglen lever i en server-miljøvariabel, aldrig i koden. authenticateUser-middlewaret verificerer brugerens identitet, før der udstedes et token – uden det kunne hvem som helst skaffe tokens og bruge din kvote på din regning. Og kun det ephemere token, aldrig nøglen, returneres til klienten.

Nogle faldgruber dukker regelmæssigt op i kodegennemgange. API-nøglen sniger sig ind i frontend „kun til prototypen” og ender uundgåeligt i produktion. Tokenet oprettes systematisk med maksimal varighed af bekvemmelighedshensyn, når brugstilfældet kun kræver en fjerdedel af det. Genererings-endpointet efterlades uden verifikation af godkendelse, åbent for alle. Og manglen på håndtering af fornyelse på klientsiden, hvilket producerer udløbsfejl midt i sessionen i stedet for en gennemsigtig genforbindelse: Da svaret giver dig expires_at, har din klient alt, hvad den behøver for at anmode om et nyt token før fristen i stedet for efter.

Vigtige pointer

  • Ephemere tokens muliggør WebSocket-godkendelse uden at afsløre din API-nøgle
  • Endpoint: POST /v1/realtime/client_secrets (kun server-side kald)
  • Konfigurerbar varighed fra få sekunder op til maksimalt 3600 sekunder (standard: 600s)
  • Din backend fungerer som en godkendelsesproxy mellem klienten og xAI
  • Vælg altid den korteste varighed, der er kompatibel med din brug