Automatisch inloggen

Shayan TaslimBijgewerkt:

Met automatisch inloggen kan UserJot de sessie van een aangemelde gebruiker vanuit je product meenemen naar je openbare feedbackbord, roadmap, changelog, Help Center en inline insluitingen, zonder dat de gebruiker opnieuw hoeft in te loggen.

De widget kan gebruikers zelf identificeren; met de workspace-instelling Automatisch inloggen kunnen gebruikers met die identiteit worden aangemeld op je openbare pagina's, inline insluitingen en de Swift SDK.

Automatisch inloggen inschakelen

  1. Ga naar Instellingen → Inloggen.

  2. Schakel onder Authenticatie de optie Automatisch inloggen in.

  3. Schakel voor sessies die op de server worden geverifieerd ook Ondertekende tokens vereisen in (deze optie verschijnt zodra Automatisch inloggen is ingeschakeld).

Automatisch inloggen vereist het Starter- of Professional-abonnement. Bij het Free-abonnement is de schakelaar zichtbaar, maar vergrendeld.

Wat de instelling Ondertekende tokens vereisen doet

Een gewone uj.identify-aanroep wordt uitgevoerd in de browser en kan door een bezoeker worden bewerkt. Als Ondertekende tokens vereisen is ingeschakeld, weigert UserJot niet-ondertekende identify-aanroepen, vereist het dat bedrijfslidmaatschappen in de ondertekende token zijn opgenomen (niet-ondertekende client-side companies worden genegeerd met een UNSIGNED_COMPANY_IGNORED-waarschuwing) en accepteert het alleen identiteiten die op je server zijn ondertekend met een HS256-JWT (of een HMAC-SHA256-handtekening in de Swift SDK). Bekijk Ondertekende identiteit voor voorbeelden aan de serverkant.

Hoe het werkt

  1. Schakel Automatisch inloggen in via Instellingen → Inloggen.

  2. Installeer de widget in je product.

  3. Roep uj.identify(...) aan zodra je gebruikerssessie is geladen (geef een ondertekende token door als dat vereist is). Het doorgeven van een email koppelt de gebruiker alleen aan een bestaand UserJot-account als het e-mailadres van dat account is bevestigd.

  4. Maak vanuit je app een link naar je openbare UserJot-URL (je userjot.com-adres of je aangepaste domein).

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>

De SDK voegt de sessie automatisch toe wanneer gebruikers links naar het domein van je project volgen; je hoeft zelf geen tokens aan URL's toe te voegen. Inline insluitingen gebruiken dezelfde uitwisseling automatisch zodra uj.identify is uitgevoerd.

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

Beperkingen

  • Niet voor workspacebeheerders of -eigenaren op openbare borden. Automatisch inloggen meldt workspacebeheerders of -eigenaren niet aan op openbare borden (test automatisch inloggen op een bord altijd met een regulier klantaccount; teamleden melden zich rechtstreeks aan op openbare borden met hun UserJot-account of via een SSO-omleiding). Binnen de in-app-widget werkt een ondertekende uj.identify-token wel voor beheerders en eigenaren. Daarbij worden traits en companies gesynchroniseerd, terwijl hun via het dashboard beheerde naam, avatar en e-mailadres ongewijzigd blijven.

  • Staat los van eenmalige aanmelding. Automatisch inloggen neemt widgetsessies vanuit je app mee naar openbare pagina's; met Eenmalige aanmelding wordt de knop Aanmelden op het bord vervangen door een omleiding naar je eigen inlogpagina.

  • De strikte modus weigert standaard toegang. Als Ondertekende tokens vereisen is ingeschakeld, wordt een aanroep van uj.identify met een ontbrekend of ongeldig token geweigerd met IDENTIFY_FAILED en blijft de bezoeker afgemeld.

Problemen oplossen

De gebruiker krijgt nog steeds een inlogverzoek te zien

  • Controleer of Automatisch inloggen is ingeschakeld via Instellingen → Inloggen.

  • Controleer of de widget-SDK is geladen op de pagina met de link en of uj.identify is uitgevoerd voordat je op de link klikt.

  • Controleer of de link verwijst naar het exacte userjot.com-subdomein of je aangepaste domein.

  • Controleer of je automatisch inloggen op een openbaar bord niet test met het e-mailadres van een workspacebeheerder of -eigenaar.

Ondertekende tokens zijn vereist, maar inloggen mislukt nog steeds

  • Controleer of uj.identify een token ontvangt die is ondertekend met HS256 en je huidige Project secret.

  • Controleer of iss overeenkomt met je Project ID, of aud gelijk is aan userjot, en of zowel iat als exp Unix-tijdstempels in seconden zijn met exp - iat <= 3600 (maximale geldigheidsduur: 1 uur).

  • Controleer de promise die door uj.identify wordt teruggegeven op IDENTIFY_FAILED.

Volgende stappen

Heeft dit je vraag beantwoord?