From 5682052423101d2392650696407129c64d1c5c96 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?C=C3=A9drix?= Date: Sat, 31 Oct 2026 08:55:27 +0100 Subject: [PATCH] Fiche d'un compte AlpID dans la console d'administration (#5) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit web/admin/compte.php?id= montre d'un coup d'œil ce qui explique un compte « reconnu, mais sans aucun droit » : activé ou non, adresse vérifiée, actions requises, OTP, groupes, rôles realm et client — directs et effectifs, ceux hérités d'un groupe compris —, sessions ouvertes. Un encadré « En bref » pointe les rôles de ROLES_SURVEILLES (par défaut messagerie-admin et messagerie-mailperso sur le client messagerie). L'identifiant est validé comme UUID ; dans la liste des membres, nom et identifiant mènent à la fiche. Les erreurs de l'API d'administration ne sont plus muettes : _kc_attendre() lève une exception qui, pour un 403, nomme le rôle manquant au compte de service et l'endroit où l'attribuer. Pour un compte du realm master, ces rôles sont ceux du client « -realm » (« master-realm » en production), l'équivalent de realm-management. kc_list_users(), kc_list_groups() et kc_group_members() ne renvoient plus [] en cas d'erreur ; les écrans membres, groupes et services affichent le message. Services refuse d'enregistrer quand les groupes n'ont pu être lus, plutôt que d'effacer les groupes requis. La liste des membres ne fait plus un appel par compte pour ses groupes : elle lit les membres de chaque groupe (kc_noms_groupes_par_compte()). Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01V2csyno8m71DJFKYM1vgzV --- web/admin/compte.php | 286 +++++++++++++++++++++++++++++++++++++++++ web/admin/groups.php | 16 ++- web/admin/members.php | 19 +-- web/admin/services.php | 18 ++- web/assets/style.css | 27 +++- web/inc/config.php | 6 + web/inc/keycloak.php | 183 +++++++++++++++++++++++--- 7 files changed, 522 insertions(+), 33 deletions(-) create mode 100644 web/admin/compte.php diff --git a/web/admin/compte.php b/web/admin/compte.php new file mode 100644 index 0000000..2b067c9 --- /dev/null +++ b/web/admin/compte.php @@ -0,0 +1,286 @@ +

Identifiant de compte invalide

' + . '

L\'adresse doit porter l\'identifiant Keycloak du compte (un UUID).

' + . 'Retour aux membres'; + require __DIR__ . '/../views/layout_end.php'; + exit; +} + +$moi = current_user(); +$soi = $id === ($moi['sub'] ?? ''); +$url_moi = '/admin/compte.php?id=' . rawurlencode($id); + +// Lit un bloc de la fiche ; une erreur est rangée sous $cle et le bloc vaut null. +function _fiche_lire(callable $lecture, array &$erreurs, string $cle): mixed { + try { + return $lecture(); + } catch (RuntimeException $ex) { + $erreurs[$cle] = $ex->getMessage(); + return null; + } +} + +// Date Keycloak (millisecondes depuis l'époque) en clair. +function _fiche_date(int|float|null $ms): string { + if (!$ms) return '—'; + return date('d/m/Y H:i', (int)($ms / 1000)); +} + +// Ce qu'une action requise imposera à la prochaine connexion. +const ACTIONS_REQUISES = [ + 'UPDATE_PASSWORD' => 'changer son mot de passe', + 'VERIFY_EMAIL' => 'vérifier son adresse', + 'CONFIGURE_TOTP' => 'configurer l\'OTP', + 'UPDATE_PROFILE' => 'compléter son profil', + 'TERMS_AND_CONDITIONS'=> 'accepter les conditions', + 'webauthn-register' => 'enregistrer une clé de sécurité', + 'delete_account' => 'supprimer son compte', +]; + +$erreurs = []; +try { + $compte = kc_get_user($id); +} catch (RuntimeException $ex) { + $compte = null; + $erreurs['compte'] = $ex->getMessage(); + $erreurs_code = in_array($ex->getCode(), [403, 404], true) ? $ex->getCode() : 502; +} + +if ($compte === null) { + http_response_code($erreurs_code ?? 502); + $title = 'Compte introuvable'; + require __DIR__ . '/../views/layout.php'; + ?> +
+ +
+

