# Utilisateurs et équipes

> Inviter, créer, désactiver et regrouper en équipes les utilisateurs de vos clients, par la console et par l'API publique.

Chaque utilisateur appartient à un [client](/v1.0/glossaire#client) et à un environnement : dev, staging et prod ont chacun leur référentiel d'utilisateurs. La même personne peut avoir une fiche dans chacun, avec son compte Keycloak dans le realm de son réseau. Wakastart crée ces comptes, envoie les e-mails d'invitation et de définition du mot de passe, et tient à jour leur accès à votre application.

La gestion des utilisateurs passe par l'API publique (`https://api.wakastart.app/api`), depuis le serveur de votre application ou depuis vos outils d'administration. Les réglages des invitations se font dans la console.

## Comment ça marche

Le parcours recommandé pour faire entrer un utilisateur est l'[invitation](/v1.0/glossaire#invitation) :

```mermaid
sequenceDiagram
  participant S as Serveur de votre application
  participant W as Wakastart
  participant U as Personne invitée
  participant K as Keycloak (instance de l'environnement)
  S->>W: POST /api/invitations (e-mail, profil)
  W->>U: E-mail avec le lien d'acceptation
  U->>S: Ouvre le lien sur votre page d'acceptation
  S->>W: GET /api/invitations/verify/{token}
  S->>W: POST /api/invitations/accept/{token}
  W->>K: Crée le compte dans le realm du réseau (environnement de l'inviteur)
  K->>U: E-mail « définir votre mot de passe »
  U->>K: Choisit son mot de passe puis se connecte
```

L'invitation appartient à l'environnement de celui qui l'envoie, déduit de sa clé API ou de sa session. À l'acceptation, l'utilisateur reçoit une fiche dans cet environnement, le profil prévu par l'invitation et l'accès à votre application. Ses droits viennent de ce [profil](/v1.0/glossaire#profil) : voir [Droits et profils](/v1.0/droits-et-profils).

## Choisissez votre approche

::::cards{cols=3}
:::card{title="Inviter" href="/v1.0/utilisateurs/inviter-un-utilisateur" icon="MailPlus"}
La personne crée son compte elle-même. Recommandé dans la plupart des cas.
:::
:::card{title="Créer directement" href="/v1.0/utilisateurs/creer-un-utilisateur" icon="UserPlus"}
Vous créez le compte ; Keycloak envoie l'e-mail de définition du mot de passe.
:::
:::card{title="Importer un CSV" href="/v1.0/utilisateurs/importer-des-utilisateurs" icon="FileSpreadsheet"}
Jusqu'à 500 comptes d'un coup, sans profil : à compléter ensuite.
:::
::::

## Commencer

::::cards{cols=3}
:::card{title="Comptes et environnements" href="/v1.0/utilisateurs/comptes-et-environnements" icon="Users"}
Une fiche par environnement : ce qu'elle porte et comment l'environnement est déduit.
:::
:::card{title="Configurer les invitations" href="/v1.0/utilisateurs/configurer-les-invitations" icon="Settings2"}
Activer les invitations et indiquer l'URL de votre page d'acceptation.
:::
:::card{title="Intégrer l'acceptation" href="/v1.0/utilisateurs/integrer-l-acceptation-d-une-invitation" icon="Code"}
Construire la page qui reçoit le lien d'invitation.
:::
::::

## Fonctionnalités

::::cards{cols=2}
:::card{title="Suivre les invitations" href="/v1.0/utilisateurs/suivre-les-invitations" icon="ListChecks"}
Lister, relancer et annuler les invitations envoyées.
:::
:::card{title="Désactiver ou supprimer" href="/v1.0/utilisateurs/gerer-un-utilisateur" icon="UserX"}
Couper l'accès d'un utilisateur sans perdre son historique, ou le supprimer.
:::
:::card{title="Équipes" href="/v1.0/utilisateurs/gerer-les-equipes" icon="UsersRound"}
Regrouper des utilisateurs d'un client avec un niveau par membre.
:::
:::card{title="Mon profil" href="/v1.0/utilisateurs/mettre-a-jour-votre-profil" icon="UserCog"}
Mettre à jour votre nom, vos coordonnées et vos préférences dans la console.
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="Droits et profils" href="/v1.0/droits-et-profils" icon="ShieldCheck"}
Décider ce que chaque utilisateur peut faire.
:::
:::card{title="Authentification" href="/v1.0/authentification" icon="LogIn"}
Connecter vos utilisateurs à votre application.
:::
:::card{title="E-mails" href="/v1.0/emails" icon="Mail"}
Envoyer les invitations depuis votre propre compte d'envoi.
:::
::::

## Ressources

- [Adapter votre application aux fiches par environnement](/v1.0/utilisateurs/adapter-votre-application-aux-fiches-par-environnement)
- [Référence des utilisateurs, invitations et équipes](/v1.0/utilisateurs/reference)
- [Référence API des utilisateurs](/v1.0/reference-api/utilisateurs), [des invitations](/v1.0/reference-api/invitations) et [des équipes](/v1.0/reference-api/equipes)
- [Résoudre les problèmes d'utilisateurs](/v1.0/utilisateurs/depannage)
