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

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ément | Ce que c'est |
|---|---|
| Fiche utilisateur | La personne dans un environnement : adresse e-mail, prénom, nom, niveau d'administration, client, profil, préférences. Elle a son propre [WID](/v1.0/glossaire#wid) et son champ `envType` (`dev`, `staging` ou `prod`). |
| Compte Keycloak | L'identité de connexion de la fiche, dans le realm du réseau du client, sur l'instance Keycloak de cet environnement. |
| Accès à l'application | L'autorisation, pour la fiche, de se connecter à l'application du réseau dans cet environnement. |
| Profil | Le paquet de droits attribué à la fiche. Voir [Droits et profils](/v1.0/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](/v1.0/glossaire#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.

```mermaid
flowchart TB
  P["alice@exemple.fr<br/>client « Exemple SA »"]
  P --> D["Fiche dev<br/>WID Ab12Cd · compte Keycloak dev<br/>profil Testeur"]
  P --> S["Fiche staging<br/>WID Ef34Gh · compte Keycloak staging<br/>profil Testeur"]
  P --> R["Fiche prod<br/>WID Ij56Kl · compte Keycloak prod<br/>profil Gérant"]
```

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](/v1.0/utilisateurs/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.

| Appelant | Environnement retenu |
|---|---|
| Utilisateur connecté (jeton enrichi) | Celui de sa session (claim `wenv` du jeton) |
| Clé API | Celui de la clé |
| Console | Celui 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

| Statut | Effet |
|---|---|
| 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](/v1.0/utilisateurs/gerer-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](/v1.0/droits-et-profils/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

- [Cycle de vie d'une invitation](/v1.0/utilisateurs/cycle-de-vie-d-une-invitation)
- [Créer un utilisateur](/v1.0/utilisateurs/creer-un-utilisateur)
- [Adapter votre application aux fiches par environnement](/v1.0/utilisateurs/adapter-votre-application-aux-fiches-par-environnement)
- [Environnements](/v1.0/concepts/environnements)