← Retour aux membres

+
+ kc_user_groups($id), $erreurs, 'groupes'); +$moyens = _fiche_lire(fn() => kc_user_credentials($id), $erreurs, 'moyens'); +$roles = _fiche_lire(fn() => kc_user_role_mappings($id), $erreurs, 'roles'); +$realm_eff = _fiche_lire(fn() => kc_user_realm_roles_effectifs($id), $erreurs, 'roles'); +$sessions = _fiche_lire(fn() => kc_user_sessions($id), $erreurs, 'sessions'); + +$otp = $moyens === null ? null : array_values(array_filter($moyens, fn($c) => ($c['type'] ?? '') === 'otp')); +$mot_de_passe = $moyens === null ? null : (bool)array_filter($moyens, fn($c) => ($c['type'] ?? '') === 'password'); + +// Rôles client : directs (role-mappings) et effectifs (composite), pour les +// clients où le compte a un rôle direct et pour ceux des ROLES_SURVEILLES. +$directs_client = []; // clientId => [noms] +$uuid_client = []; // clientId => uuid +foreach (($roles['clientMappings'] ?? []) as $client_id => $m) { + $directs_client[$client_id] = array_column($m['mappings'] ?? [], 'name'); + $uuid_client[$client_id] = $m['id'] ?? null; +} +$clients_vus = array_keys($directs_client); +foreach (ROLES_SURVEILLES as $surveille) { + [$client_id] = explode(':', $surveille, 2) + [1 => '']; + if ($client_id !== '' && !in_array($client_id, $clients_vus, true)) $clients_vus[] = $client_id; +} +sort($clients_vus); + +$effectifs_client = []; // clientId => [noms] | null si absent du realm +foreach ($clients_vus as $client_id) { + $effectifs_client[$client_id] = _fiche_lire(function () use ($client_id, $id, &$uuid_client) { + $uuid = $uuid_client[$client_id] ?? kc_client_uuid($client_id); + if ($uuid === null) return null; + $uuid_client[$client_id] = $uuid; + return array_column(kc_user_client_roles_effectifs($id, $uuid), 'name'); + }, $erreurs, "client:$client_id"); +} + +$noms_groupes = $groupes === null ? [] : array_column($groupes, 'name'); +$actions = $compte['requiredActions'] ?? []; +$nom_complet = trim(($compte['firstName'] ?? '') . ' ' . ($compte['lastName'] ?? '')); + +$title = 'Compte ' . ($compte['username'] ?? ''); +require __DIR__ . '/../views/layout.php'; +?> + +
+ + + +
C'est votre propre compte.
+ + + +
+

En bref

+
    +
  • + Compte +
  • +
  • + Adresse +
  • +
  • + + À la prochaine connexion, devra : + ACTIONS_REQUISES[$a] ?? $a, $actions))) ?> + + Aucune action requise + +
  • + +
  • + + +
  • + +
  • + +
  • Administrateur du portail
  • + + + '']; + if (array_key_exists("client:$client_id", $erreurs)) continue; + $eff = $effectifs_client[$client_id] ?? null; + ?> +
  • + + Client « » absent du realm + + Rôle « » sur « » + () + + Pas de rôle « » sur « » + +
  • + + +
  • session 1 ? 's' : '' ?> ouverte 1 ? 's' : '' ?>
  • + +
+
+ + +
+

Identité

