Aller au contenu

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.

GuideDéveloppeur
Accès requis
Jeton Keycloak de l'utilisateur, émis pour votre application
Durée
15 min
Voir en Markdown

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 azp est 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

GET/api/me

Appelez l'endpoint avec le jeton d'accès de l'utilisateur, tel que votre front l'a reçu de Keycloak.

Bash
curl "https://api.wakastart.app/api/me" \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.exemple.signature"

Réponse attendue (extrait) :

JSON
{
  "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"
}
ChampUsage
profile.rights[].codeLes droits de l'utilisateur pour l'environnement de la session. C'est ce que vous testez.
profile.wid, profile.nameLe profil de l'utilisateur pour cet environnement
adminLevelSon niveau d'administration (USER, CUSTOMER_ADMIN…)
customer.widSon client, utile pour vérifier une fonctionnalité
teamsSes é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.

TypeScript
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 :

JSON
{ "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

  1. Connectez-vous avec un utilisateur dont le profil contient agenda.read mais pas agenda.write.
  2. Appelez GET /agenda : réponse 200.
  3. Appelez PUT /agenda/1 : réponse 403 avec « Droit requis : agenda.write ».

Dépannage

  • /api/me répond 403 « Access denied: token authorized party does not match the target application » : le jeton a été émis pour une autre application.
  • /api/me ré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.

Voir aussi