Nutzer identifizieren

Shayan TaslimAktualisiert

Standardmäßig behandelt das Widget Besucher als anonym. Rufen Sie uj.identify auf, um Feedback, Stimmen, Kommentare, Benachrichtigungen und Unterhaltungen dem Konto eines Kunden zuzuordnen.

Einfache Identifizierung

JavaScript
uj.identify({
  user: {
    id: 'user-123',
    email: 'ada@example.com',
    firstName: 'Ada',
    lastName: 'Lovelace',
    avatar: 'https://example.com/avatar.jpg'
  }
});

user.id ist erforderlich. Verwenden Sie eine stabile ID aus Ihrer Datenbank statt einer E-Mail-Adresse oder eines Anzeigenamens, die sich ändern können. email ist optional, wird aber dringend empfohlen, damit UserJot den Nutzer über Boards, die Weiterleitung von E-Mails und Unterhaltungen hinweg zuordnen kann. Wenn Sie eine email übergeben, wird sie nur mit einem bestehenden UserJot-Konto verknüpft, dessen E-Mail-Adresse bestätigt wurde.

Wann identify aufgerufen werden sollte

Rufen Sie uj.identify auf, sobald Ihre App weiß, wer angemeldet ist. Wird der Aufruf mit exakt denselben Daten erneut ausgeführt, solange die Sitzung noch aktiv ist, hat das keine Auswirkungen. Sobald die Sitzung abläuft oder sich ein Feld (einschließlich E-Mail-Adresse oder Merkmalen) ändert, sendet das SDK eine neue Anfrage. Bei Übergabe eines anderen Nutzers wird die Sitzung sofort gewechselt.

Wenn sich der Nutzer von Ihrer App abmeldet, rufen Sie uj.logout() auf:

JavaScript
if (user) {
  uj.identify({
    user: {
      id: user.id,
      email: user.email,
      firstName: user.firstName,
      lastName: user.lastName
    }
  });
} else {
  uj.logout();
}

Eigenschaften hinzufügen

Merkmale sind benutzerdefinierte Attribute, die einem Mitgliederprofil zugeordnet werden und im Dashboard neben den Anfragen und Unterhaltungen des Mitglieds angezeigt werden.

JavaScript
uj.identify({
  user: {
    id: 'user-123',
    email: 'ada@example.com',
    traits: {
      plan: 'pro',
      seats: 12,
      trialing: false
    }
  }
});

Merkmalswerte können Zeichenfolgen, Zahlen, boolesche Werte oder null sein (monthlySpend muss, sofern mitgesendet, eine nicht negative Zahl sein). Reservierte Schlüssel (wie id, email, role oder companies) werden ignoriert und in result.warnings gemeldet. Die vollständige Liste finden Sie in der SDK-Referenz.

Unternehmen hinzufügen

Bei B2B-Produkten können Sie dem Nutzer ein oder mehrere Unternehmen zuordnen:

JavaScript
uj.identify({
  user: { id: 'user-123', email: 'ada@example.com' },
  companies: [
    {
      id: 'acme',
      name: 'ACME Inc.',
      domain: 'acme.com',
      logo: 'https://acme.com/logo.png',
      traits: { plan: 'enterprise', arr: 24000 }
    }
  ]
});

id ist für jedes Unternehmen erforderlich. name, domain, logo (HTTPS-URL) und traits sind optional. Wenn Signierte Tokens erforderlich unter Einstellungen → Anmeldung aktiviert ist, werden Unternehmen, die außerhalb eines signierten JWT übergeben werden, ignoriert und es wird eine UNSIGNED_COMPANY_IGNORED-Warnung ausgegeben.

Was identify zurückgibt

Sobald das SDK-Skript geladen wurde, gibt uj.identify ein Promise zurück:

JavaScript
const result = await uj.identify({
  user: { id: 'user-123', email: 'ada@example.com' }
});

result.viewer;        // the identified user, or null
result.identityTrust; // 'signed' or 'unsigned'
result.warnings;      // fields the server ignored or adjusted

Ratenbegrenzungen und Fehler

  • Ratenbegrenzung und clientseitige Wartezeit: Identify-Anfragen sind auf 30 pro Minute und 300 pro Stunde je IP-Adresse und Workspace begrenzt. Bei Überschreitung des Stundenlimits wird eine 1-stündige Sperre ausgelöst. Nach dem Empfang von HTTP 429 erzwingt das SDK eine lokale Abkühlphase (unter Berücksichtigung von Retry-After, auf einen Zeitraum zwischen 1 Sekunde und 1 Stunde begrenzt; standardmäßig 60 Sekunden), sodass Wiederholungsschleifen lokal fehlschlagen, ohne die API mit Anfragen zu überlasten.

  • Abgelehnte Aufrufe: Wenn der Server einen Identify-Aufruf ablehnt (z. B. wegen eines ungültigen Tokens, aktivierter Option Require signed tokens ohne Token, eines E-Mail-Konflikts, der 409 zurückgibt, oder eines gemäß DSGVO gelöschten Mitglieds, das 403 / member_erased zurückgibt), wird das Promise mit IDENTIFY_FAILED abgelehnt und der Besucher bleibt anonym.

Identität und Konversationen

Wenn Conversations aktiviert ist:

  • Identifizierte Nutzer überspringen die Abfrage der Besucherdaten und erhalten Antworten des Teams an die E-Mail-Adresse ihres Kontos.

  • Anonyme Besucher erhalten browsergebundene Gastunterhaltungen. Je nach Widget-Einstellungen können dabei optional Kontaktdaten erfasst werden.

Im Widget können anonyme Besucher Feedback abgeben und auf Updates reagieren. Für das Hochvoten von Feedback, das Kommentieren und das Öffnen der Benachrichtigungsglocke muss jedoch uj.identify aufgerufen werden. Zum Bearbeiten oder Löschen eigener Beiträge und Kommentare im Widget ist eine signierte Identität erforderlich.

Wenn unter Einstellungen → Anmeldung die Option Require signed tokens aktiviert ist, werden nicht signierte Aufrufe von identify mit HTTP 403 abgelehnt und der Besucher bleibt anonym. Verwenden Sie Signierte Identität, um Konten serverseitig zu verifizieren.

Welche Authentifizierungsmethode sollte ich verwenden?

Methode

Einsatzbereich

Sicherheit

Tarif

Anleitung

Nicht signiert (uj.identify)

In-App-Widget

Vom Browser bereitgestellt (kann gefälscht werden)

Alle Tarife

Dieser Artikel

Signierte Identität (HS256-JWT)

In-App-Widget (+ Links zum öffentlichen Portal, wenn die automatische Anmeldung aktiviert ist)

Serverseitig verifiziertes JWT

Starter & Professional (für den strikten Modus)

Signierte Identität

Automatische Anmeldung

Öffentliches Portal & Inline-Einbettungen (?token=...)

Serverseitig verifiziertes HS256-JWT

Starter & Professional

Automatische Anmeldung

Single Sign-on (SSO)

Anmeldeweiterleitung zum öffentlichen Portal

Serverseitig verifiziertes HS256-JWT

Professional

Single Sign-on

Swift SDK (identify)

iOS- und macOS-Apps

Nicht signiert oder HMAC-SHA256-Signatur

Starter & Professional (erfordert automatische Anmeldung)

Authentifizierung mit dem Swift SDK

Nächster Schritt

Verifizieren Sie Nutzeridentitäten in Ihrem Backend mit Signierte Identität.

Hat das Ihre Frage beantwortet?