Skip to content

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.

GuideDeveloper
Required access
Jeton Keycloak de l'utilisateur, émis pour votre application
Duration
15 min

This page has not been translated yet and is shown in French.

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" }

Tip

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