Ihre Nutzer authentifizieren

Wenn jemand den Chat in Ihrer App nutzt, muss Syncanix wissen, wer das ist — damit der Assistent als diese Person und niemand sonst handelt. Sie behalten die Kontrolle über die Identität: Syncanix überprüft ein Token, das Ihr eigenes System ausstellt, statt Ihre Nutzer zu bitten, ein separates Syncanix-Konto anzulegen.

Die vier Authentifizierungsmodi

Wählen Sie einen, je nachdem, wie Ihre App die Authentifizierung bereits handhabt. Sie reichen von wenigen Zeilen Backend-Code bis zu einer vollständig per Proxy geführten Einrichtung, bei der das Widget nie ein Token sieht.

Signiertes Sitzungs-Token (Standard)

Ihr Backend erstellt mit einem gemeinsamen Geheimnis ein kurzlebiges signiertes Token für den angemeldeten Nutzer und übergibt es dem Widget. Das ist der schnellste Weg — ein paar Zeilen Servercode — und passt zu den meisten Apps mit eigenem Login. Erzeugen Sie das gemeinsame Geheimnis auf der Dashboard-Seite „Identitätsföderation“: Es wird genau einmal angezeigt und lässt sich jederzeit rotieren.

Identitätsanbieter-Adapter (empfohlen)

Wenn Sie bereits Auth0, Clerk, Amazon Cognito oder WorkOS verwenden, liest das Widget das Token, das das SDK Ihres Anbieters ohnehin im Browser ausstellt, und Syncanix überprüft es serverseitig anhand der öffentlichen Schlüssel Ihres Anbieters. Kein neues Geheimnis zu verwalten, und die Step-up-Neuverifizierung funktioniert sofort.

OAuth-Token-Austausch

Für Unternehmensumgebungen unterstützt Syncanix den standardisierten Token-Austauschfluss (RFC 8693): Ihr Autorisierungsserver tauscht ein vorhandenes Token gegen ein eng begrenztes, an die Chat-Sitzung gebundenes Token. Ideal, wenn Ihr Sicherheitsteam möchte, dass jedes nachgelagerte Token ausdrücklich ausgestellt und geprüft wird.

Backend-for-Frontend (BFF)

Die am stärksten abgeriegelte Option: ein kleiner Proxy, den Sie betreiben, sitzt zwischen Widget und Syncanix, sodass Tokens den Browser nie erreichen. Wählen Sie diese, wenn Richtlinien jegliches Token im clientseitigen Code verbieten.

Signiertes Sitzungstoken, von Anfang bis Ende

Die schnellste Integration besteht aus einem kleinen Token-Endpunkt in Ihrem Backend plus zwei Zeilen auf Ihrer Seite. Hier die vollständige Einrichtung.

1. 1
   Erzeugen Sie das gemeinsame GeheimnisÖffnen Sie im Dashboard Einstellungen → Identitätsföderation und erzeugen Sie das Sitzungstoken-Geheimnis. Es wird genau einmal angezeigt: Legen Sie es in Ihrem Geheimnisspeicher ab, etwa als SYNCANIX_SESSION_SECRET.
2. 2
   Fügen Sie Ihrem Backend einen Token-Endpunkt hinzuSignieren Sie hinter Ihrem bestehenden Login ein kurzlebiges Token für den aktuellen Nutzer mit dem gemeinsamen Geheimnis.
3. 3
   Übergeben Sie das Token an das WidgetRegistrieren Sie einen Token-Provider, der Ihren Endpunkt abfragt: Das Widget ruft ihn vor jedem Zug auf.

Ein Node-Beispiel mit der jose-Bibliothek (jede JWT-Bibliothek in jeder Sprache funktioniert genauso):

import { SignJWT } from 'jose';

const secret = new TextEncoder().encode(process.env.SYNCANIX_SESSION_SECRET);

app.get('/api/chat-token', requireLogin, async (req, res) => {
  const token = await new SignJWT({ tenant: process.env.SYNCANIX_WORKSPACE_ID })
    .setProtectedHeader({ alg: 'HS256' })
    .setSubject(req.user.id)
    .setAudience('syncanix-tools')
    .setIssuedAt()
    .setExpirationTime('10m')
    .sign(secret);
  res.json({ token });
});

Unabhängig von der Bibliothek muss das Token genau diese Claims tragen:

• aud — die feste Zeichenkette syncanix-tools.
• sub — die stabile Id Ihres Nutzers; in dessen Namen handelt der Assistent.
• tenant — Ihre Arbeitsbereichs-ID (ablesbar aus Ihrer MCP-Verbindungs-URL auf der MCP-Seite des Dashboards).
• exp und iat — Ablauf höchstens 15 Minuten nach Ausstellung; kürzer ist besser.

Verbinden Sie dann das Widget mit Ihrem Endpunkt:

window.syncanix?.setTokenProvider(async () => {
  const res = await fetch('/api/chat-token');
  const { token } = await res.json();
  return token;
});

Welchen sollten Sie wählen?

Sie wollen den schnellsten Start

Verwenden Sie das signierte Sitzungs-Token — ein kleiner Backend-Endpunkt genügt.

Sie nutzen bereits einen gehosteten Identitätsanbieter

Verwenden Sie den Identitätsanbieter-Adapter — er nutzt Vorhandenes weiter und schaltet Step-up frei.

Sie haben strenge Sicherheitsanforderungen

Verwenden Sie OAuth-Token-Austausch oder das BFF, je nachdem, ob Tokens den Browser überhaupt berühren dürfen.

Nächste Schritte