Une fiche utilisateur par environnement
29 octobre 2026 — chaque environnement a son référentiel d'utilisateurs, l'environnement est déduit de l'appelant et les profils se désignent par leur WID.
This page has not been translated yet and is shown in French.
29 octobre 2026. Chaque environnement d'une application (dev, staging, prod) a désormais son propre référentiel d'utilisateurs. Une personne présente sur plusieurs environnements a une fiche, et donc un WID, par environnement. L'environnement d'un appel n'est plus jamais fourni par votre application : Wakastart le déduit de l'appelant.
La plupart des utilisateurs ne voient aucun changement : seules les personnes présentes sur plusieurs environnements reçoivent un nouveau WID sur certains d'entre eux. Adaptez votre application avant la bascule en suivant Adapter votre application aux fiches par environnement.
Les changements marqués Incompatible demandent une modification d'un appelant existant.
Changé
- Incompatible Les identifiants d'un utilisateur (WID,
id) sont propres à un environnement. Seule la fiche de l'environnement le plus haut réellement déployé pour l'application garde l'ancien WID ; les autres en reçoivent un nouveau. - Incompatible
keycloakId, renvoyé par les endpoints de contrôle de jeton, désigne le compte Keycloak de l'environnement de la session, et non plus le compte de production. - Incompatible
GET /api/config/userset toutes les lectures d'utilisateurs ne renvoient que les fiches de l'environnement de l'appelant. - Incompatible Les droits d'un profil ne se lisent et ne s'écrivent plus que dans la matrice de l'environnement de l'appelant ; la lecture renvoyait auparavant les trois environnements.
- Incompatible
GET /api/mene renvoie que le profil et les droits de la fiche de l'environnement de la session ; l'ancien profil unique de la fiche n'est plus utilisé en repli. - Incompatible Les droits d'une clé API sont ceux de la matrice de l'environnement de la clé, et non plus toujours ceux de la production : une clé de dev ou de staging peut gagner ou perdre des droits.
- Incompatible L'attribution d'un profil se fait dans l'environnement de la fiche, et une invitation appartient à l'environnement de l'inviteur.
- L'unicité de l'adresse e-mail s'apprécie par client et par environnement : la même adresse peut avoir une fiche en dev, en staging et en prod.
- Les routes de profils et les invitations désignent un profil par son WID ; l'UUID reste accepté. Dans une invitation,
customerIdaccepte un UUID ou un WID, etcustomerWidest déprécié. - Les routes de droits et d'utilisateurs d'un profil sont réservées aux administrateurs client, sans autre droit applicatif.
- Le nom d'un profil est unique dans l'application : un doublon répond
409. - Dans la console, les écrans d'utilisateurs, la matrice droits / profils, les thèmes de la page de connexion et l'envoi des e-mails demandent de choisir un environnement, et n'agissent que sur lui.
Retiré
- Incompatible Les paramètres d'environnement fournis par l'appelant :
envsà la création d'un utilisateur,envTypesur la liste des utilisateurs et sur les invitations,envetenvTypesur les droits d'un profil. Ils sont refusés en400avec le messageEnvironment is deduced from the caller and cannot be provided. - Incompatible Le repli implicite sur la production : un appelant dont l'environnement ne peut pas être déduit est refusé, en
401pour un jeton et en403pour une clé. - Incompatible La recherche Discovery sans nom d'hôte :
POST /discover/start-loginexigehost, etGET /discover/emaildoit recevoirdomain. Voir Discovery. - Le champ
availableEnvsdes profils et des droits : un droit ou un profil existe dans les trois environnements. S'il est encore envoyé, il est ignoré ; retirez-le de vos appels. - La promotion de la matrice profils × droits d'un environnement vers un autre, et la copie d'une fiche utilisateur d'un environnement vers un autre.
- La création de profils propres à un réseau ou à un client : un profil appartient à l'application. Un réseau peut toujours masquer un profil de l'application.
Ajouté
- La recherche d'un utilisateur par e-mail,
GET /api/config/users/search?email=, limitée à l'environnement de l'appelant. - Le champ
envTypesur les objets utilisateur. - Le paramètre
domainsur la recherche par e-mail de Discovery relayée par l'API publique,GET /api/discovery/email. - Les routes d'attribution d'un profil par WID :
POSTetDELETE /api/config/profiles/{profile}/users/{userWid}.