Authentification
Connecter les utilisateurs de votre wakapp avec Keycloak et Discovery, sans gérer de serveur d'identité ni coder de realm en dur.
This page has not been translated yet and is shown in French.
Wakastart authentifie les utilisateurs de votre wakapp à votre place. Votre application ne connaît ni son realm ni l'instance Keycloak qui la sert : elle demande à 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
- Votre serveur envoie à Discovery le nom d'hôte de votre front. C'est lui qui désigne l'application et l'environnement.
- Discovery répond par l'URL d'autorisation complète : instance Keycloak, realm et identifiant client compris.
- Keycloak authentifie l'utilisateur, par mot de passe ou par le fournisseur d'identité de son entreprise, puis renvoie un code sur
https://<votre hôte>/api/auth/callback. - Votre serveur échange ce code contre des jetons, protégé par PKCE.
- Avec le jeton Keycloak, il appelle
GET /api/mepour connaître l'utilisateur et ses droits dans cet environnement.
Le détail de chaque étape est dans Flux de connexion.
Choisissez votre approche
Recommandé. Chaque client ou chaque environnement a son propre nom d'hôte : Discovery renvoie directement l'URL de connexion.
Par adresse e-mailPlusieurs clients partagent un même nom d'hôte : l'utilisateur saisit son e-mail et votre application retrouve son compte.
Commencer
Un serveur TypeScript complet, de Discovery à la déconnexion, en vingt minutes.
Application serveurIntégrer la connexion dans une application rendue côté serveur.
SPAIntégrer la connexion dans une application React, Vue ou Angular et son serveur.
Fonctionnalités
Déclarer le nom d'hôte de votre front pour que Discovery le reconnaisse.
Contexte utilisateurLire l'identité, l'organisation, le profil et les droits avec /api/me.
Vérifier la signature d'un jeton Keycloak dans votre backend.
SessionsRenouveler les jetons avant leur expiration, sans déconnecter l'utilisateur.
DéconnexionFermer la session Keycloak et la session de votre application.
Mise en productionLes vérifications à faire avant d'ouvrir la connexion à vos clients.
Produits liés
Laisser les utilisateurs d'un client se connecter avec l'annuaire de leur entreprise.
Droits et profilsDéfinir les droits que /api/me renvoie pour chaque utilisateur.
Appeler l'API publique depuis un serveur, sans utilisateur connecté.
Ressources
- Référence de l'authentification : réponses de Discovery, contenu des jetons, valeurs par défaut.
- Résoudre les problèmes de connexion : messages d'erreur et solutions.
- Référence API : Discovery et Jeton et /me.
- Limites et quotas : limites de débit de l'API publique et de Discovery.
- waka-ui : les composants d'interface de votre front ; la saisie du mot de passe reste sur la page de connexion Wakastart.