Automatische Anmeldung
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
Öffne Einstellungen → Anmeldung.
Aktiviere unter Authentifizierung die Option Automatische Anmeldung.
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
Aktiviere die automatische Anmeldung unter Einstellungen → Anmeldung.
Installiere das Widget in deinem Produkt.
Rufen Sie
uj.identify(...)auf, sobald die Sitzung Ihres Nutzers geladen ist (und übergeben Sie bei Bedarf ein signiertestoken). Die Übergabe einesemailverknüpft den Nutzer nur dann mit einem bestehenden UserJot-Konto, wenn die E-Mail-Adresse dieses Kontos bestätigt wurde.Verlinke aus deiner App auf deine öffentliche UserJot-URL (entweder auf deine
userjot.com-Adresse oder deine eigene Domain).
<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.
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 werdentraitsundcompaniessynchronisiert, 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.identifymitIDENTIFY_FAILEDabgelehnt 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.identifyausgefü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.identifyein mit HS256 und deinem aktuellen Projektschlüssel signiertestokenerhält.Vergewissere dich, dass
issdeiner Projekt-ID entspricht,audgleichuserjotist und sowohliatals auchexpUnix-Zeitstempel in Sekunden mitexp - iat <= 3600sind (maximale Gültigkeitsdauer: 1 Stunde).Prüfe das von
uj.identifyzurückgegebene Promise aufIDENTIFY_FAILED.
Nächste Schritte
Erzeuge serverseitige JWTs unter Signierte Identität.
Vergleiche alle Authentifizierungsoptionen unter Nutzer identifizieren.