Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Ephemeral Tokens für WebSocket-Verbindungen

Lektion 5 von 12 Aktualisiert am 28. Juli 2026 Fortgeschritten
Auf dieser Seite
  1. Das Problem: Authentifizierung eines Clients ohne Preisgabe Ihres Schlüssels
  2. Funktionsweise ephemerer Tokens
  3. Wahl der richtigen Laufzeit
  4. Backend-Implementierung
  5. Kernaussagen

Das Problem: Authentifizierung eines Clients ohne Preisgabe Ihres Schlüssels

Beim Aufbau einer Voice- oder Echtzeit-Anwendung mit der Grok-API müssen Sie eine WebSocket-Verbindung direkt vom Browser oder mobilen Client aus herstellen. Das Routing des Datenverkehrs über Ihren Server führt zu Latenzen, die flüssige Sprachgespräche unmöglich machen. Direkte Verbindungen schaffen jedoch ein Authentifizierungsproblem: Sie dürfen Ihren API-Schlüssel niemals in Client-Code einbinden.

Der Grund ist einfach: Jeder Schlüssel, der in Frontend-JavaScript, einer dekomplierbaren mobilen App oder einem verteilten Binärprogramm eingebettet ist, ist im Moment der Veröffentlichung kompromittiert. Jeder Nutzer kann die Entwicklertools seines Browsers öffnen und ihn lesen. Um dies zu lösen, bietet xAI ephemere Tokens an: temporäre Tokens, die Clients verwenden können, ohne den Hauptschlüssel jemals zu sehen.

600s
Standardlaufzeit
3600s
Maximale Laufzeit
POST
/v1/realtime/client_secrets
Bearer
Temporärer Token

Funktionsweise ephemerer Tokens

Die Architektur folgt einem einzigen Prinzip: Der API-Schlüssel verlässt niemals Ihren Server, und der Client erhält lediglich einen kurzlebigen Token. Der Ablauf ist kurz. Der Client fordert einen Token von Ihrem Backend an, welches POST /v1/realtime/client_secrets mit Ihrem API-Schlüssel aufruft. Dieser Aufruf ist der einzige Ort, an dem der Schlüssel erscheint, und er erfolgt vollständig serverseitig. xAI gibt einen ephemeren Token mit seinem Ablaufdatum zurück, welches Ihr Backend an den Client weiterleitet. Der Client öffnet sodann die WebSocket-Verbindung zu wss://api.x.ai/v1/realtime und präsentiert diesen Token. Der Browser sieht den Hauptschlüssel zu keinem Zeitpunkt; er verarbeitet lediglich einen Token, der von sich aus abläuft.

Der Erstellungsaufruf von Ihrem Backend sieht wie folgt aus:

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}}'

Und die Antwort:

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

Hinsichtlich der Laufzeit stehen Ihnen drei Referenzpunkte zur Verfügung: Es gibt keinen dokumentierten Mindestwert (einige Sekunden sind möglich), der Standardwert beträgt 600 Sekunden (10 Minuten) und das Maximum liegt bei 3600 Sekunden (1 Stunde).

Wahl der richtigen Laufzeit

Die Token-Laufzeit muss Ihrem Anwendungsfall entsprechen, und diese Entscheidung ist eine echte Sicherheitsfrage. Für sporadische Sprachinteraktionen – eine Frage-und-Antwort-Situation, eine Sprachbefehlsabfrage oder Diktierfunktionen – ist ein Zeitfenster von 300 bis 600 Sekunden ausreichend: Die Sitzung wird gut vor dem Ablauf enden. Für anhaltende Sprachgespräche wie Kundensupport, Interviews oder assistierte Meetings sollten Sie 600 bis 1800 Sekunden anpeilen, um eine Unterbrechung mitten im Gespräch zu vermeiden. Längere Arbeitssitzungen – Echtzeit-Transkription, kontinuierliche Sprachüberwachung – können eine Laufzeit von 1800 bis 3600 Sekunden rechtfertigen, verwenden Sie jedoch die maximale Laufzeit mit Vorsicht: Sie erweitert das Ausnutzungszeitfenster, falls der Token gestohlen wird.

Die goldene Regel lässt sich wie folgt zusammenfassen: Wählen Sie stets die kürzeste Laufzeit, die mit Ihrem Anwendungsfall vereinbar ist. Wenn ein Token abgefangen wird, verwandelt eine Zehn-Minuten-Ablaufzeit ein potenziell schwerwiegendes Ereignis in eine geringfügige Störung.

Backend-Implementierung

Hier ist ein Beispiel für einen sicheren Proxy in Node.js:

// Backend-Route - niemals clientseitig ausgeben
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 });
});

Drei Details in diesem Beispiel tragen die gesamte Sicherheit der Einrichtung. Der API-Schlüssel lebt in einer Server-Umgebungsvariablen und niemals im Code. Die Middleware authenticateUser überprüft die Identität des Nutzers, bevor ein Token ausgestellt wird – ohne diese Prüfung könnte jeder Token erhalten und Ihr Kontingent auf Ihre Kosten verbrauchen. Und nur der ephemere Token, niemals der Schlüssel, wird an den Client zurückgegeben.

Einige Fallstricke tauchen regelmäßig in Code-Reviews auf. Der API-Schlüssel ist „nur für den Prototypen” versehentlich in das Frontend gelangt und landet unweigerlich in der Produktion. Der Token wird systematisch mit der maximalen Laufzeit erstellt, aus Bequemlichkeit, obwohl der Anwendungsfall nur ein Viertel davon benötigt. Das Generierungs-Endpunkt wurde ohne Authentifizierungsprüfung belassen und steht somit für jeden offen. Und das Fehlen einer Erneuerungsbehandlung auf Client-Seite führt zu Ablauffehlern mitten in der Sitzung statt zu einer transparenten Neuverbindung: Da die Antwort Ihnen das expires_at liefert, verfügt Ihr Client über alles, was er benötigt, um einen neuen Token vor dem Fristablauf anzufordern, nicht erst danach.

Kernaussagen

  • Ephemere Tokens ermöglichen die WebSocket-Authentifizierung ohne Preisgabe Ihres API-Schlüssels
  • Endpunkt: POST /v1/realtime/client_secrets (nur serverseitiger Aufruf)
  • Konfigurierbare Laufzeit von wenigen Sekunden bis zu einem Maximum von 3600 Sekunden (Standard: 600s)
  • Ihr Backend fungiert als Authentifizierungs-Proxy zwischen Client und xAI
  • Wählen Sie stets die kürzeste Laufzeit, die mit Ihrer Nutzung vereinbar ist