Vérifier un droit dans votre application
Lire le profil et les droits de l'utilisateur connecté avec GET /api/me, puis autoriser ou refuser une action côté serveur.
- Accès requis
- Jeton Keycloak de l'utilisateur, émis pour votre application
- Durée
- 15 min
Votre application applique elle-même ses droits. À chaque requête sensible, son serveur vérifie que l'utilisateur connecté porte le droit voulu. Wakastart fournit ces droits par GET /api/me, calculés pour l'environnement de la session.
Avant de commencer
- Votre application connecte ses utilisateurs avec Keycloak et reçoit leur jeton d'accès : voir Authentification.
- Le jeton a été émis pour votre application : son claim
azpest l'identifiant client de l'application (son WID). Un jeton émis pour une autre application est refusé. - Les droits sont déclarés et attribués : voir Définir les droits et Attribuer un profil.
Lire les droits de l'utilisateur
/api/meAppelez l'endpoint avec le jeton d'accès de l'utilisateur, tel que votre front l'a reçu de Keycloak.
curl "https://api.wakastart.app/api/me" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.exemple.signature"Réponse attendue (extrait) :
{
"wid": "Us8hJ4",
"email": "marie.dupont@cabinet-exemple.fr",
"firstName": "Marie",
"lastName": "Dupont",
"isActive": true,
"adminLevel": "USER",
"hdsRoles": [],
"partner": { "wid": "Pa7tN3", "name": "Éditions Exemple" },
"network": { "wid": "Nw4kR8", "name": "Réseau Sud-Ouest" },
"customer": { "wid": "Cu9pL2", "name": "Cabinet Exemple" },
"teams": [{ "wid": "Tm3qX7", "name": "Secrétariat Lyon", "teamLevel": "MEMBER" }],
"profile": {
"wid": "Pr5sT1",
"name": "Secrétariat",
"description": "Agenda et accueil",
"rights": [
{ "code": "agenda.read", "name": "Consulter l'agenda", "category": "Agenda" },
{ "code": "agenda.write", "name": "Modifier l'agenda", "category": "Agenda" }
]
},
"branding": { "logoLightUrl": "https://cdn.exemple.fr/logo.png" },
"lastLoginAt": "2026-10-23T08:12:00.000Z",
"createdAt": "2026-09-01T10:00:00.000Z"
}| Champ | Usage |
|---|---|
profile.rights[].code | Les droits de l'utilisateur pour l'environnement de la session. C'est ce que vous testez. |
profile.wid, profile.name | Le profil de l'utilisateur pour cet environnement |
adminLevel | Son niveau d'administration (USER, CUSTOMER_ADMIN…) |
customer.wid | Son client, utile pour vérifier une fonctionnalité |
teams | Ses équipes et son niveau dans chacune |
Si l'utilisateur n'a pas de profil pour l'environnement de la session, profile vaut { "wid": "", "name": "Default", "description": "" }, sans droits.
Protéger une route de votre serveur
L'exemple suivant, pour Node.js 18 ou plus avec Express, refuse l'accès si le droit manque.
import express, { type NextFunction, type Request, type Response } from "express";
const WAKASTART_API = "https://api.wakastart.app/api";
type Me = {
wid: string;
adminLevel: string;
customer: { wid: string; name: string };
profile: { wid: string; name: string; rights?: { code: string }[] };
};
async function loadMe(accessToken: string): Promise<Me | null> {
const response = await fetch(`${WAKASTART_API}/me`, {
headers: { Authorization: `Bearer ${accessToken}` },
});
if (!response.ok) return null;
return (await response.json()) as Me;
}
function requireRight(code: string) {
return async (req: Request, res: Response, next: NextFunction) => {
const header = req.headers.authorization ?? "";
const token = header.startsWith("Bearer ") ? header.slice(7) : "";
if (!token) return res.status(401).json({ message: "Jeton manquant" });
const me = await loadMe(token);
if (!me) return res.status(401).json({ message: "Session invalide" });
const rights = new Set((me.profile.rights ?? []).map((r) => r.code));
if (!rights.has(code)) {
return res.status(403).json({ message: `Droit requis : ${code}` });
}
res.locals.me = me;
next();
};
}
const app = express();
app.get("/agenda", requireRight("agenda.read"), (_req, res) => {
res.json({ rendezVous: [] });
});
app.put("/agenda/:id", requireRight("agenda.write"), (_req, res) => {
res.status(204).end();
});
app.listen(3000);Réponse attendue pour un utilisateur sans le droit agenda.write :
{ "message": "Droit requis : agenda.write" }Conseil
Chargez /api/me une fois par requête au plus, ou mettez le résultat en cache pour quelques secondes par jeton. Les modifications de profil sont visibles au prochain appel de /api/me.
Important
Masquer un bouton dans l'interface ne suffit pas : vérifiez toujours le droit côté serveur, avant d'exécuter l'action.
Vérifier le résultat
- Connectez-vous avec un utilisateur dont le profil contient
agenda.readmais pasagenda.write. - Appelez
GET /agenda: réponse 200. - Appelez
PUT /agenda/1: réponse 403 avec « Droit requis : agenda.write ».
Dépannage
/api/merépond 403 « Access denied: token authorized party does not match the target application » : le jeton a été émis pour une autre application./api/merépond 401 : le jeton a expiré, l'utilisateur est désactivé ou n'a pas d'accès à l'application pour cet environnement. Voir Résoudre les problèmes de droits.