Authentification unique

Shayan TaslimMis à jour

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

  1. Ouvrez Paramètres → Connexion.

  2. Sous Authentification, définissez Connexion au tableau sur SSO.

  3. 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).

  4. 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é, traits et companies sont 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 :

text
https://yourapp.com/userjot/sso?state=OPAQUE_STATE_FROM_USERJOT&redirect=https%3A%2F%2Fapi.userjot.com%2Fauth%2Fsso

Votre endpoint doit uniquement préserver state :

  1. Lire le paramètre de requête state.

  2. 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 state d’origine).

  3. Signez un JWT HS256 à l’aide de votre secret de projet.

  4. 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

sub

Oui

Identifiant utilisateur stable de votre système

iss

Oui

Votre ID de projet UserJot exact

aud

Oui

La chaîne exacte userjot

exp

Oui

Horodatage d’expiration Unix (5 à 15 minutes recommandées)

iat

Non

Horodatage d’émission Unix (ne doit pas être dans le futur, au-delà de la marge de décalage des horloges)

email

Non

Adresse e-mail de l’utilisateur (recommandée pour l’association par e-mail et les notifications)

firstName

Non

Prénom

lastName

Non

Nom de famille

avatar

Non

URL de l’avatar

traits

Non

Map plate de clés et de valeurs contenant des chaînes, des nombres, des booléens ou null

companies

Non

Tableau des appartenances à des entreprises

Exemple de charge utile :

JavaScript
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

JSON
{
  "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)

JavaScript
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

invalid_state

La valeur state est manquante, a été modifiée, a expiré (plus de 15 minutes) ou a déjà été utilisée.

invalid_token

La signature ne correspond pas, iss/aud est incorrect, sub/exp est manquant ou le JWT a expiré.

sso_disabled

Connexion au tableau n’est plus réglé sur SSO.

config_error

La configuration SSO de l’espace de travail est incomplète (URL de redirection ou secret manquant).

invalid_return_to

L’URL de retour après connexion n’a pas passé la validation.

auth_failed / session_error

L’authentification ou la création de session a échoué sur le serveur.

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