Aller au contenu

Comptes et environnements

Ce qu'est un utilisateur Wakastart, pourquoi il a une fiche par environnement, son compte Keycloak, son accès à l'application, son statut et son mot de passe.

ConceptAdministrateurDéveloppeur
Voir en Markdown

Un utilisateur Wakastart est une personne rattachée à un client, dans un environnement donné. Chaque environnement de votre application (dev, staging, prod) a son propre référentiel d'utilisateurs : la même personne peut y avoir une fiche, indépendante des autres.

Définition

ÉlémentCe que c'est
Fiche utilisateurLa personne dans un environnement : adresse e-mail, prénom, nom, niveau d'administration, client, profil, préférences. Elle a son propre WID et son champ envType (dev, staging ou prod).
Compte KeycloakL'identité de connexion de la fiche, dans le realm du réseau du client, sur l'instance Keycloak de cet environnement.
Accès à l'applicationL'autorisation, pour la fiche, de se connecter à l'application du réseau dans cet environnement.
ProfilLe paquet de droits attribué à la fiche. Voir Droits et profils.

L'adresse e-mail est unique par client et par environnement, en minuscules. La même adresse peut donc avoir trois fiches chez un client (une en dev, une en staging, une en prod), et exister aussi chez un autre client : ce sont autant d'utilisateurs distincts.

À ne pas confondre : Mon profil, dans la console, désigne vos informations personnelles (nom, coordonnées, préférences), pas votre profil de droits.

Une fiche par environnement

Wakastart fait tourner une instance Keycloak par environnement : prod (https://auth.wakastart.app), staging (https://auth-staging.wakastart.app) et dev (https://auth-dev.wakastart.app). Chaque environnement a aussi son référentiel d'utilisateurs : une fiche appartient à un seul environnement, et tout ce qu'elle porte lui est propre.

Chargement du schéma…

Conséquences :

  • Trois fiches indépendantes. Désactiver, renommer, supprimer une fiche ou réinitialiser son mot de passe n'agit que sur elle et sur son compte Keycloak. Les fiches de la même personne dans les autres environnements ne bougent pas.
  • Ni copie ni promotion. Pour donner accès à la même personne dans un autre environnement, créez-la ou invitez-la depuis cet environnement.
  • Un WID par fiche. Ne prenez pas le WID d'un utilisateur comme clé durable dans votre base : préférez le sub du jeton ou l'adresse e-mail. Voir Adapter votre application aux fiches par environnement.

L'environnement est déduit de l'appelant

Vous n'indiquez jamais l'environnement d'une opération sur les utilisateurs : Wakastart le déduit de celui qui appelle.

AppelantEnvironnement retenu
Utilisateur connecté (jeton enrichi)Celui de sa session (claim wenv du jeton)
Clé APICelui de la clé
ConsoleCelui que vous choisissez dans le sélecteur Environnement

Les paramètres env, envType ou envs envoyés à l'API publique sont refusés en 400 avec le message Environment is deduced from the caller and cannot be provided. Un appel dont l'environnement ne peut pas être déduit est refusé (401 pour un jeton, 403 pour une clé) : Wakastart ne se replie jamais sur la production.

Comment ça marche

Création de la fiche

À la création d'un utilisateur ou à l'acceptation d'une invitation, dans l'environnement de l'appelant (ou de l'inviteur), Wakastart :

  1. crée la fiche dans cet environnement ;
  2. crée le compte Keycloak sur l'instance de cet environnement, dans le realm du réseau ;
  3. ajoute le compte au groupe et à l'organisation Keycloak du client ;
  4. ouvre l'accès à l'application du réseau pour cet environnement ;
  5. attribue le profil indiqué à la fiche.

Sans accès à l'application, la connexion aboutit dans Keycloak mais votre application reçoit un refus quand elle demande le jeton enrichi.

Statut

StatutEffet
Actif (isActive: true)L'utilisateur se connecte normalement dans cet environnement.
Désactivé (isActive: false)Le compte Keycloak de cet environnement est désactivé : plus de nouvelle connexion, et Wakastart refuse d'enrichir ses jetons. La fiche, son profil et son historique sont conservés.

La suppression, elle, est définitive : voir Gérer un utilisateur.

Mot de passe

Le mot de passe est géré par Keycloak : Wakastart ne le stocke pas. Comme le compte, il est propre à l'environnement.

  • Création directe : Keycloak envoie un e-mail qui demande de vérifier l'adresse et de définir le mot de passe. Le lien est valable 24 heures. Vous pouvez aussi fournir un mot de passe temporaire (8 caractères au moins), que l'utilisateur change à sa première connexion.
  • Invitation : après l'acceptation, Keycloak envoie l'e-mail « définir votre mot de passe ».

Si un compte Keycloak vérifié et actif existe déjà pour cette adresse dans le realm de cet environnement, Wakastart le réutilise et n'envoie aucun e-mail. La réponse de création le signale par "reconciledWithoutInvite": true.

Niveau d'administration

Un utilisateur créé sans précision a le niveau Aucun (NONE) ; un utilisateur invité reçoit le niveau Utilisateur (USER). Vous ne pouvez jamais attribuer un niveau supérieur au vôtre. Voir Niveaux d'administration.

Exemples

  • Un client en production. Ses utilisateurs n'ont qu'une fiche, en prod. Vous les invitez avec un jeton ou une clé API de production.
  • Une équipe de recette. Les testeurs du client ont une fiche en staging et une en prod, avec un profil et un WID différents sur chacune.
  • Un départ. Vous désactivez la fiche de prod : la personne ne se connecte plus en production, mais ses actions passées restent attribuées dans le journal d'audit. Ses éventuelles fiches de dev et de staging se désactivent séparément.

Pour aller plus loin