Connexion automatique

Shayan TaslimMis à jour

La connexion automatique permet à UserJot de transférer la session d’un utilisateur connecté depuis votre produit vers votre tableau de commentaires public, votre feuille de route, votre journal des modifications, votre centre d’aide et vos éléments intégrés dans la page, sans demander une deuxième connexion.

Le widget peut identifier les utilisateurs de manière autonome ; la connexion automatique est le paramètre de l’espace de travail qui permet à cette identité de connecter les utilisateurs à vos pages publiques, à vos éléments intégrés dans la page et au Swift SDK.

Activer la connexion automatique

  1. Ouvrez Paramètres → Connexion.

  2. Sous Authentification, activez Connexion automatique.

  3. Pour les sessions vérifiées par le serveur, activez également Exiger des jetons signés (cette option apparaît une fois la connexion automatique activée).

La connexion automatique nécessite l’offre Starter ou Professional. Avec l’offre Free, l’interrupteur est visible, mais verrouillé.

Fonctionnement de l’option « Exiger des jetons signés »

Un simple appel uj.identify s’exécute dans le navigateur et peut être modifié par un visiteur. Lorsque l’option Exiger des jetons signés est activée, UserJot rejette les appels identify non signés, exige que les appartenances à une entreprise soient incluses dans le jeton signé (et ignore les companies non signés côté client, avec un avertissement UNSIGNED_COMPANY_IGNORED), et n’accepte que les identités signées sur votre serveur à l’aide d’un JWT HS256 (ou d’une signature HMAC-SHA256 dans le SDK Swift). Consultez Identité signée pour des exemples côté serveur.

Fonctionnement

  1. Activez la connexion automatique dans Paramètres → Connexion.

  2. Installez le widget dans votre produit.

  3. Appelez uj.identify(...) une fois la session de votre utilisateur chargée (en transmettant un token signé si nécessaire). La transmission d’un email associe l’utilisateur à un compte UserJot existant uniquement si l’adresse e-mail de ce compte a été confirmée.

  4. Créez un lien depuis votre application vers votre URL publique UserJot (soit votre adresse userjot.com, soit votre domaine personnalisé).

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>

Le SDK joint automatiquement la session lorsque les utilisateurs suivent des liens vers le domaine de votre projet ; vous n’avez pas à ajouter vous-même de jetons aux URL. Les éléments intégrés dans la page utilisent automatiquement le même échange dès que uj.identify est exécuté.

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

Limites

  • Ne concerne pas les administrateurs ni les propriétaires d’espaces de travail sur les tableaux publics. La connexion automatique ne connecte pas les administrateurs ni les propriétaires d’espaces de travail aux tableaux publics (testez toujours la connexion automatique à un tableau avec un compte client standard ; les membres de l’équipe se connectent directement aux tableaux publics avec leur compte UserJot ou via une redirection SSO). Dans le widget intégré à l’application, un jeton uj.identify signé fonctionne bien pour les administrateurs et les propriétaires : il synchronise traits et companies tout en conservant leur nom, leur avatar et leur adresse e-mail gérés dans le tableau de bord.

  • Distinct de l’authentification unique. La connexion automatique transmet les sessions du widget aux pages publiques depuis votre application ; l’authentification unique remplace le bouton Connexion du tableau par une redirection vers votre propre page de connexion.

  • En mode strict, l’accès est refusé par défaut. Lorsque l’option Exiger des jetons signés est activée, l’absence d’un jeton ou un jeton invalide entraîne le rejet de uj.identify avec IDENTIFY_FAILED et laisse le visiteur déconnecté.

Dépannage

L’utilisateur voit toujours une demande de connexion

  • Vérifiez que la connexion automatique est activée dans Paramètres → Connexion.

  • Vérifiez que le SDK du widget est chargé sur la page qui contient le lien et que uj.identify a été exécuté avant le clic sur le lien.

  • Vérifiez que le lien pointe vers le sous-domaine userjot.com exact ou vers votre domaine personnalisé.

  • Vérifiez que vous ne testez pas la connexion automatique à un tableau public avec l’adresse e-mail d’un administrateur ou d’un propriétaire d’espace de travail.

Les jetons signés sont requis, mais la connexion échoue toujours

  • Vérifiez que uj.identify reçoit un token signé avec HS256 et votre secret de projet actuel.

  • Vérifiez que iss correspond à votre ID de projet, que aud est userjot, et que iat et exp sont tous deux exprimés en secondes Unix avec exp - iat <= 3600 (durée de validité maximale : 1 heure).

  • Examinez la promesse renvoyée par uj.identify pour IDENTIFY_FAILED.

Étapes suivantes

Cet article a-t-il répondu à votre question ?