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

+ +
+ + +
+

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') ?? []; +}