From 24f3296ec8733e0bf4bd4d7da4ae1056296f9928 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?C=C3=A9drix?= Date: Sat, 31 Oct 2026 08:50:32 +0100 Subject: [PATCH 1/5] Jeton CSRF sur tous les formulaires POST du portail (#4) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit csrf_jeton(), csrf_champ() et csrf_verifier() dans inc/auth.php : un jeton par session, comparé par hash_equals, réponse 400 s'il manque ou ne correspond pas. La vérification est appelée en tête de chaque page qui traite un POST — console d'administration (membres, validation, révocation, groupes, services) et pages des membres (profil, mot de passe, inscription, renouvellement d'adhésion) —, et chaque formulaire porte le champ caché. Ajoute aussi e(), l'échappement de sortie à utiliser dans tout nouveau code. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01V2csyno8m71DJFKYM1vgzV --- web/admin/groups.php | 3 +++ web/admin/members.php | 2 ++ web/admin/revoke.php | 1 + web/admin/services.php | 2 ++ web/admin/validate.php | 1 + web/helloasso/renew.php | 2 ++ web/inc/auth.php | 41 +++++++++++++++++++++++++++++++++++++++++ web/password.php | 2 ++ web/profile.php | 6 ++++++ web/register.php | 2 ++ 10 files changed, 62 insertions(+) diff --git a/web/admin/groups.php b/web/admin/groups.php index 0a64b27..f15959d 100644 --- a/web/admin/groups.php +++ b/web/admin/groups.php @@ -6,6 +6,7 @@ require_once __DIR__ . '/../inc/services.php'; session_start_safe(); require_admin(); +csrf_verifier(); $errors = []; $success = ''; @@ -97,6 +98,7 @@ require __DIR__ . '/../views/layout.php';
+ @@ -113,6 +115,7 @@ require __DIR__ . '/../views/layout.php';

Créer un groupe

+
diff --git a/web/admin/members.php b/web/admin/members.php index 5bfc1e2..38d57ee 100644 --- a/web/admin/members.php +++ b/web/admin/members.php @@ -58,6 +58,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') ?? []; +} From 3957414fae7136941b6cfd237d59fdb1d97196d0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?C=C3=A9drix?= Date: Sat, 31 Oct 2026 08:56:59 +0100 Subject: [PATCH 3/5] Gestes sur un compte depuis sa fiche (#6) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Activer ou désactiver, envoyer le courriel « nouveau mot de passe » (execute-actions-email UPDATE_PASSWORD) ou de vérification d'adresse, retirer l'OTP, fermer toutes les sessions, ajouter à un groupe existant ou retirer d'un groupe. Chaque geste est un POST protégé par le jeton CSRF vers la fiche elle-même ; le résultat revient par flash, puis redirection. Garde-fous : un administrateur ne peut ni désactiver son propre compte, ni se retirer d'un groupe d'ADMIN_GROUPS ; fermer ses propres sessions demande de cocher une case qui dit ce que cela fait. Un 500 sur un envoi de courriel renvoie vers la configuration SMTP du realm. kc_modifier_compte() relit la représentation complète avant le PUT, pour ne rien écraser (attributs, actions requises) ; kc_update_name() et kc_update_email(), utilisées par le profil, passent aussi par elle. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01V2csyno8m71DJFKYM1vgzV --- web/admin/compte.php | 170 ++++++++++++++++++++++++++++++++++++++++++- web/assets/style.css | 1 + web/inc/keycloak.php | 84 +++++++++++++++++---- 3 files changed, 240 insertions(+), 15 deletions(-) diff --git a/web/admin/compte.php b/web/admin/compte.php index 2b067c9..50c55e7 100644 --- a/web/admin/compte.php +++ b/web/admin/compte.php @@ -9,6 +9,7 @@ require_once __DIR__ . '/../inc/keycloak.php'; session_start_safe(); require_admin(); +csrf_verifier(); $id = (string)($_GET['id'] ?? ''); if (!kc_est_uuid($id)) { @@ -26,6 +27,76 @@ $moi = current_user(); $soi = $id === ($moi['sub'] ?? ''); $url_moi = '/admin/compte.php?id=' . rawurlencode($id); +// ── Gestes ──────────────────────────────────────────────────────────── +// Chaque geste est un POST vers la fiche elle-même ; le résultat revient par +// flash, puis redirection vers la fiche (pas de nouveau POST au rechargement). +// Renvoie [type de flash, message, détail pour le journal]. +function _fiche_geste(string $geste, string $id, bool $soi, array $post): array { + switch ($geste) { + case 'activer': + kc_set_enabled($id, true); + return ['success', 'Compte activé.', '']; + + case 'desactiver': + if ($soi) return ['error', 'Refusé : vous ne pouvez pas désactiver votre propre compte, vous perdriez l\'accès à la console.', 'refus : son propre compte']; + kc_set_enabled($id, false); + return ['success', 'Compte désactivé : la personne ne peut plus se connecter. Ses sessions déjà ouvertes restent valides jusqu\'à ce que vous les fermiez.', '']; + + case 'courriel_mdp': + kc_execute_actions_email($id, ['UPDATE_PASSWORD']); + return ['success', 'Courriel envoyé : la personne y trouvera un lien pour choisir un nouveau mot de passe.', 'UPDATE_PASSWORD']; + + case 'courriel_verif': + kc_send_verify_email($id); + return ['success', 'Courriel de vérification d\'adresse envoyé.', '']; + + case 'retirer_otp': + $n = kc_retirer_otp($id); + return $n + ? ['success', $n > 1 ? "$n OTP retirés." : 'OTP retiré.', "$n retiré(s)"] + : ['warning', 'Ce compte n\'avait pas d\'OTP : rien n\'a été retiré.', 'aucun OTP']; + + case 'fermer_sessions': + if ($soi && empty($post['confirmer_soi'])) { + return ['warning', 'Rien n\'a été fait : c\'est votre propre compte. Cochez la case de confirmation pour fermer aussi vos sessions dans les autres applications.', 'refus : confirmation absente']; + } + kc_logout_user($id); + return ['success', $soi + ? 'Vos sessions AlpID sont fermées : les autres applications vous redemanderont de vous connecter. Votre session sur ce portail reste ouverte.' + : 'Toutes les sessions du compte sont fermées.', '']; + + case 'ajouter_groupe': + case 'retirer_groupe': + $gid = (string)($post['groupe'] ?? ''); + if (!kc_est_uuid($gid)) return ['error', 'Groupe invalide.', "groupe : $gid"]; + $noms = array_column(kc_list_groups_plat(), 'name', 'id'); + if (!isset($noms[$gid])) return ['error', 'Ce groupe n\'existe pas (ou plus) dans Keycloak.', "groupe : $gid"]; + $nom = $noms[$gid]; + if ($geste === 'ajouter_groupe') { + kc_ajouter_groupe($id, $gid); + return ['success', "Compte ajouté au groupe « $nom ».", "groupe : $nom"]; + } + if ($soi && in_array($nom, ADMIN_GROUPS, true)) { + return ['error', "Refusé : vous ne pouvez pas vous retirer vous-même du groupe « $nom », vous perdriez l'accès à la console.", "refus : groupe $nom, son propre compte"]; + } + kc_retirer_groupe($id, $gid); + return ['success', "Compte retiré du groupe « $nom ».", "groupe : $nom"]; + } + return ['error', 'Geste inconnu.', $geste]; +} + +if ($_SERVER['REQUEST_METHOD'] === 'POST') { + $geste = (string)($_POST['geste'] ?? ''); + try { + [$type, $message, $detail] = _fiche_geste($geste, $id, $soi, $_POST); + } catch (RuntimeException $ex) { + [$type, $message, $detail] = ['error', 'Échec : ' . $ex->getMessage(), '']; + } + set_flash($type, $message); + header('Location: ' . $url_moi); + exit; +} + // 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 { @@ -112,6 +183,9 @@ foreach ($clients_vus as $client_id) { } $noms_groupes = $groupes === null ? [] : array_column($groupes, 'name'); +$tous_groupes = _fiche_lire(fn() => kc_list_groups_plat(), $erreurs, 'tous_groupes'); +$ids_miens = $groupes === null ? [] : array_column($groupes, 'id'); +$a_ajouter = $tous_groupes === null ? [] : array_values(array_filter($tous_groupes, fn($g) => !in_array($g['id'], $ids_miens, true))); $actions = $compte['requiredActions'] ?? []; $nom_complet = trim(($compte['firstName'] ?? '') . ' ' . ($compte['lastName'] ?? '')); @@ -180,6 +254,79 @@ require __DIR__ . '/../views/layout.php'; + +
+

Gestes

+
+ + + + + + + + + +
+ + + +
+ + + +
+ + + +
+
+ + + +
+ + + +
+ + + +
+ + +
+ + + + + + +
+ + +
+ + + + + +
+ +
+ +

C'est votre compte : vous ne pouvez ni le désactiver, ni le retirer du groupe des administrateurs.

+ + +
+ +
+

Identité

@@ -216,7 +363,28 @@ require __DIR__ . '/../views/layout.php';

Membre d'aucun groupe.

-

+ + + + + + + + + +
+ + votre accès à la console + +
+ + + + +
+ +
diff --git a/web/assets/style.css b/web/assets/style.css index ec496d5..286d1c8 100644 --- a/web/assets/style.css +++ b/web/assets/style.css @@ -94,6 +94,7 @@ main { } .flash-success { background: #eaf7f0; border: 1px solid var(--success); color: var(--success); } .flash-error { background: #fdecea; border: 1px solid var(--danger); color: var(--danger); } +.flash-warning { background: #fef3d0; border: 1px solid var(--warning); color: #8a5c00; } /* ── Cards ────────────────────────────────────────────────────────── */ .card { diff --git a/web/inc/keycloak.php b/web/inc/keycloak.php index 1727b36..44b0c18 100644 --- a/web/inc/keycloak.php +++ b/web/inc/keycloak.php @@ -182,23 +182,11 @@ function kc_delete_credential(string $user_id, string $credential_id): void { } function kc_update_name(string $user_id, string $first_name, string $last_name): void { - $resp = _kc_request('PUT', "/users/$user_id", [ - 'firstName' => $first_name, - 'lastName' => $last_name, - ]); - if ($resp['status'] >= 300) { - throw new RuntimeException("Erreur mise à jour nom ({$resp['status']})"); - } + kc_modifier_compte($user_id, ['firstName' => $first_name, 'lastName' => $last_name], 'mettre à jour le nom'); } function kc_update_email(string $user_id, string $email): void { - $resp = _kc_request('PUT', "/users/$user_id", [ - 'email' => $email, - 'emailVerified' => false, - ]); - if ($resp['status'] >= 300) { - throw new RuntimeException("Erreur mise à jour email ({$resp['status']})"); - } + kc_modifier_compte($user_id, ['email' => $email, 'emailVerified' => false], 'mettre à jour l\'adresse'); } function kc_set_password(string $user_id, string $password): void { @@ -364,3 +352,71 @@ 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') ?? []; } + +// ── Gestes sur un compte ────────────────────────────────────────────── + +// Modifie un compte sans écraser le reste : la représentation complète est +// relue, seuls les champs demandés changent, et le tout est renvoyé. Un PUT +// partiel peut effacer les attributs absents avec le profil déclaratif de +// Keycloak récent. +function kc_modifier_compte(string $user_id, array $changements, string $geste): void { + $complet = kc_get_user($user_id); + unset($complet['access'], $complet['userProfileMetadata']); + $resp = _kc_request('PUT', "/users/$user_id", array_replace($complet, $changements)); + _kc_attendre($resp, $geste, 'manage-users', 204, 200); +} + +function kc_set_enabled(string $user_id, bool $actif): void { + kc_modifier_compte($user_id, ['enabled' => $actif], $actif ? 'activer le compte' : 'désactiver le compte'); +} + +// Un 500 sur un envoi de courriel vient presque toujours du SMTP du realm. +function _kc_courriel(array $resp, string $geste): void { + try { + _kc_attendre($resp, $geste, 'manage-users', 204, 200); + } catch (RuntimeException $ex) { + if ($ex->getCode() >= 500) { + throw new RuntimeException($ex->getMessage() . ' Keycloak n\'a pas pu envoyer le courriel : vérifier la configuration' + . ' du serveur d\'envoi du realm ' . ALPID_REALM . ' (Realm settings → Email).', $ex->getCode()); + } + throw $ex; + } +} + +function kc_execute_actions_email(string $user_id, array $actions): void { + $resp = _kc_request('PUT', "/users/$user_id/execute-actions-email", array_values($actions)); + _kc_courriel($resp, 'envoyer le courriel d\'actions (' . implode(', ', $actions) . ')'); +} + +function kc_send_verify_email(string $user_id): void { + $resp = _kc_request('PUT', "/users/$user_id/send-verify-email"); + _kc_courriel($resp, 'envoyer le courriel de vérification d\'adresse'); +} + +// Retire tous les OTP du compte ; renvoie le nombre retiré. +function kc_retirer_otp(string $user_id): int { + $n = 0; + foreach (kc_user_credentials($user_id) as $c) { + if (($c['type'] ?? '') !== 'otp') continue; + $resp = _kc_request('DELETE', "/users/$user_id/credentials/{$c['id']}"); + _kc_attendre($resp, 'retirer l\'OTP', 'manage-users', 204, 200); + $n++; + } + return $n; +} + +// Ferme toutes les sessions SSO du compte. +function kc_logout_user(string $user_id): void { + $resp = _kc_request('POST', "/users/$user_id/logout"); + _kc_attendre($resp, 'fermer les sessions du compte', 'manage-users', 204, 200); +} + +function kc_ajouter_groupe(string $user_id, string $group_id): void { + $resp = _kc_request('PUT', "/users/$user_id/groups/$group_id"); + _kc_attendre($resp, 'ajouter le compte à un groupe', 'manage-users', 204, 200); +} + +function kc_retirer_groupe(string $user_id, string $group_id): void { + $resp = _kc_request('DELETE', "/users/$user_id/groups/$group_id"); + _kc_attendre($resp, 'retirer le compte d\'un groupe', 'manage-users', 204, 200); +} From b399db012cc60c6247a8d910371836e1442434ac Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?C=C3=A9drix?= Date: Sat, 31 Oct 2026 09:01:12 +0100 Subject: [PATCH 4/5] =?UTF-8?q?Recherche,=20derniers=20=C3=A9v=C3=A9nement?= =?UTF-8?q?s=20et=20journal=20de=20la=20console=20(#7)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Membres : un champ de recherche (?q=, formulaire GET ordinaire) qui interroge /users?search=, et une pagination par 50 avec le total (/users/count) au lieu de la limite muette de 200. Un compte désactivé ou une adresse non vérifiée se voient dans la liste ; valider ou révoquer ramène à la même page de résultats. Fiche : les 20 derniers événements du compte (/events?user=), en clair — connexion, échec et sa raison, client, IP. Si le realm n'enregistre pas les événements (/events/config), ou si le rôle view-events manque, la fiche le dit et indique où l'activer dans Keycloak. Journal : chaque geste de la console — fiche, validation et révocation d'adhésion, création et suppression de groupe, paramétrage des services — ajoute une ligne JSON (date, administrateur, action, compte visé, détail, résultat) sous verrou exclusif dans JOURNAL_FILE, par défaut private/journal-console.jsonl à côté du .env (PRIVATE_DIR). Si l'écriture échoue, le message de retour le signale. /admin/journal.php montre les 200 dernières lignes, ou celles d'un compte ; la fiche montre les gestes qui le concernent. La navigation de la console, recopiée dans chaque page, devient le partial views/admin_nav.php, avec l'onglet « Journal ». Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01V2csyno8m71DJFKYM1vgzV --- web/admin/compte.php | 137 ++++++++++++++++++++++++++++++++++++-- web/admin/groups.php | 29 +++++--- web/admin/journal.php | 75 +++++++++++++++++++++ web/admin/members.php | 144 ++++++++++++++++++++++++---------------- web/admin/revoke.php | 17 +++-- web/admin/services.php | 11 ++- web/admin/validate.php | 17 +++-- web/inc/config.php | 10 ++- web/inc/journal.php | 86 ++++++++++++++++++++++++ web/inc/keycloak.php | 15 +++++ web/views/admin_nav.php | 15 +++++ 11 files changed, 465 insertions(+), 91 deletions(-) create mode 100644 web/admin/journal.php create mode 100644 web/inc/journal.php create mode 100644 web/views/admin_nav.php diff --git a/web/admin/compte.php b/web/admin/compte.php index 50c55e7..98b2514 100644 --- a/web/admin/compte.php +++ b/web/admin/compte.php @@ -6,6 +6,7 @@ require_once __DIR__ . '/../inc/config.php'; require_once __DIR__ . '/../inc/auth.php'; require_once __DIR__ . '/../inc/keycloak.php'; +require_once __DIR__ . '/../inc/journal.php'; session_start_safe(); require_admin(); @@ -88,11 +89,25 @@ function _fiche_geste(string $geste, string $id, bool $soi, array $post): array if ($_SERVER['REQUEST_METHOD'] === 'POST') { $geste = (string)($_POST['geste'] ?? ''); try { - [$type, $message, $detail] = _fiche_geste($geste, $id, $soi, $_POST); + $libelle = kc_get_user($id)['username'] ?? ''; } catch (RuntimeException $ex) { - [$type, $message, $detail] = ['error', 'Échec : ' . $ex->getMessage(), '']; + $libelle = ''; } - set_flash($type, $message); + try { + [$type, $message, $detail] = _fiche_geste($geste, $id, $soi, $_POST); + $resultat = match ($type) { + 'success' => 'ok', + 'warning' => 'sans effet', + default => str_starts_with($message, 'Refusé') ? 'refusé' : 'échec : ' . $message, + }; + } catch (RuntimeException $ex) { + $type = 'error'; + $message = 'Échec : ' . $ex->getMessage(); + $detail = isset($_POST['groupe']) ? 'groupe : ' . (string)$_POST['groupe'] : ''; + $resultat = 'échec : ' . $ex->getMessage(); + } + $ecrit = journal_ecrire($geste, $id, $libelle, $detail, $resultat); + set_flash($type, $message . journal_avertissement($ecrit)); header('Location: ' . $url_moi); exit; } @@ -114,6 +129,40 @@ function _fiche_date(int|float|null $ms): string { } // Ce qu'une action requise imposera à la prochaine connexion. +// Types d'événements et erreurs les plus courants, en clair. +const EVENEMENTS = [ + 'LOGIN' => 'connexion', + 'LOGIN_ERROR' => 'échec de connexion', + 'LOGOUT' => 'déconnexion', + 'LOGOUT_ERROR' => 'échec de déconnexion', + 'CODE_TO_TOKEN' => 'échange du code', + 'CODE_TO_TOKEN_ERROR'=> 'échec de l\'échange du code', + 'REFRESH_TOKEN' => 'renouvellement du jeton', + 'REFRESH_TOKEN_ERROR'=> 'échec du renouvellement', + 'UPDATE_PASSWORD' => 'mot de passe changé', + 'UPDATE_TOTP' => 'OTP configuré', + 'REMOVE_TOTP' => 'OTP retiré', + 'VERIFY_EMAIL' => 'adresse vérifiée', + 'SEND_VERIFY_EMAIL' => 'courriel de vérification envoyé', + 'SEND_RESET_PASSWORD'=> 'courriel de mot de passe envoyé', + 'EXECUTE_ACTIONS' => 'courriel d\'actions envoyé', + 'UPDATE_PROFILE' => 'profil modifié', + 'REGISTER' => 'inscription', +]; +const ERREURS_EVENEMENT = [ + 'invalid_user_credentials' => 'mot de passe erroné', + 'user_disabled' => 'compte désactivé', + 'user_temporarily_disabled'=> 'compte bloqué temporairement (trop d\'essais)', + 'user_not_found' => 'compte inconnu', + 'invalid_redirect_uri' => 'adresse de retour refusée par le client', + 'not_allowed' => 'refusé par la politique du client', + 'expired_code' => 'code expiré', + 'invalid_code' => 'code invalide', + 'invalid_totp' => 'code OTP erroné', + 'email_not_verified' => 'adresse non vérifiée', + 'session_expired' => 'session expirée', +]; + const ACTIONS_REQUISES = [ 'UPDATE_PASSWORD' => 'changer son mot de passe', 'VERIFY_EMAIL' => 'vérifier son adresse', @@ -153,6 +202,9 @@ $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'); +$evenements = _fiche_lire(fn() => kc_user_events($id, 20), $erreurs, 'evenements'); +$reglages_evts = $evenements === null ? null : _fiche_lire(fn() => kc_events_config(), $erreurs, 'reglages_evts'); +$gestes_journal = _fiche_lire(fn() => journal_lire(50, $id), $erreurs, 'journal'); $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'); @@ -196,8 +248,9 @@ require __DIR__ . '/../views/layout.php';
+

← Retour à la liste des membres

C'est votre propre compte.
@@ -449,6 +502,82 @@ require __DIR__ . '/../views/layout.php';

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

+ +
+

Derniers événements de connexion

+ + +
+ +
+ L'enregistrement des événements de connexion n'est pas activé dans le realm : + Keycloak ne garde aucune trace des connexions. +
+ +

+ Aucun événement enregistré pour ce compte + sur la durée de conservation ( jours). + + Les réglages du realm n'ont pas pu être lus : si l'enregistrement est désactivé, la liste reste vide. + +

+ +
+ + + + + + + + + + + + + +
DateÉvénementApplicationIPErreur
+
+ + +

+ + +

Le realm n'enregistre qu'une partie des types d'événements, et LOGIN n'en fait pas partie.

+ +
+ + +
+

Gestes de la console sur ce compte

+ +
+ +

Aucun geste de la console sur ce compte.

+ +
+ + + + + + + + + + + + + +
DateParGesteDétailRésultat
+
+

Voir dans le journal

+ +
diff --git a/web/admin/groups.php b/web/admin/groups.php index 290176e..d2c2184 100644 --- a/web/admin/groups.php +++ b/web/admin/groups.php @@ -3,6 +3,7 @@ require_once __DIR__ . '/../inc/config.php'; require_once __DIR__ . '/../inc/auth.php'; require_once __DIR__ . '/../inc/keycloak.php'; require_once __DIR__ . '/../inc/services.php'; +require_once __DIR__ . '/../inc/journal.php'; session_start_safe(); require_admin(); @@ -21,20 +22,29 @@ if ($_SERVER['REQUEST_METHOD'] === 'POST') { } else { try { kc_create_group($name); - set_flash('success', "Groupe « $name » créé."); + $ecrit = journal_ecrire('creer_groupe', '', '', "groupe : $name"); + set_flash('success', "Groupe « $name » créé." . journal_avertissement($ecrit)); header('Location: /admin/groups.php'); exit; - } catch (Exception $e) { $errors[] = $e->getMessage(); } + } catch (Exception $e) { + journal_ecrire('creer_groupe', '', '', "groupe : $name", 'échec : ' . $e->getMessage()); + $errors[] = $e->getMessage(); + } } } if ($action === 'delete') { - $group_id = $_POST['group_id'] ?? ''; - if ($group_id) { + $group_id = (string)($_POST['group_id'] ?? ''); + $nom = (string)($_POST['group_name'] ?? ''); + if (kc_est_uuid($group_id)) { try { kc_delete_group($group_id); - set_flash('success', 'Groupe supprimé.'); + $ecrit = journal_ecrire('supprimer_groupe', '', '', "groupe : $nom ($group_id)"); + set_flash('success', 'Groupe supprimé.' . journal_avertissement($ecrit)); header('Location: /admin/groups.php'); exit; - } catch (Exception $e) { $errors[] = $e->getMessage(); } + } catch (Exception $e) { + journal_ecrire('supprimer_groupe', '', '', "groupe : $nom ($group_id)", 'échec : ' . $e->getMessage()); + $errors[] = $e->getMessage(); + } } } } @@ -62,11 +72,7 @@ require __DIR__ . '/../views/layout.php';
@@ -111,6 +117,7 @@ require __DIR__ . '/../views/layout.php'; + diff --git a/web/admin/journal.php b/web/admin/journal.php new file mode 100644 index 0000000..968b8bd --- /dev/null +++ b/web/admin/journal.php @@ -0,0 +1,75 @@ +). +require_once __DIR__ . '/../inc/config.php'; +require_once __DIR__ . '/../inc/auth.php'; +require_once __DIR__ . '/../inc/keycloak.php'; +require_once __DIR__ . '/../inc/journal.php'; + +session_start_safe(); +require_admin(); + +$compte = (string)($_GET['compte'] ?? ''); +if ($compte !== '' && !kc_est_uuid($compte)) $compte = ''; + +$erreur = null; +try { + $gestes = journal_lire(200, $compte !== '' ? $compte : null); +} catch (RuntimeException $ex) { + $gestes = []; + $erreur = $ex->getMessage(); +} + +$title = 'Journal de la console'; +require __DIR__ . '/../views/layout.php'; +?> + +
+ + + +
+ + +
+

