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

**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](/v1.0/utilisateurs/adapter-votre-application-aux-fiches-par-environnement).

Les changements marqués :badge[Incompatible]{type=deprecated} demandent une modification d'un appelant existant.

## Changé

- :badge[Incompatible]{type=deprecated} 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.
- :badge[Incompatible]{type=deprecated} `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.
- :badge[Incompatible]{type=deprecated} `GET /api/config/users` et toutes les lectures d'utilisateurs ne renvoient que les fiches de l'environnement de l'appelant.
- :badge[Incompatible]{type=deprecated} 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.
- :badge[Incompatible]{type=deprecated} `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.
- :badge[Incompatible]{type=deprecated} 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.
- :badge[Incompatible]{type=deprecated} 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é

- :badge[Incompatible]{type=deprecated} 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`.
- :badge[Incompatible]{type=deprecated} 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é.
- :badge[Incompatible]{type=deprecated} La recherche Discovery sans nom d'hôte : `POST /discover/start-login` exige `host`, et `GET /discover/email` doit recevoir `domain`. Voir [Discovery](/v1.0/concepts/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

- [Comptes et environnements](/v1.0/utilisateurs/comptes-et-environnements)
- [Droits applicatifs et profils](/v1.0/droits-et-profils/droits-et-profils)
- [Environnements](/v1.0/concepts/environnements)
- [Référence API des utilisateurs](/v1.0/reference-api/utilisateurs), [des invitations](/v1.0/reference-api/invitations) et [des droits et profils](/v1.0/reference-api/droits-et-profils)