+
+
Identifiant
+
Nom
+
Adresse
+
+
État
+
Créé le
+
Actions requises
+ + + aucune
+
Authentification
+ + + + mot de passe : · + OTP : 1 ? ' (' . count($otp) . ' appareils)' : '') : 'non' ?> +
+ +
Fédération
compte fourni par une fédération ()
+ +
UUID
+
+
+ + +
+

Groupes

+ +
+ +

Membre d'aucun groupe.

+ +

+ +
+ + +
+

Rôles

+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + +
PortéeRôles effectifsDont attribués directement
realm
client client absent du realm
+

+ Les rôles effectifs comprennent ceux hérités des groupes et des rôles composites ; c'est ce que + l'application lit dans le jeton, si la portée du client l'y laisse passer. +

+
+ + +
+

Sessions ouvertes

+ +
+ +

Aucune session ouverte.

+ + + + + + + + + + + + + +
IPDébutDernier accèsApplications
+ +

Sessions SSO seulement : les sessions hors ligne (« se souvenir de moi » d'une application mobile) n'y figurent pas.

+
+
+ + diff --git a/web/admin/groups.php b/web/admin/groups.php index f15959d..290176e 100644 --- a/web/admin/groups.php +++ b/web/admin/groups.php @@ -39,7 +39,12 @@ if ($_SERVER['REQUEST_METHOD'] === 'POST') { } } -$groups = kc_list_groups(); +$groups = []; +try { + $groups = kc_list_groups(); +} catch (RuntimeException $ex) { + $errors[] = $ex->getMessage(); +} $services = services_list(); // Indexe les services par groupe requis @@ -80,12 +85,17 @@ require __DIR__ . '/../views/layout.php'; getMessage(); + } $linked = $services_by_group[$g['name']] ?? []; ?> - + ?' : e($nb_membres) ?> diff --git a/web/admin/members.php b/web/admin/members.php index 38d57ee..b51d04a 100644 --- a/web/admin/members.php +++ b/web/admin/members.php @@ -10,9 +10,12 @@ $users = []; $kc_error = null; try { - $users = kc_list_users(); -} catch (Exception $e) { - $kc_error = $e->getMessage(); + $users = kc_list_users(); + $groupes = kc_noms_groupes_par_compte(); + foreach ($users as &$u) $u['groupNames'] = $groupes[$u['id']] ?? []; + unset($u); +} catch (RuntimeException $ex) { + $kc_error = $ex->getMessage(); } // Sépare adhérents et inscrits en attente @@ -34,7 +37,7 @@ require __DIR__ . '/../views/layout.php'; -
Erreur Keycloak :
+
@@ -52,8 +55,8 @@ require __DIR__ . '/../views/layout.php'; - - + + @@ -88,8 +91,8 @@ require __DIR__ . '/../views/layout.php'; - - + + diff --git a/web/admin/services.php b/web/admin/services.php index 6646a7c..fe4a195 100644 --- a/web/admin/services.php +++ b/web/admin/services.php @@ -8,9 +8,21 @@ session_start_safe(); require_admin(); csrf_verifier(); -$kc_groups = kc_list_groups(); +$kc_erreur = null; +try { + $kc_groups = kc_list_groups(); +} catch (RuntimeException $ex) { + $kc_groups = []; + $kc_erreur = $ex->getMessage(); +} $group_names = array_column($kc_groups, 'name'); +if ($_SERVER['REQUEST_METHOD'] === 'POST' && $kc_erreur) { + set_flash('error', 'Rien n\'a été enregistré : sans la liste des groupes, les groupes requis des services auraient été effacés.'); + header('Location: /admin/services.php'); + exit; +} + if ($_SERVER['REQUEST_METHOD'] === 'POST') { $updated = []; foreach ($_POST as $key => $val) { @@ -55,6 +67,10 @@ require __DIR__ . '/../views/layout.php'; + +
+ +
diff --git a/web/assets/style.css b/web/assets/style.css index 8d3d2d8..ec496d5 100644 --- a/web/assets/style.css +++ b/web/assets/style.css @@ -236,7 +236,7 @@ dd { font-size: .9rem; } .admin-page { max-width: 1000px; } .page-header { display: flex; align-items: center; justify-content: space-between; margin-bottom: 1.5rem; } .page-header h1 { font-size: 1.4rem; } -.admin-nav { display: flex; gap: .5rem; } +.admin-nav { display: flex; gap: .5rem; flex-wrap: wrap; } .admin-nav a { padding: .4rem .9rem; border-radius: var(--radius); font-size: .85rem; color: var(--text-muted); @@ -395,6 +395,31 @@ td.center { text-align: center; } white-space: pre-line; } +/* ── Console : fiche d'un compte ──────────────────────────────────── */ +.badge-danger { background: #fdecea; color: var(--danger); } +.alert-info { background: #eef1ff; border: 1px solid var(--primary); color: var(--primary); } +.alert-warning{ background: #fef3d0; border: 1px solid var(--warning); color: #8a5c00; } +.diagnostic { list-style: none; display: flex; flex-direction: column; gap: .35rem; font-size: .9rem; } +.diagnostic li { padding-left: 1.6rem; position: relative; } +.diagnostic li::before { position: absolute; left: 0; width: 1.2rem; text-align: center; font-weight: 700; } +.diagnostic li.ok::before { content: "✓"; color: var(--success); } +.diagnostic li.alerte::before { content: "!"; color: var(--danger); } +.diagnostic li.neutre::before { content: "·"; color: var(--text-muted); } +.diagnostic li.alerte { color: var(--danger); } +.fiche td, .fiche dd { overflow-wrap: anywhere; } +.fiche code { font-size: .8rem; } +.gestes { display: flex; flex-wrap: wrap; gap: .6rem; align-items: flex-start; } +.gestes form { display: inline-flex; gap: .4rem; align-items: center; flex-wrap: wrap; } +.gestes select, .recherche input[type=search], .recherche select, .gestes input[type=search] { + padding: .35rem .5rem; border: 1px solid var(--border); border-radius: var(--radius); + background: var(--bg2); color: var(--text); font-size: .85rem; +} +.recherche { display: flex; gap: .6rem; align-items: center; flex-wrap: wrap; margin-bottom: 1rem; } +.recherche input[type=search] { flex: 1; min-width: 12rem; } +.pagination { display: flex; gap: 1rem; align-items: center; margin-top: 1rem; font-size: .85rem; } +.table-defile { overflow-x: auto; } +.journal-detail { font-size: .8rem; color: var(--text-muted); } + /* ── Footer ───────────────────────────────────────────────────────── */ footer { text-align: center; diff --git a/web/inc/config.php b/web/inc/config.php index 090e211..a36e25b 100644 --- a/web/inc/config.php +++ b/web/inc/config.php @@ -45,6 +45,12 @@ define('ADMIN_GROUPS', array_filter(explode(',', env('ADMIN_GROUPS', 'admi define('ADHERENT_GROUP', env('ADHERENT_GROUP', 'adherents')); define('SERVICES_FILE', env('SERVICES_FILE', dirname(__DIR__, 2) . '/services.json')); +// ── Console d'administration ────────────────────────────────────────── +// Rôles client pointés en tête de la fiche d'un compte, sous la forme +// « client:rôle », séparés par des virgules. +define('ROLES_SURVEILLES', array_values(array_filter(array_map('trim', explode(',', + env('ROLES_SURVEILLES', 'messagerie:messagerie-admin,messagerie:messagerie-mailperso')))))); + // ── HelloAsso API ────────────────────────────────────────────────────── define('HA_CLIENT_ID', env('HA_CLIENT_ID')); define('HA_CLIENT_SECRET', env('HA_CLIENT_SECRET')); diff --git a/web/inc/keycloak.php b/web/inc/keycloak.php index bc958c2..1727b36 100644 --- a/web/inc/keycloak.php +++ b/web/inc/keycloak.php @@ -20,10 +20,19 @@ function _kc_admin_token(): string { ]); $body = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); + $erreur = curl_error($ch); curl_close($ch); + if ($status === 0) { + throw new RuntimeException("Keycloak injoignable pour obtenir le jeton du compte de service : $erreur", 0); + } + if ($status === 400 || $status === 401) { + throw new RuntimeException('Le compte de service « ' . KC_SERVICE_CLIENT_ID . ' » est refusé par Keycloak' + . " ($status) : vérifier KC_SERVICE_CLIENT_SECRET dans le .env, et que « Service accounts roles »" + . ' est coché sur ce client dans le realm master.', $status); + } if ($status !== 200) { - throw new RuntimeException("Authentification Keycloak Admin échouée ($status)"); + throw new RuntimeException("Authentification Keycloak Admin échouée ($status)", $status); } $data = json_decode($body, true); $cache = ['token' => $data['access_token'], 'expires' => time() + $data['expires_in'] - 10]; @@ -50,12 +59,55 @@ function _kc_request(string $method, string $path, mixed $body = null): array { $response = curl_exec($ch); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); $header_size = curl_getinfo($ch, CURLINFO_HEADER_SIZE); + $erreur = curl_error($ch); curl_close($ch); + $response = is_string($response) ? $response : ''; $resp_headers = substr($response, 0, $header_size); $resp_body = substr($response, $header_size); - return ['status' => $status, 'headers' => $resp_headers, 'body' => $resp_body]; + return ['status' => $status, 'headers' => $resp_headers, 'body' => $resp_body, 'erreur' => $erreur]; +} + +// ── Erreurs de l'API d'administration ───────────────────────────────── +// Le compte de service vit dans le realm master. Ses droits sur le realm +// administré sont les rôles du client « -realm » du realm master +// (« master-realm » quand on administre master lui-même) : c'est là que +// Keycloak range, pour un compte de master, l'équivalent des rôles +// realm-management (view-users, manage-users, view-events, view-clients…). +function kc_client_droits(): string { + return ALPID_REALM . '-realm'; +} + +// Vérifie la réponse d'un appel et la décode. En cas d'échec, lève une +// RuntimeException dont le message dit quoi faire — en nommant le rôle +// manquant pour un 403 — et dont le code est le statut HTTP. +function _kc_attendre(array $resp, string $geste, string $role, int ...$attendus): mixed { + $attendus = $attendus ?: [200]; + $status = $resp['status']; + if (in_array($status, $attendus, true)) { + return $resp['body'] === '' ? null : json_decode($resp['body'], true); + } + $detail = json_decode($resp['body'], true); + $detail = is_array($detail) ? ($detail['errorMessage'] ?? $detail['error_description'] ?? $detail['error'] ?? '') : ''; + $detail = is_string($detail) && $detail !== '' ? " Keycloak précise : « $detail »." : ''; + + $message = match (true) { + $status === 0 => "Keycloak injoignable ($geste) : " . ($resp['erreur'] ?? '') . '.', + $status === 401 => "Keycloak a refusé le jeton du compte de service (401) pour : $geste.", + $status === 403 => "Refus de Keycloak (403) pour : $geste. Il manque au compte de service « " + . KC_SERVICE_CLIENT_ID . " » le rôle « $role » du client « " . kc_client_droits() + . ' » (rôles realm-management du realm ' . ALPID_REALM . '), à attribuer dans le realm master :' + . ' Clients → ' . KC_SERVICE_CLIENT_ID . ' → Service accounts roles → Assign role.', + $status === 404 => "Introuvable dans Keycloak (404) : $geste.$detail", + $status === 409 => "Conflit signalé par Keycloak (409) : $geste.$detail", + default => "Erreur Keycloak ($status) pour : $geste.$detail", + }; + throw new RuntimeException($message, $status); +} + +function kc_est_uuid(string $id): bool { + return (bool)preg_match('/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i', $id); } function _kc_encode_username(string $lastname): string { @@ -160,24 +212,45 @@ function kc_set_password(string $user_id, string $password): void { } } -function kc_list_users(int $max = 200): array { - $resp = _kc_request('GET', '/users?max=' . $max); - if ($resp['status'] !== 200) return []; - $users = json_decode($resp['body'], true) ?? []; +// Liste brute d'une page de comptes, sans les groupes. Lève une exception +// au lieu de renvoyer une liste vide : une liste vide doit vouloir dire +// « aucun compte », jamais « Keycloak a refusé ». +function kc_list_users(int $max = 200, int $first = 0, string $recherche = ''): array { + $params = ['first' => $first, 'max' => $max, 'briefRepresentation' => 'true']; + if ($recherche !== '') $params['search'] = $recherche; + $resp = _kc_request('GET', '/users?' . http_build_query($params)); + return _kc_attendre($resp, 'lister les comptes', 'view-users') ?? []; +} - foreach ($users as &$user) { - $gr = _kc_request('GET', "/users/{$user['id']}/groups"); - $user['groupNames'] = $gr['status'] === 200 - ? array_column(json_decode($gr['body'], true) ?? [], 'name') - : []; - } - return $users; +function kc_count_users(string $recherche = ''): int { + $query = $recherche !== '' ? '?' . http_build_query(['search' => $recherche]) : ''; + $resp = _kc_request('GET', '/users/count' . $query); + return (int)_kc_attendre($resp, 'compter les comptes', 'view-users'); } function kc_list_groups(): array { $resp = _kc_request('GET', '/groups?max=200&briefRepresentation=false'); - if ($resp['status'] !== 200) return []; - return json_decode($resp['body'], true) ?? []; + return _kc_attendre($resp, 'lister les groupes', 'view-users (ou query-groups)') ?? []; +} + +// Groupes à plat, sous-groupes compris, chacun avec son chemin (« /a/b »). +// Keycloak 23+ ne renvoie plus les sous-groupes dans /groups : on les +// demande alors à /groups/{id}/children quand subGroupCount l'annonce. +function kc_list_groups_plat(): array { + $plat = []; + $parcourir = function (array $groupes) use (&$parcourir, &$plat): void { + foreach ($groupes as $g) { + $plat[] = ['id' => $g['id'], 'name' => $g['name'], 'path' => $g['path'] ?? '/' . $g['name']]; + $enfants = $g['subGroups'] ?? []; + if (!$enfants && ($g['subGroupCount'] ?? 0) > 0) { + $resp = _kc_request('GET', "/groups/{$g['id']}/children?max=200"); + $enfants = _kc_attendre($resp, 'lister les sous-groupes', 'view-users (ou query-groups)') ?? []; + } + $parcourir($enfants); + } + }; + $parcourir(kc_list_groups()); + return $plat; } function kc_create_group(string $name): void { @@ -191,15 +264,14 @@ function kc_delete_group(string $group_id): void { if ($resp['status'] >= 300) throw new RuntimeException("Erreur suppression groupe ({$resp['status']})"); } -function kc_group_members(string $group_id, int $max = 200): array { - $resp = _kc_request('GET', "/groups/$group_id/members?max=$max"); - if ($resp['status'] !== 200) return []; - return json_decode($resp['body'], true) ?? []; +function kc_group_members(string $group_id, int $max = 200, int $first = 0): array { + $resp = _kc_request('GET', "/groups/$group_id/members?first=$first&max=$max&briefRepresentation=true"); + return _kc_attendre($resp, 'lister les membres d\'un groupe', 'view-users') ?? []; } function _kc_group_id(string $group_name): string { $resp = _kc_request('GET', '/groups?search=' . urlencode($group_name)); - $groups = json_decode($resp['body'], true) ?? []; + $groups = _kc_attendre($resp, "chercher le groupe « $group_name »", 'view-users (ou query-groups)') ?? []; foreach ($groups as $g) { if ($g['name'] === $group_name) return $g['id']; } @@ -221,3 +293,74 @@ function kc_remove_from_group(string $user_id, string $group_name): void { throw new RuntimeException("Erreur suppression groupe ({$resp['status']})"); } } + +// ── Lecture d'un compte (fiche de la console) ───────────────────────── + +// Noms des groupes de chaque compte, construits en lisant les membres de +// chaque groupe : un appel par groupe (et par tranche de 200 membres), au +// lieu d'un appel par compte. +function kc_noms_groupes_par_compte(): array { + $par_compte = []; + foreach (kc_list_groups_plat() as $g) { + for ($first = 0; ; $first += 200) { + $membres = kc_group_members($g['id'], 200, $first); + foreach ($membres as $m) $par_compte[$m['id']][] = $g['name']; + if (count($membres) < 200) break; + } + } + return $par_compte; +} + +function kc_get_user(string $user_id): array { + $resp = _kc_request('GET', "/users/$user_id"); + return _kc_attendre($resp, 'lire le compte', 'view-users') ?? []; +} + +function kc_user_groups(string $user_id): array { + $resp = _kc_request('GET', "/users/$user_id/groups?briefRepresentation=true"); + return _kc_attendre($resp, 'lire les groupes du compte', 'view-users') ?? []; +} + +function kc_user_credentials(string $user_id): array { + $resp = _kc_request('GET', "/users/$user_id/credentials"); + return _kc_attendre($resp, 'lire les moyens d\'authentification du compte', 'view-users') ?? []; +} + +// Rôles attribués directement au compte : realmMappings, et clientMappings +// indexé par clientId ({client, id, mappings: [...]}). +function kc_user_role_mappings(string $user_id): array { + $resp = _kc_request('GET', "/users/$user_id/role-mappings"); + return _kc_attendre($resp, 'lire les rôles du compte', 'view-users') ?? []; +} + +// Rôles realm effectifs : directs, hérités d'un groupe ou d'un rôle composite. +function kc_user_realm_roles_effectifs(string $user_id): array { + $resp = _kc_request('GET', "/users/$user_id/role-mappings/realm/composite?briefRepresentation=true"); + return _kc_attendre($resp, 'lire les rôles realm effectifs du compte', 'view-users') ?? []; +} + +// Identifiant interne (UUID) d'un client à partir de son clientId, ou null +// s'il n'existe pas dans le realm. +function kc_client_uuid(string $client_id): ?string { + static $cache = []; + if (array_key_exists($client_id, $cache)) return $cache[$client_id]; + $resp = _kc_request('GET', '/clients?' . http_build_query(['clientId' => $client_id, 'search' => 'false'])); + $clients = _kc_attendre($resp, "trouver le client « $client_id »", 'view-clients') ?? []; + foreach ($clients as $c) { + if (($c['clientId'] ?? '') === $client_id) return $cache[$client_id] = $c['id']; + } + return $cache[$client_id] = null; +} + +// Rôles effectifs du compte sur un client : ce que le jeton d'accès porterait +// dans resource_access..roles (sous réserve de la portée du client). +function kc_user_client_roles_effectifs(string $user_id, string $client_uuid): array { + $resp = _kc_request('GET', "/users/$user_id/role-mappings/clients/$client_uuid/composite?briefRepresentation=true"); + return _kc_attendre($resp, 'lire les rôles effectifs du compte sur un client', 'view-users') ?? []; +} + +// Sessions SSO ouvertes (les sessions hors ligne n'y figurent pas). +function kc_user_sessions(string $user_id): array { + $resp = _kc_request('GET', "/users/$user_id/sessions"); + return _kc_attendre($resp, 'lire les sessions du compte', 'view-users') ?? []; +}