Connexion automatique
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
Ouvrez Paramètres → Connexion.
Sous Authentification, activez Connexion automatique.
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
Activez la connexion automatique dans Paramètres → Connexion.
Installez le widget dans votre produit.
Appelez
uj.identify(...)une fois la session de votre utilisateur chargée (en transmettant untokensigné si nécessaire). La transmission d’unemailassocie l’utilisateur à un compte UserJot existant uniquement si l’adresse e-mail de ce compte a été confirmée.Créez un lien depuis votre application vers votre URL publique UserJot (soit votre adresse
userjot.com, soit votre domaine personnalisé).
<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é.
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.identifysigné fonctionne bien pour les administrateurs et les propriétaires : il synchronisetraitsetcompaniestout 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.identifyavecIDENTIFY_FAILEDet 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.identifya été exécuté avant le clic sur le lien.Vérifiez que le lien pointe vers le sous-domaine
userjot.comexact 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.identifyreçoit untokensigné avec HS256 et votre secret de projet actuel.Vérifiez que
isscorrespond à votre ID de projet, queaudestuserjot, et queiatetexpsont tous deux exprimés en secondes Unix avecexp - iat <= 3600(durée de validité maximale : 1 heure).Examinez la promesse renvoyée par
uj.identifypourIDENTIFY_FAILED.
Étapes suivantes
Générez des JWT côté serveur dans Identité signée.
Comparez toutes les options d’authentification dans Identifier les utilisateurs.