Authentification unique
L’authentification unique (SSO) remplace le processus de connexion par défaut de votre tableau public. Lorsque les visiteurs cliquent sur Se connecter, UserJot les redirige vers votre endpoint d’authentification, puis vous les redirigez vers le tableau avec un JWT HS256 signé.
Les modes de connexion au tableau (Par défaut, SSO et Désactivé) nécessitent l’offre Professional.
Activer le SSO
Ouvrez Paramètres → Connexion.
Sous Authentification, définissez Connexion au tableau sur SSO.
Dans la boîte de dialogue Activer le SSO, saisissez votre URL de redirection HTTPS, puis cliquez sur Activer le SSO. Vous pourrez modifier l’URL ultérieurement sous URL de redirection SSO (pour effacer complètement l’URL de redirection, désactivez d’abord Connexion au tableau pour SSO).
Copiez votre ID de projet et votre secret de projet depuis la section Secrets.
Votre URL de redirection doit utiliser https:// (utilisez un tunnel HTTPS pour les tests en local).
Modes de connexion au tableau
Par défaut : les visiteurs se connectent avec des comptes UserJot standards.
SSO : lorsque les visiteurs cliquent sur Se connecter, ils sont redirigés vers votre point de terminaison SSO. Les comptes UserJot ordinaires des utilisateurs finaux ne peuvent pas se connecter directement tant que le SSO est actif (les navigateurs disposant d’une session UserJot existante qui n’est pas liée à l’équipe sont considérés comme anonymes sur un tableau réservé au SSO, plutôt que rétrogradés au rôle d’invité). Les propriétaires et administrateurs de l’espace de travail peuvent se connecter avec leur compte UserJot ou via votre redirection SSO (avec le SSO, leur rôle d’équipe existant est respecté,
traitsetcompaniessont synchronisés, et leur nom, avatar et adresse e-mail gérés depuis le tableau de bord restent inchangés).Désactivé : masque complètement le bouton Se connecter. Associez cette option à Commentaires des invités pour les tableaux ouverts, ou désactivez les envois des invités pour obtenir un tableau public en lecture seule.
Fonctionnement du flux de redirection SSO
Lorsqu’un visiteur clique sur Se connecter, UserJot ouvre une fenêtre contextuelle de connexion (et, si les fenêtres contextuelles sont bloquées, redirige l’utilisateur dans le même onglet) vers l’URL configurée, avec les paramètres de requête state et redirect :
https://yourapp.com/userjot/sso?state=OPAQUE_STATE_FROM_USERJOT&redirect=https%3A%2F%2Fapi.userjot.com%2Fauth%2FssoVotre endpoint doit uniquement préserver state :
Lire le paramètre de requête
state.Authentifiez l’utilisateur dans votre application (s’il n’est pas encore connecté, faites-le passer par votre processus de connexion, puis renvoyez-le vers cet endpoint avec le
stated’origine).Signez un JWT
HS256à l’aide de votre secret de projet.Redirigez le navigateur vers
https://api.userjot.com/auth/sso?jwt=<JWT>&state=<STATE>.
Ne modifiez pas state. Il est à usage unique, lié à la session du navigateur et expire au bout de 15 minutes.
Charge utile du JWT
Signez le jeton avec HS256 à l’aide de votre secret de projet (gardez le secret sur votre serveur, jamais dans le code client). La transmission de email associe l’utilisateur à un compte UserJot existant uniquement si l’adresse e-mail de ce compte a été confirmée (ou si ce compte est déjà membre de l’équipe ou associé par externalId).
Réclamation | Obligatoire | Description |
|---|---|---|
| Oui | Identifiant utilisateur stable de votre système |
| Oui | Votre ID de projet UserJot exact |
| Oui | La chaîne exacte |
| Oui | Horodatage d’expiration Unix (5 à 15 minutes recommandées) |
| Non | Horodatage d’émission Unix (ne doit pas être dans le futur, au-delà de la marge de décalage des horloges) |
| Non | Adresse e-mail de l’utilisateur (recommandée pour l’association par e-mail et les notifications) |
| Non | Prénom |
| Non | Nom de famille |
| Non | URL de l’avatar |
| Non | Map plate de clés et de valeurs contenant des chaînes, des nombres, des booléens ou |
| Non | Tableau des appartenances à des entreprises |
Exemple de charge utile :
const now = Math.floor(Date.now() / 1000);
const payload = {
sub: 'user_123',
email: 'jane@example.com',
firstName: 'Jane',
lastName: 'Doe',
iss: 'YOUR_PROJECT_ID',
aud: 'userjot',
iat: now,
exp: now + 10 * 60
};Données de l’entreprise
{
"companies": [
{
"id": "company_456",
"name": "Acme Corp",
"domain": "acme.com",
"logo": "https://example.com/acme.png",
"traits": {
"plan": "enterprise",
"seats": 42
}
}
]
}Exemple d’endpoint (Hono)
import { Hono } from 'hono';
import jwt from 'jsonwebtoken';
const app = new Hono();
const USERJOT_PROJECT_ID = process.env.USERJOT_PROJECT_ID;
const USERJOT_PROJECT_SECRET = process.env.USERJOT_PROJECT_SECRET;
const USERJOT_CALLBACK_URL = 'https://api.userjot.com/auth/sso';
app.get('/userjot/sso', async (c) => {
const state = c.req.query('state');
if (!state) return c.text('Missing state', 400);
const user = await getCurrentUser(c);
const token = jwt.sign(
{
sub: user.id,
email: user.email,
firstName: user.firstName,
lastName: user.lastName,
iss: USERJOT_PROJECT_ID,
aud: 'userjot'
},
USERJOT_PROJECT_SECRET,
{ algorithm: 'HS256', expiresIn: '10m' }
);
const callback = new URL(USERJOT_CALLBACK_URL);
callback.searchParams.set('jwt', token);
callback.searchParams.set('state', state);
return c.redirect(callback.toString());
});Rotation de votre secret de projet
Si vous cliquez sur Révoquer le secret dans Paramètres → Connexion → Secrets, UserJot génère immédiatement un nouveau secret de projet. Mettez à jour sans attendre votre endpoint SSO (ainsi que les signataires Identité signée et Swift SDK éventuels), car les jetons signés avec l’ancien secret cessent immédiatement de fonctionner.
Dépannage
Dans le flux par défaut avec fenêtre contextuelle, les erreurs de rappel sont transmises au tableau et affichées dans la fenêtre modale de connexion. Lorsque le navigateur utilise une redirection dans le même onglet (par exemple, si les fenêtres contextuelles sont bloquées), UserJot redirige l’utilisateur vers le tableau avec un paramètre de requête sso_error :
Code d’erreur | Signification |
|---|---|
| La valeur |
| La signature ne correspond pas, |
| Connexion au tableau n’est plus réglé sur SSO. |
| La configuration SSO de l’espace de travail est incomplète (URL de redirection ou secret manquant). |
| L’URL de retour après connexion n’a pas passé la validation. |
| L’authentification ou la création de session a échoué sur le serveur. |