+ + Gestes sur le compte — + tout le journal + + Les derniers gestes + +

+ +

Aucun geste inscrit au journal.

+ +
+ + + + + + + + + + + + + + +
DateParGesteCompteDétailRésultat
+ + + — +
+
+ +

Fichier : , une ligne JSON par geste.

+
+
+ + diff --git a/web/admin/members.php b/web/admin/members.php index b51d04a..6e6fec9 100644 --- a/web/admin/members.php +++ b/web/admin/members.php @@ -6,22 +6,72 @@ require_once __DIR__ . '/../inc/keycloak.php'; session_start_safe(); require_admin(); -$users = []; -$kc_error = null; +const MEMBRES_PAR_PAGE = 50; + +$q = trim((string)($_GET['q'] ?? '')); +$page = max(1, (int)($_GET['page'] ?? 1)); +$users = []; +$total = null; +$suite = false; +$kc_error = null; try { - $users = kc_list_users(); + // Une ligne de plus que la page : sa présence dit qu'il y a une suite. + $users = kc_list_users(MEMBRES_PAR_PAGE + 1, ($page - 1) * MEMBRES_PAR_PAGE, $q); + $suite = count($users) > MEMBRES_PAR_PAGE; + $users = array_slice($users, 0, MEMBRES_PAR_PAGE); $groupes = kc_noms_groupes_par_compte(); foreach ($users as &$u) $u['groupNames'] = $groupes[$u['id']] ?? []; unset($u); } catch (RuntimeException $ex) { $kc_error = $ex->getMessage(); } +try { + $total = kc_count_users($q); +} catch (RuntimeException $ex) { + $total = null; // le décompte n'est qu'un confort ; la liste suffit +} // Sépare adhérents et inscrits en attente $adherents = array_filter($users, fn($u) => in_array(ADHERENT_GROUP, $u['groupNames'], true)); $pending = array_filter($users, fn($u) => !in_array(ADHERENT_GROUP, $u['groupNames'], true)); +$url_page = fn(int $p) => '/admin/members.php' . (($qs = http_build_query(array_filter(['q' => $q, 'page' => $p > 1 ? $p : null]))) ? "?$qs" : ''); +$retour = $url_page($page); +$premier = ($page - 1) * MEMBRES_PAR_PAGE + 1; +$dernier = ($page - 1) * MEMBRES_PAR_PAGE + count($users); + +// Une ligne du tableau des comptes ; $geste vaut 'valider' ou 'revoquer'. +function membres_ligne(array $u, string $geste, string $retour): void { + $fiche = '/admin/compte.php?id=' . rawurlencode($u['id']); + $nom = trim(($u['firstName'] ?? '') . ' ' . ($u['lastName'] ?? '')); + ?> + + + désactivé + + + non vérifiée + + +
+ + + + + + + + + +
+ + + @@ -29,50 +79,42 @@ require __DIR__ . '/../views/layout.php';
+ +
+ +

+ +

+ Comptes à . + Les deux tableaux ne portent que sur cette page. +

+

En attente de validation ()

-

Aucun inscrit en attente.

+

Aucun inscrit en attente sur cette page.

+
- - - - - + - - - - - - - - - +
NomIdentifiantEmailGroupesActions
NomIdentifiantEmailGroupesActions
-
- - - -
-
+
@@ -80,37 +122,27 @@ require __DIR__ . '/../views/layout.php';

Adhérents ()

-

Aucun adhérent.

+

Aucun adhérent sur cette page.

+
- - - - - + - - - - - - - - - +
NomIdentifiantEmailGroupesActions
NomIdentifiantEmailGroupesActions
-
- - - -
-
+
+ + + 1 || $suite): ?> + +
diff --git a/web/admin/revoke.php b/web/admin/revoke.php index 91d4b1f..04c1414 100644 --- a/web/admin/revoke.php +++ b/web/admin/revoke.php @@ -2,22 +2,27 @@ require_once __DIR__ . '/../inc/config.php'; require_once __DIR__ . '/../inc/auth.php'; require_once __DIR__ . '/../inc/keycloak.php'; +require_once __DIR__ . '/../inc/journal.php'; session_start_safe(); require_admin(); csrf_verifier(); -if ($_SERVER['REQUEST_METHOD'] !== 'POST' || empty($_POST['user_id'])) { +$user_id = (string)($_POST['user_id'] ?? ''); +if ($_SERVER['REQUEST_METHOD'] !== 'POST' || !kc_est_uuid($user_id)) { header('Location: /admin/members.php'); exit; } +$libelle = (string)($_POST['libelle'] ?? ''); try { - kc_remove_from_group($_POST['user_id'], ADHERENT_GROUP); - set_flash('success', 'Adhésion révoquée.'); -} catch (Exception $e) { - set_flash('error', 'Erreur : ' . $e->getMessage()); + kc_remove_from_group($user_id, ADHERENT_GROUP); + $ecrit = journal_ecrire('revoquer_adhesion', $user_id, $libelle, 'groupe : ' . ADHERENT_GROUP); + set_flash('success', 'Adhésion révoquée.' . journal_avertissement($ecrit)); +} catch (Exception $ex) { + $ecrit = journal_ecrire('revoquer_adhesion', $user_id, $libelle, 'groupe : ' . ADHERENT_GROUP, 'échec : ' . $ex->getMessage()); + set_flash('error', 'Erreur : ' . $ex->getMessage() . journal_avertissement($ecrit)); } -header('Location: /admin/members.php'); +header('Location: ' . (str_starts_with((string)($_POST['retour'] ?? ''), '/admin/') ? $_POST['retour'] : '/admin/members.php')); exit; diff --git a/web/admin/services.php b/web/admin/services.php index fe4a195..c578d10 100644 --- a/web/admin/services.php +++ b/web/admin/services.php @@ -3,6 +3,7 @@ require_once __DIR__ . '/../inc/config.php'; require_once __DIR__ . '/../inc/auth.php'; require_once __DIR__ . '/../inc/services.php'; require_once __DIR__ . '/../inc/keycloak.php'; +require_once __DIR__ . '/../inc/journal.php'; session_start_safe(); require_admin(); @@ -47,7 +48,9 @@ if ($_SERVER['REQUEST_METHOD'] === 'POST') { ]; } services_save($updated); - set_flash('success', 'Services sauvegardés.'); + $ecrit = journal_ecrire('enregistrer_services', '', '', count($updated) . ' service(s) : ' + . implode(', ', array_column($updated, 'name'))); + set_flash('success', 'Services sauvegardés.' . journal_avertissement($ecrit)); header('Location: /admin/services.php'); exit; } @@ -60,11 +63,7 @@ require __DIR__ . '/../views/layout.php';
diff --git a/web/admin/validate.php b/web/admin/validate.php index 02a9817..6ba3b18 100644 --- a/web/admin/validate.php +++ b/web/admin/validate.php @@ -2,22 +2,27 @@ require_once __DIR__ . '/../inc/config.php'; require_once __DIR__ . '/../inc/auth.php'; require_once __DIR__ . '/../inc/keycloak.php'; +require_once __DIR__ . '/../inc/journal.php'; session_start_safe(); require_admin(); csrf_verifier(); -if ($_SERVER['REQUEST_METHOD'] !== 'POST' || empty($_POST['user_id'])) { +$user_id = (string)($_POST['user_id'] ?? ''); +if ($_SERVER['REQUEST_METHOD'] !== 'POST' || !kc_est_uuid($user_id)) { header('Location: /admin/members.php'); exit; } +$libelle = (string)($_POST['libelle'] ?? ''); try { - kc_add_to_group($_POST['user_id'], ADHERENT_GROUP); - set_flash('success', 'Membre validé — groupe « ' . ADHERENT_GROUP . ' » assigné.'); -} catch (Exception $e) { - set_flash('error', 'Erreur : ' . $e->getMessage()); + kc_add_to_group($user_id, ADHERENT_GROUP); + $ecrit = journal_ecrire('valider_adhesion', $user_id, $libelle, 'groupe : ' . ADHERENT_GROUP); + set_flash('success', 'Membre validé — groupe « ' . ADHERENT_GROUP . ' » assigné.' . journal_avertissement($ecrit)); +} catch (Exception $ex) { + $ecrit = journal_ecrire('valider_adhesion', $user_id, $libelle, 'groupe : ' . ADHERENT_GROUP, 'échec : ' . $ex->getMessage()); + set_flash('error', 'Erreur : ' . $ex->getMessage() . journal_avertissement($ecrit)); } -header('Location: /admin/members.php'); +header('Location: ' . (str_starts_with((string)($_POST['retour'] ?? ''), '/admin/') ? $_POST['retour'] : '/admin/members.php')); exit; diff --git a/web/inc/config.php b/web/inc/config.php index a36e25b..da98618 100644 --- a/web/inc/config.php +++ b/web/inc/config.php @@ -1,6 +1,9 @@ date('c'), + 'administrateur' => $admin['username'] ?? '', + 'admin_id' => $admin['sub'] ?? '', + 'action' => $action, + 'compte' => $compte_id, + 'compte_libelle' => $compte_libelle, + 'detail' => $detail, + 'resultat' => $resultat, + 'ip' => $_SERVER['REMOTE_ADDR'] ?? '', + ], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_INVALID_UTF8_SUBSTITUTE) . "\n"; + + $dossier = dirname(JOURNAL_FILE); + if (!is_dir($dossier) && !@mkdir($dossier, 0750, true)) { + error_log("journal console : dossier $dossier absent et impossible à créer"); + return false; + } + $f = @fopen(JOURNAL_FILE, 'a'); + if (!$f) { + error_log('journal console : impossible d\'ouvrir ' . JOURNAL_FILE); + return false; + } + $ok = flock($f, LOCK_EX) && fwrite($f, $ligne) === strlen($ligne); + fflush($f); + flock($f, LOCK_UN); + fclose($f); + if (!$ok) error_log('journal console : écriture incomplète dans ' . JOURNAL_FILE); + return $ok; +} + +function journal_avertissement(bool $ecrit): string { + return $ecrit ? '' : ' Attention : ce geste n\'a pas pu être inscrit au journal de la console.'; +} + +// Les $max derniers gestes, du plus récent au plus ancien, éventuellement +// ceux d'un seul compte. +function journal_lire(int $max = 200, ?string $compte_id = null): array { + if (!is_file(JOURNAL_FILE)) return []; + $f = @fopen(JOURNAL_FILE, 'r'); + if (!$f) throw new RuntimeException('Le journal de la console ne peut pas être lu (' . JOURNAL_FILE . ').'); + flock($f, LOCK_SH); + $derniers = []; + while (($ligne = fgets($f)) !== false) { + $g = json_decode($ligne, true); + if (!is_array($g)) continue; + if ($compte_id !== null && ($g['compte'] ?? '') !== $compte_id) continue; + $derniers[] = $g; + if (count($derniers) > $max) array_shift($derniers); + } + flock($f, LOCK_UN); + fclose($f); + return array_reverse($derniers); +} + +// Libellés lisibles des actions inscrites au journal. +const JOURNAL_ACTIONS = [ + 'activer' => 'activation du compte', + 'desactiver' => 'désactivation du compte', + 'courriel_mdp' => 'courriel « nouveau mot de passe »', + 'courriel_verif' => 'courriel de vérification', + 'retirer_otp' => 'retrait de l\'OTP', + 'fermer_sessions' => 'fermeture des sessions', + 'ajouter_groupe' => 'ajout à un groupe', + 'retirer_groupe' => 'retrait d\'un groupe', + 'valider_adhesion' => 'validation d\'adhésion', + 'revoquer_adhesion' => 'révocation d\'adhésion', + 'creer_groupe' => 'création de groupe', + 'supprimer_groupe' => 'suppression de groupe', + 'enregistrer_services' => 'paramétrage des services', +]; + +function journal_action_libelle(string $action): string { + return JOURNAL_ACTIONS[$action] ?? $action; +} diff --git a/web/inc/keycloak.php b/web/inc/keycloak.php index 44b0c18..ee8daad 100644 --- a/web/inc/keycloak.php +++ b/web/inc/keycloak.php @@ -420,3 +420,18 @@ function kc_retirer_groupe(string $user_id, string $group_id): void { $resp = _kc_request('DELETE', "/users/$user_id/groups/$group_id"); _kc_attendre($resp, 'retirer le compte d\'un groupe', 'manage-users', 204, 200); } + +// ── Événements de connexion ─────────────────────────────────────────── + +// Réglages d'enregistrement des événements du realm : eventsEnabled, +// eventsExpiration (secondes), enabledEventTypes. +function kc_events_config(): array { + $resp = _kc_request('GET', '/events/config'); + return _kc_attendre($resp, 'lire les réglages des événements du realm', 'view-events') ?? []; +} + +// Derniers événements d'un compte, du plus récent au plus ancien. +function kc_user_events(string $user_id, int $max = 20): array { + $resp = _kc_request('GET', '/events?' . http_build_query(['user' => $user_id, 'max' => $max])); + return _kc_attendre($resp, 'lire les événements de connexion du compte', 'view-events') ?? []; +} diff --git a/web/views/admin_nav.php b/web/views/admin_nav.php new file mode 100644 index 0000000..6bba702 --- /dev/null +++ b/web/views/admin_nav.php @@ -0,0 +1,15 @@ + ['/admin/members.php', 'Membres'], + 'groupes' => ['/admin/groups.php', 'Groupes'], + 'services' => ['/admin/services.php', 'Services'], + 'journal' => ['/admin/journal.php', 'Journal'], +]; +?> + From e761a3ff4ecc77ea6a8ba42457aeeac5dd70cf1a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?C=C3=A9drix?= Date: Sat, 31 Oct 2026 09:03:13 +0100 Subject: [PATCH 5/5] =?UTF-8?q?Pr=C3=A9parer=20la=20mise=20en=20ligne=20de?= =?UTF-8?q?=20la=20console=20d'administration=20(#8)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit README, section « Administration » : les écrans, les rôles à donner au compte de service portail-service — view-users, manage-users, view-events, view-clients, ceux du client master-realm puisque le compte vit dans master et administre master —, l'activation des événements de connexion, le journal, et la procédure de mise en ligne. Cette procédure commence par ISPConfig : en production, /admin/ est encore renvoyé par un ProxyPass vers l'ancienne application Flask (la réponse vient de gunicorn), d'où le 404 sur /admin/members.php. deploy.sh pousse bien web/admin, mais tant que ce ProxyPass reste, le PHP n'est pas atteint. .env.example : realm master et client portail-alpinux comme en production, JOURNAL_FILE et ROLES_SURVEILLES ; le secret du client OIDC qui y figurait est retiré. private/ est ignoré par git pour un portail lancé en local. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01V2csyno8m71DJFKYM1vgzV --- .env.example | 19 +++++++-- .gitignore | 2 + README.md | 113 +++++++++++++++++++++++++++++++++++++++++++++++++-- 3 files changed, 127 insertions(+), 7 deletions(-) diff --git a/.env.example b/.env.example index 601bb42..5be9fe8 100644 --- a/.env.example +++ b/.env.example @@ -1,13 +1,16 @@ # ── Clé secrète PHP sessions ────────────────────────────────────────── SECRET_KEY=changez-moi-valeur-aleatoire-longue -# ── AlpID OIDC (client portail dans le realm alpinux) ───────────────── +# ── AlpID OIDC ──────────────────────────────────────────────────────── +# En production : realm master, client portail-alpinux. Sans ALPID_REALM, +# le code retombe sur « alpinux ». ALPID_BASE=https://alpid.alpinux.org -ALPID_REALM=alpinux -ALPID_CLIENT_ID=portail -ALPID_CLIENT_SECRET=PortailAlpinux8281a984405f7c88d9b0 +ALPID_REALM=master +ALPID_CLIENT_ID=portail-alpinux +ALPID_CLIENT_SECRET= # ── Keycloak Admin REST API — compte de service (realm master) ──────── +# Rôles à lui donner : voir README, « Administration ». KC_SERVICE_CLIENT_ID=portail-service KC_SERVICE_CLIENT_SECRET= @@ -35,6 +38,14 @@ ADHERENT_GROUP=adherents # Par défaut : /var/www/clients/client1/web16/../services.json (hors web root) SERVICES_FILE=/var/www/clients/client1/web16/private/services.json +# ── Console d'administration ────────────────────────────────────────── +# Journal des gestes de la console (une ligne JSON par geste). Par défaut : +# private/journal-console.jsonl, à côté de ce .env. Le dossier doit être +# accessible en écriture à l'utilisateur PHP du site (web16). +# JOURNAL_FILE=/var/www/clients/client1/web16/private/journal-console.jsonl +# Rôles client pointés en tête de la fiche d'un compte (« client:rôle »). +ROLES_SURVEILLES=messagerie:messagerie-admin,messagerie:messagerie-mailperso + # ── Déploiement (scripts/deploy.sh) ─────────────────────────────────── PORTAIL_HOST=alpinux.org PORTAIL_PATH=/var/www/clients/client1/web16/web diff --git a/.gitignore b/.gitignore index 453a623..6ed42c4 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,4 @@ .env web/inc/config.local.php +# .env, journal et fichiers de données quand le portail tourne en local +private/ diff --git a/README.md b/README.md index 85cfe55..e89f6a5 100644 --- a/README.md +++ b/README.md @@ -4,16 +4,123 @@ Portail membres de l'association Alpinux. ## Statut -Géré directement via **ISPConfig** sur le serveur. Le contenu de ce sous-domaine (Nextcloud, Dolibarr ou autre outil collaboratif) est installé et configuré côté serveur et n'est pas versioné dans ce dépôt. +Site PHP sans dépendance, dans `web/`, servi par PHP-FPM sur le vhost +ISPConfig `portail.alpinux.org` (web16) et déployé par `scripts/deploy.sh`. +La configuration réelle est dans `private/.env` sur le serveur, hors dépôt +(`.env.example` sert de modèle). ## Accès - URL : https://portail.alpinux.org - Authentification : AlpID (SSO Keycloak — https://alpid.alpinux.org) -## Notes +## Administration -Ce dossier est un espace réservé. Si un développement spécifique au portail est nécessaire (thème, plugin, scripts de déploiement), il sera ajouté ici. +Une console, sous `/admin/`, pour vérifier et corriger un compte AlpID sans +ouvrir la console Keycloak. Elle est réservée aux membres d'un groupe de +`ADMIN_GROUPS` (par défaut `admins`), lu à la connexion dans la claim +`groups` du userinfo — il faut donc un mappeur « Group Membership » (claim +`groups`, sans le chemin complet) sur le client `portail-alpinux`. Un +changement de groupe ne compte qu'à la connexion suivante. + +### Les écrans + +| Écran | Rôle | +|---|---| +| `members.php` | Recherche (`?q=`, identifiant, nom ou adresse), pagination par 50, validation et révocation d'adhésion. Chaque ligne mène à la fiche. | +| `compte.php?id=` | Fiche d'un compte : activé, adresse vérifiée, actions requises, OTP, groupes, rôles realm et client (directs et effectifs), sessions ouvertes, 20 derniers événements de connexion, gestes de la console sur ce compte. L'encadré « En bref » pointe les rôles de `ROLES_SURVEILLES` (par défaut `messagerie-admin` et `messagerie-mailperso` du client `messagerie`). | +| | Gestes, tous en POST avec jeton CSRF : activer / désactiver, courriel « nouveau mot de passe » (`UPDATE_PASSWORD`), courriel de vérification d'adresse, retrait de l'OTP, fermeture de toutes les sessions, ajout à un groupe, retrait d'un groupe. Un administrateur ne peut ni se désactiver, ni se retirer d'un groupe administrateur ; fermer ses propres sessions demande une confirmation explicite. | +| `groups.php` | Groupes Keycloak : création, suppression, services associés. | +| `services.php` | Tuiles de services et groupes requis (`SERVICES_FILE`). | +| `journal.php` | Les 200 derniers gestes de la console (`?compte=` pour un seul compte). | + +Pour le cas « reconnu, mais sans aucun droit » dans une application : la +fiche dit si le compte est activé, s'il lui reste une action requise, et +quels rôles il a **effectivement** sur le client de l'application, y compris +ceux hérités d'un groupe. Pour la messagerie, seul `messagerie-admin` vient de +Keycloak : les autres droits sont attribués dans la messagerie elle-même +(`/droits`), que la fiche ne voit pas. + +### Rôles du compte de service `portail-service` + +La console appelle l'API d'administration avec le compte de service du client +`portail-service` (`client_credentials` sur le realm master). Ce compte vit +dans le realm **master** : ses droits sur un realm se donnent par les rôles du +client `-realm` du realm master — **`master-realm`** pour administrer +master lui-même, ce qui est le cas en production. C'est l'équivalent, pour un +compte de master, des rôles `realm-management` d'un autre realm ; il n'y a pas +de client `realm-management` dans master. + +Dans la console Keycloak, realm master : *Clients* → `portail-service` → +onglet *Service accounts roles* → *Assign role* → filtrer par clients → +`master-realm`, et cocher : + +| Rôle | Pour | +|---|---| +| `view-users` | lister, chercher et lire les comptes, leurs groupes, rôles, sessions et moyens d'authentification ; lister les groupes | +| `manage-users` | tous les gestes de la fiche, valider / révoquer une adhésion, créer / supprimer un groupe ; aussi l'inscription et le profil des membres | +| `view-events` | les derniers événements de connexion d'un compte et les réglages d'enregistrement | +| `view-clients` | retrouver un client par son nom pour en lire les rôles effectifs (la messagerie, quand le compte n'y a aucun rôle direct) | + +`query-groups` n'est pas nécessaire : `view-users` suffit à lister les +groupes. Il ne faut le donner que si l'on retire `view-users`, ce qui +priverait de toute façon la console de l'essentiel. + +Un rôle manquant ne donne ni page blanche ni liste vide : l'écran affiche le +refus (403) et nomme le rôle à ajouter. + +### Événements de connexion + +Keycloak n'enregistre les connexions que si on le lui demande. Dans le realm +administré (master) : *Realm settings* → onglet *Events* → *User events +settings* → activer *Save events*, choisir une *Expiration* (par exemple +30 jours — ces événements portent l'adresse IP des membres, ne pas les garder +plus que nécessaire), puis *Save*. Sans cela, la fiche l'indique au lieu +d'afficher une liste vide. + +Les courriels (mot de passe, vérification) partent du serveur d'envoi du +realm : *Realm settings* → onglet *Email*. S'il n'est pas configuré, le geste +échoue avec un message qui le dit. + +### Journal de la console + +Chaque geste ajoute une ligne JSON (date, administrateur, action, compte visé, +détail, résultat, IP) dans `JOURNAL_FILE`, par défaut +`private/journal-console.jsonl`, à côté du `.env`, hors racine web. Le dossier +`private/` doit être accessible en écriture à l'utilisateur PHP du site. Si +l'écriture échoue, le geste a lieu quand même et le message de retour le +signale. Le fichier n'est pas tourné automatiquement. + +### Mise en ligne + +Aujourd'hui, `/admin/` ne mène pas au PHP : la réponse vient de **gunicorn** +(l'ancienne application Flask de static.alpinux.org), et +`/admin/members.php` y répond 404 alors que `/` est servi par Apache. Les +directives Apache d'ISPConfig portent encore le `ProxyPass /admin/` dont +`scripts/portail.alpinux.org.vhost.conf` demande le retrait. Déployer ne +suffit donc pas. Dans l'ordre : + +1. **Keycloak** : donner à `portail-service` les rôles ci-dessus, et activer + l'enregistrement des événements. +2. **ISPConfig** : *Sites* → `portail.alpinux.org` → onglet *Options* → + *Apache Directives* : retirer les lignes `ProxyPass` / `ProxyPassReverse` + de `/admin/`, enregistrer, attendre qu'ISPConfig ait réécrit le vhost + (ne jamais modifier `/etc/apache2/sites-available/` à la main). Vérifier : + `curl -sI https://portail.alpinux.org/admin/members.php` doit répondre + `server: Apache` et une redirection vers `/auth/login.php`, et non plus + `server: gunicorn`. +3. **Configuration** : `private/.env` n'a besoin d'aucune variable nouvelle + si les valeurs par défaut conviennent (`JOURNAL_FILE`, + `ROLES_SURVEILLES`). Vérifier que `private/` est accessible en écriture à + PHP. +4. **Code** : `./scripts/deploy.sh -n` pour voir ce qui partira (le dossier + `web/admin/`, `web/inc/journal.php`, `web/views/admin_nav.php` sont + nouveaux), puis `./scripts/deploy.sh`. +5. **Contrôle** : se connecter avec un compte du groupe `admins` (se + reconnecter si on vient d'y entrer), ouvrir *Admin*, chercher un compte, + ouvrir sa fiche : aucun bloc ne doit afficher de refus 403. Faire un geste + sans conséquence (courriel de vérification à son propre compte) et + vérifier qu'il apparaît dans *Journal*. ---