Skip to content

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.

ReferenceAdministratorDeveloper

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/users et 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/me ne 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, customerId accepte un UUID ou un WID, et customerWid est 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, envType sur la liste des utilisateurs et sur les invitations, env et envType sur les droits d'un profil. Ils sont refusés en 400 avec le message Environment 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 401 pour un jeton et en 403 pour une clé.
  • Incompatible La recherche Discovery sans nom d'hôte : POST /discover/start-login exige host, et GET /discover/email doit recevoir domain. Voir Discovery.
  • Le champ availableEnvs des 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 envType sur les objets utilisateur.
  • Le paramètre domain sur 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 : POST et DELETE /api/config/profiles/{profile}/users/{userWid}.

Pages mises à jour