# Authentification

> Connecter les utilisateurs de votre wakapp avec Keycloak et Discovery, sans gérer de serveur d'identité ni coder de realm en dur.

Wakastart authentifie les utilisateurs de votre [wakapp](/v1.0/glossaire#wakapp) à votre place. Votre application ne connaît ni son [realm](/v1.0/glossaire#realm) ni l'instance [Keycloak](/v1.0/glossaire#keycloak) qui la sert : elle demande à [Discovery](/v1.0/glossaire#discovery) où envoyer l'utilisateur, laisse Keycloak l'authentifier, puis lit son organisation, son profil et ses droits dans l'API publique.

Cette section s'adresse aux développeurs qui intègrent la connexion dans une application web, une SPA ou un serveur.

## Comment ça marche

```mermaid
flowchart LR
  U["Navigateur de l'utilisateur"] -- "1. Se connecter" --> S["Serveur de votre wakapp"]
  S -- "2. host du front, ou e-mail + domain" --> D["Discovery<br/>discovery.wakastart.app"]
  D -- "3. URL d'autorisation" --> S
  S -- "4. Redirection (PKCE)" --> K["Keycloak de l'environnement<br/>prod, staging ou dev"]
  K -- "5. Code sur /api/auth/callback" --> S
  S -- "6. Échange du code" --> K
  S -- "7. Bearer jeton Keycloak" --> A["API publique<br/>GET /api/me"]
```

1. Votre serveur envoie à Discovery le nom d'hôte de votre front. C'est lui qui désigne l'application **et** l'environnement.
2. Discovery répond par l'URL d'autorisation complète : instance Keycloak, realm et identifiant client compris.
3. Keycloak authentifie l'utilisateur, par mot de passe ou par le [fournisseur d'identité](/v1.0/glossaire#fournisseur-didentité) de son entreprise, puis renvoie un code sur `https://<votre hôte>/api/auth/callback`.
4. Votre serveur échange ce code contre des jetons, protégé par [PKCE](/v1.0/glossaire#pkce).
5. Avec le jeton Keycloak, il appelle `GET /api/me` pour connaître l'utilisateur et ses droits dans cet environnement.

Le détail de chaque étape est dans [Flux de connexion](/v1.0/authentification/flux-de-connexion).

## Choisissez votre approche

::::cards{cols=2}
:::card{title="Par nom d'hôte" href="/v1.0/authentification/integrer-la-connexion-application-serveur" icon="Globe"}
Recommandé. Chaque client ou chaque environnement a son propre nom d'hôte : Discovery renvoie directement l'URL de connexion.
:::
:::card{title="Par adresse e-mail" href="/v1.0/authentification/connexion-multi-tenants-par-email" icon="AtSign"}
Plusieurs clients partagent un même nom d'hôte : l'utilisateur saisit son e-mail et votre application retrouve son compte.
:::
::::

## Commencer

::::cards{cols=3}
:::card{title="Démarrage rapide" href="/v1.0/demarrer/connecter-vos-utilisateurs" icon="Rocket"}
Un serveur TypeScript complet, de Discovery à la déconnexion, en vingt minutes.
:::
:::card{title="Application serveur" href="/v1.0/authentification/integrer-la-connexion-application-serveur" icon="Server"}
Intégrer la connexion dans une application rendue côté serveur.
:::
:::card{title="SPA" href="/v1.0/authentification/integrer-la-connexion-spa" icon="MonitorSmartphone"}
Intégrer la connexion dans une application React, Vue ou Angular et son serveur.
:::
::::

## Fonctionnalités

::::cards{cols=3}
:::card{title="Hôtes IAM et redirect URIs" href="/v1.0/authentification/declarer-les-hotes-et-redirect-uris" icon="Link"}
Déclarer le nom d'hôte de votre front pour que Discovery le reconnaisse.
:::
:::card{title="Contexte utilisateur" href="/v1.0/authentification/charger-le-contexte-utilisateur" icon="UserCheck"}
Lire l'identité, l'organisation, le profil et les droits avec `/api/me`.
:::
:::card{title="Vérification des jetons" href="/v1.0/authentification/verifier-un-jeton-cote-serveur" icon="ShieldCheck"}
Vérifier la signature d'un jeton Keycloak dans votre backend.
:::
:::card{title="Sessions" href="/v1.0/authentification/rafraichir-la-session" icon="RefreshCw"}
Renouveler les jetons avant leur expiration, sans déconnecter l'utilisateur.
:::
:::card{title="Déconnexion" href="/v1.0/authentification/deconnecter-un-utilisateur" icon="LogOut"}
Fermer la session Keycloak et la session de votre application.
:::
:::card{title="Mise en production" href="/v1.0/authentification/liste-de-controle" icon="ListChecks"}
Les vérifications à faire avant d'ouvrir la connexion à vos clients.
:::
::::

## Produits liés

::::cards{cols=3}
:::card{title="SSO entreprise" href="/v1.0/sso" icon="KeySquare"}
Laisser les utilisateurs d'un client se connecter avec l'annuaire de leur entreprise.
:::
:::card{title="Droits et profils" href="/v1.0/droits-et-profils" icon="ShieldCheck"}
Définir les droits que `/api/me` renvoie pour chaque utilisateur.
:::
:::card{title="Clés API" href="/v1.0/cles-api" icon="KeyRound"}
Appeler l'API publique depuis un serveur, sans utilisateur connecté.
:::
::::

## Ressources

- [Référence de l'authentification](/v1.0/authentification/reference) : réponses de Discovery, contenu des jetons, valeurs par défaut.
- [Résoudre les problèmes de connexion](/v1.0/authentification/depannage) : messages d'erreur et solutions.
- [Référence API : Discovery](/v1.0/reference-api/discovery) et [Jeton et /me](/v1.0/reference-api/jeton-et-me).
- [Limites et quotas](/v1.0/limites) : limites de débit de l'API publique et de Discovery.
- [waka-ui](/v1.0/interface-waka-ui) : les composants d'interface de votre front ; la saisie du mot de passe reste sur la page de connexion Wakastart.
