Automatische Anmeldung

Shayan TaslimAktualisiert

Mit der automatischen Anmeldung kann UserJot die Sitzung eines angemeldeten Nutzers aus deinem Produkt auf dein öffentliches Feedback-Board, deine Roadmap, deinen Changelog, dein Hilfe-Center und deine Inline-Einbettungen übertragen – ohne dass eine zweite Anmeldeaufforderung erscheint.

Das Widget kann Nutzer selbstständig identifizieren. Die automatische Anmeldung ist die Workspace-Einstellung, mit der diese Identität Nutzer auf deinen öffentlichen Seiten, in deinen Inline-Einbettungen und im Swift SDK anmeldet.

Automatische Anmeldung aktivieren

  1. Öffne Einstellungen → Anmeldung.

  2. Aktiviere unter Authentifizierung die Option Automatische Anmeldung.

  3. Aktiviere für serverseitig verifizierte Sitzungen außerdem Signierte Tokens erforderlich (wird angezeigt, sobald die automatische Anmeldung aktiviert ist).

Die automatische Anmeldung erfordert den Starter- oder Professional-Tarif. Im Free-Tarif ist der Schalter sichtbar, aber gesperrt.

Was die Einstellung „Signierte Tokens erforderlich“ bewirkt

Ein einfacher uj.identify-Aufruf wird im Browser ausgeführt und kann von Besuchern bearbeitet werden. Wenn Signierte Tokens erforderlich aktiviert ist, lehnt UserJot unsignierte identify-Aufrufe ab, verlangt, dass Unternehmensmitgliedschaften im signierten Token enthalten sind (unsignierte clientseitige companies werden ignoriert und mit einer UNSIGNED_COMPANY_IGNORED-Warnung versehen) und akzeptiert nur Identitäten, die auf Ihrem Server mit einem HS256-JWT signiert wurden (oder mit einer HMAC-SHA256-Signatur im Swift SDK). Beispiele für die serverseitige Implementierung finden Sie unter Signierte Identität.

So funktioniert es

  1. Aktiviere die automatische Anmeldung unter Einstellungen → Anmeldung.

  2. Installiere das Widget in deinem Produkt.

  3. Rufen Sie uj.identify(...) auf, sobald die Sitzung Ihres Nutzers geladen ist (und übergeben Sie bei Bedarf ein signiertes token). Die Übergabe eines email verknüpft den Nutzer nur dann mit einem bestehenden UserJot-Konto, wenn die E-Mail-Adresse dieses Kontos bestätigt wurde.

  4. Verlinke aus deiner App auf deine öffentliche UserJot-URL (entweder auf deine userjot.com-Adresse oder deine eigene Domain).

HTML
<a href="https://feedback.example.com/">Give feedback</a>
<a href="https://feedback.example.com/roadmap">Roadmap</a>
<a href="https://feedback.example.com/updates">Updates</a>

Das SDK fügt die Sitzung automatisch hinzu, wenn Nutzer Links zu deiner Projektdomain folgen. Du musst keine Tokens an URLs anhängen. Bei Inline-Einbettungen erfolgt derselbe Austausch automatisch, sobald uj.identify ausgeführt wurde.

JavaScript
if (user) {
  uj.identify({ token: user.userJotToken });
} else {
  uj.logout();
}

Einschränkungen

  • Nicht für Workspace-Admins oder -Inhaber auf öffentlichen Boards. Die automatische Anmeldung meldet Workspace-Admins oder -Inhaber nicht bei öffentlichen Boards an (testen Sie die automatische Board-Anmeldung immer mit einem regulären Kundenkonto; Teammitglieder melden sich direkt mit ihrem UserJot-Konto oder über eine SSO-Weiterleitung bei öffentlichen Boards an). Im In-App-Widget funktioniert ein signiertes uj.identify-Token auch für Admins und Inhaber. Dabei werden traits und companies synchronisiert, während der im Dashboard verwaltete Name, Avatar und die E-Mail-Adresse unverändert bleiben.

  • Unabhängig von Single Sign-on. Die automatische Anmeldung überträgt Widget-Sitzungen aus deiner App auf öffentliche Seiten. Bei Single Sign-on wird die Schaltfläche Anmelden des Boards hingegen durch eine Weiterleitung zu deiner eigenen Anmeldeseite ersetzt.

  • Der strikte Modus verweigert den Zugriff im Fehlerfall. Wenn Signierte Tokens erforderlich aktiviert ist, führt ein fehlendes oder ungültiges Token dazu, dass uj.identify mit IDENTIFY_FAILED abgelehnt wird und der Besucher abgemeldet bleibt.

Fehlerbehebung

Der Nutzer wird weiterhin zur Anmeldung aufgefordert

  • Vergewissere dich, dass die automatische Anmeldung unter Einstellungen → Anmeldung aktiviert ist.

  • Vergewissere dich, dass das Widget-SDK auf der Seite mit dem Link geladen ist und uj.identify ausgeführt wurde, bevor du auf den Link klickst.

  • Vergewissere dich, dass der Link genau auf deine userjot.com-Subdomain oder eigene Domain verweist.

  • Vergewissern Sie sich, dass Sie die automatische Anmeldung für öffentliche Boards nicht mit der E-Mail-Adresse eines Workspace-Admins oder -Inhabers testen.

Signierte Tokens sind erforderlich, aber die Anmeldung schlägt weiterhin fehl

  • Vergewissere dich, dass uj.identify ein mit HS256 und deinem aktuellen Projektschlüssel signiertes token erhält.

  • Vergewissere dich, dass iss deiner Projekt-ID entspricht, aud gleich userjot ist und sowohl iat als auch exp Unix-Zeitstempel in Sekunden mit exp - iat <= 3600 sind (maximale Gültigkeitsdauer: 1 Stunde).

  • Prüfe das von uj.identify zurückgegebene Promise auf IDENTIFY_FAILED.

Nächste Schritte

Hat das Ihre Frage beantwortet?