Fiche d'un compte AlpID dans la console d'administration (#5)

web/admin/compte.php?id=<uuid> 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>-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 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01V2csyno8m71DJFKYM1vgzV
This commit is contained in:
Cédrix 2026-10-31 08:55:27 +01:00
parent 24f3296ec8
commit 5682052423
No known key found for this signature in database
7 changed files with 522 additions and 33 deletions

286
web/admin/compte.php Normal file
View file

@ -0,0 +1,286 @@
<?php
// Fiche d'un compte AlpID : tout ce qu'il faut pour comprendre pourquoi une
// personne entre, n'entre pas, ou entre « sans aucun droit », sans ouvrir la
// console Keycloak. Chaque bloc est lu séparément : un rôle manquant au
// compte de service vide un bloc et l'explique, pas toute la page.
require_once __DIR__ . '/../inc/config.php';
require_once __DIR__ . '/../inc/auth.php';
require_once __DIR__ . '/../inc/keycloak.php';
session_start_safe();
require_admin();
$id = (string)($_GET['id'] ?? '');
if (!kc_est_uuid($id)) {
http_response_code(400);
$title = 'Compte introuvable';
require __DIR__ . '/../views/layout.php';
echo '<div class="card center"><h1>Identifiant de compte invalide</h1>'
. '<p>L\'adresse doit porter l\'identifiant Keycloak du compte (un UUID).</p>'
. '<a href="/admin/members.php" class="btn-primary">Retour aux membres</a></div>';
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';
?>
<div class="admin-page">
<div class="page-header"><h1>Fiche du compte</h1></div>
<div class="alert alert-error"><?= e($erreurs['compte']) ?></div>
<p><a href="/admin/members.php">← Retour aux membres</a></p>
</div>
<?php
require __DIR__ . '/../views/layout_end.php';
exit;
}
$groupes = _fiche_lire(fn() => 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';
?>
<div class="admin-page fiche">
<div class="page-header">
<h1><?= e($compte['username'] ?? '') ?><?php if ($nom_complet): ?> <span class="text-muted">— <?= e($nom_complet) ?></span><?php endif; ?></h1>
<a href="/admin/members.php">← Membres</a>
</div>
<?php if ($soi): ?>
<div class="alert alert-info">C'est votre propre compte.</div>
<?php endif; ?>
<!-- En bref -->
<section class="card">
<h2>En bref</h2>
<ul class="diagnostic">
<li class="<?= !empty($compte['enabled']) ? 'ok' : 'alerte' ?>">
Compte <?= !empty($compte['enabled']) ? 'activé' : 'désactivé : la connexion est refusée' ?>
</li>
<li class="<?= !empty($compte['emailVerified']) ? 'ok' : 'alerte' ?>">
Adresse <?= !empty($compte['emailVerified']) ? 'vérifiée' : 'non vérifiée' ?>
</li>
<li class="<?= $actions ? 'alerte' : 'ok' ?>">
<?php if ($actions): ?>
À la prochaine connexion, devra :
<?= e(implode(', ', array_map(fn($a) => ACTIONS_REQUISES[$a] ?? $a, $actions))) ?>
<?php else: ?>
Aucune action requise
<?php endif; ?>
</li>
<?php if ($otp !== null): ?>
<li class="<?= $otp ? 'ok' : 'neutre' ?>"><?= $otp ? 'OTP configuré' : 'Pas d\'OTP' ?></li>
<?php endif; ?>
<?php if ($groupes !== null): ?>
<li class="<?= in_array(ADHERENT_GROUP, $noms_groupes, true) ? 'ok' : 'neutre' ?>">
<?= in_array(ADHERENT_GROUP, $noms_groupes, true) ? 'Adhérent' : 'Pas dans le groupe « ' . e(ADHERENT_GROUP) . ' »' ?>
</li>
<?php if (array_intersect(ADMIN_GROUPS, $noms_groupes)): ?>
<li class="ok">Administrateur du portail</li>
<?php endif; ?>
<?php endif; ?>
<?php foreach (ROLES_SURVEILLES as $surveille):
[$client_id, $role] = explode(':', $surveille, 2) + [1 => ''];
if (array_key_exists("client:$client_id", $erreurs)) continue;
$eff = $effectifs_client[$client_id] ?? null;
?>
<li class="<?= $eff !== null && in_array($role, $eff, true) ? 'ok' : 'neutre' ?>">
<?php if ($eff === null): ?>
Client « <?= e($client_id) ?> » absent du realm
<?php elseif (in_array($role, $eff, true)): ?>
Rôle « <?= e($role) ?> » sur « <?= e($client_id) ?> »
(<?= in_array($role, $directs_client[$client_id] ?? [], true) ? 'attribué directement' : 'hérité d\'un groupe ou d\'un rôle composite' ?>)
<?php else: ?>
Pas de rôle « <?= e($role) ?> » sur « <?= e($client_id) ?> »
<?php endif; ?>
</li>
<?php endforeach; ?>
<?php if ($sessions !== null): ?>
<li class="neutre"><?= count($sessions) ?> session<?= count($sessions) > 1 ? 's' : '' ?> ouverte<?= count($sessions) > 1 ? 's' : '' ?></li>
<?php endif; ?>
</ul>
</section>
<!-- Identité -->
<section class="card">
<h2>Identité</h2>
<dl>
<dt>Identifiant</dt><dd><?= e($compte['username'] ?? '') ?></dd>
<dt>Nom</dt><dd><?= e($nom_complet ?: '—') ?></dd>
<dt>Adresse</dt><dd><?= e($compte['email'] ?? '—') ?>
<span class="badge <?= !empty($compte['emailVerified']) ? 'badge-adherent' : 'badge-admin' ?>"><?= !empty($compte['emailVerified']) ? 'vérifiée' : 'non vérifiée' ?></span></dd>
<dt>État</dt><dd><span class="badge <?= !empty($compte['enabled']) ? 'badge-adherent' : 'badge-danger' ?>"><?= !empty($compte['enabled']) ? 'activé' : 'désactivé' ?></span></dd>
<dt>Créé le</dt><dd><?= e(_fiche_date($compte['createdTimestamp'] ?? null)) ?></dd>
<dt>Actions requises</dt><dd>
<?php if ($actions): foreach ($actions as $a): ?>
<span class="badge badge-admin" title="<?= e(ACTIONS_REQUISES[$a] ?? '') ?>"><?= e($a) ?></span>
<?php endforeach; else: ?>aucune<?php endif; ?></dd>
<dt>Authentification</dt><dd>
<?php if (isset($erreurs['moyens'])): ?>
<span class="text-warning"><?= e($erreurs['moyens']) ?></span>
<?php else: ?>
mot de passe : <?= $mot_de_passe ? 'oui' : 'aucun' ?> ·
OTP : <?= $otp ? 'configuré le ' . e(_fiche_date($otp[0]['createdDate'] ?? null)) . (count($otp) > 1 ? ' (' . count($otp) . ' appareils)' : '') : 'non' ?>
<?php endif; ?></dd>
<?php if (!empty($compte['federationLink'])): ?>
<dt>Fédération</dt><dd>compte fourni par une fédération (<?= e($compte['federationLink']) ?>)</dd>
<?php endif; ?>
<dt>UUID</dt><dd><code><?= e($id) ?></code></dd>
</dl>
</section>
<!-- Groupes -->
<section class="card">
<h2>Groupes</h2>
<?php if (isset($erreurs['groupes'])): ?>
<div class="alert alert-error"><?= e($erreurs['groupes']) ?></div>
<?php elseif (!$groupes): ?>
<p class="text-muted">Membre d'aucun groupe.</p>
<?php else: ?>
<p><?php foreach ($groupes as $g): ?><span class="badge"><?= e($g['path'] ?? $g['name']) ?></span> <?php endforeach; ?></p>
<?php endif; ?>
</section>
<!-- Rôles -->
<section class="card">
<h2>Rôles</h2>
<?php if (isset($erreurs['roles'])): ?>
<div class="alert alert-error"><?= e($erreurs['roles']) ?></div>
<?php endif; ?>
<table>
<thead><tr><th>Portée</th><th>Rôles effectifs</th><th>Dont attribués directement</th></tr></thead>
<tbody>
<?php if ($roles !== null || $realm_eff !== null): ?>
<tr>
<td><strong>realm <?= e(ALPID_REALM) ?></strong></td>
<td><?= $realm_eff === null ? '?' : e(implode(', ', array_column($realm_eff, 'name')) ?: '—') ?></td>
<td><?= $roles === null ? '?' : e(implode(', ', array_column($roles['realmMappings'] ?? [], 'name')) ?: '—') ?></td>
</tr>
<?php endif; ?>
<?php foreach ($clients_vus as $client_id): ?>
<tr>
<td>client <strong><?= e($client_id) ?></strong></td>
<?php if (isset($erreurs["client:$client_id"])): ?>
<td colspan="2"><span class="text-warning"><?= e($erreurs["client:$client_id"]) ?></span></td>
<?php elseif ($effectifs_client[$client_id] === null): ?>
<td colspan="2" class="text-muted">client absent du realm <?= e(ALPID_REALM) ?></td>
<?php else: ?>
<td><?= e(implode(', ', $effectifs_client[$client_id]) ?: '—') ?></td>
<td><?= e(implode(', ', $directs_client[$client_id] ?? []) ?: '—') ?></td>
<?php endif; ?>
</tr>
<?php endforeach; ?>
</tbody>
</table>
<p class="small text-muted" style="margin-top:.6rem">
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.
</p>
</section>
<!-- Sessions -->
<section class="card">
<h2>Sessions ouvertes</h2>
<?php if (isset($erreurs['sessions'])): ?>
<div class="alert alert-error"><?= e($erreurs['sessions']) ?></div>
<?php elseif (!$sessions): ?>
<p class="text-muted">Aucune session ouverte.</p>
<?php else: ?>
<table>
<thead><tr><th>IP</th><th>Début</th><th>Dernier accès</th><th>Applications</th></tr></thead>
<tbody>
<?php foreach ($sessions as $s): ?>
<tr>
<td><?= e($s['ipAddress'] ?? '') ?></td>
<td><?= e(_fiche_date($s['start'] ?? null)) ?></td>
<td><?= e(_fiche_date($s['lastAccess'] ?? null)) ?></td>
<td><?= e(implode(', ', array_values($s['clients'] ?? [])) ?: '—') ?></td>
</tr>
<?php endforeach; ?>
</tbody>
</table>
<?php endif; ?>
<p class="small text-muted" style="margin-top:.6rem">Sessions SSO seulement : les sessions hors ligne (« se souvenir de moi » d'une application mobile) n'y figurent pas.</p>
</section>
</div>
<?php require __DIR__ . '/../views/layout_end.php'; ?>

View file

@ -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';
</thead>
<tbody>
<?php foreach ($groups as $g):
$members = kc_group_members($g['id']);
try {
$nb_membres = count(kc_group_members($g['id'], 1000));
} catch (RuntimeException $ex) {
$nb_membres = null;
$erreur_membres = $ex->getMessage();
}
$linked = $services_by_group[$g['name']] ?? [];
?>
<tr>
<td><strong><?= htmlspecialchars($g['name']) ?></strong></td>
<td><?= count($members) ?></td>
<td><?= $nb_membres === null ? '<span class="text-warning" title="' . e($erreur_membres) . '">?</span>' : e($nb_membres) ?></td>
<td>
<?php if ($linked): ?>
<?php foreach ($linked as $svc): ?>

View file

@ -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';
</div>
<?php if ($kc_error): ?>
<div class="alert alert-error">Erreur Keycloak : <?= htmlspecialchars($kc_error) ?></div>
<div class="alert alert-error"><?= e($kc_error) ?></div>
<?php endif; ?>
<!-- Inscrits en attente de validation -->
@ -52,8 +55,8 @@ require __DIR__ . '/../views/layout.php';
<tbody>
<?php foreach ($pending as $u): ?>
<tr>
<td><?= htmlspecialchars(trim(($u['firstName'] ?? '') . ' ' . ($u['lastName'] ?? ''))) ?></td>
<td><?= htmlspecialchars($u['username'] ?? '') ?></td>
<td><a href="/admin/compte.php?id=<?= e(rawurlencode($u['id'])) ?>"><?= e(trim(($u['firstName'] ?? '') . ' ' . ($u['lastName'] ?? '')) ?: '(sans nom)') ?></a></td>
<td><a href="/admin/compte.php?id=<?= e(rawurlencode($u['id'])) ?>"><?= e($u['username'] ?? '') ?></a></td>
<td><?= htmlspecialchars($u['email'] ?? '') ?></td>
<td><?= htmlspecialchars(implode(', ', $u['groupNames']) ?: '—') ?></td>
<td>
@ -88,8 +91,8 @@ require __DIR__ . '/../views/layout.php';
<tbody>
<?php foreach ($adherents as $u): ?>
<tr>
<td><?= htmlspecialchars(trim(($u['firstName'] ?? '') . ' ' . ($u['lastName'] ?? ''))) ?></td>
<td><?= htmlspecialchars($u['username'] ?? '') ?></td>
<td><a href="/admin/compte.php?id=<?= e(rawurlencode($u['id'])) ?>"><?= e(trim(($u['firstName'] ?? '') . ' ' . ($u['lastName'] ?? '')) ?: '(sans nom)') ?></a></td>
<td><a href="/admin/compte.php?id=<?= e(rawurlencode($u['id'])) ?>"><?= e($u['username'] ?? '') ?></a></td>
<td><?= htmlspecialchars($u['email'] ?? '') ?></td>
<td><?= htmlspecialchars(implode(', ', $u['groupNames'])) ?></td>
<td>

View file

@ -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';
</div>
</div>
<?php if ($kc_erreur): ?>
<div class="alert alert-error"><?= e($kc_erreur) ?></div>
<?php endif; ?>
<div class="card">
<form method="post">
<?= csrf_champ() ?>

View file

@ -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;

View file

@ -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'));

View file

@ -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>-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.<client>.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') ?? [];
}