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 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01V2csyno8m71DJFKYM1vgzV
422 lines
19 KiB
PHP
422 lines
19 KiB
PHP
<?php
|
|
require_once __DIR__ . '/config.php';
|
|
|
|
class KcUserExistsException extends RuntimeException {}
|
|
|
|
function _kc_admin_token(): string {
|
|
static $cache = null;
|
|
if ($cache && $cache['expires'] > time()) return $cache['token'];
|
|
|
|
$ch = curl_init(ALPID_BASE . '/realms/master/protocol/openid-connect/token');
|
|
curl_setopt_array($ch, [
|
|
CURLOPT_POST => true,
|
|
CURLOPT_POSTFIELDS => http_build_query([
|
|
'grant_type' => 'client_credentials',
|
|
'client_id' => KC_SERVICE_CLIENT_ID,
|
|
'client_secret' => KC_SERVICE_CLIENT_SECRET,
|
|
]),
|
|
CURLOPT_RETURNTRANSFER => true,
|
|
CURLOPT_TIMEOUT => 10,
|
|
]);
|
|
$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)", $status);
|
|
}
|
|
$data = json_decode($body, true);
|
|
$cache = ['token' => $data['access_token'], 'expires' => time() + $data['expires_in'] - 10];
|
|
return $cache['token'];
|
|
}
|
|
|
|
function _kc_request(string $method, string $path, mixed $body = null): array {
|
|
$url = KC_ADMIN_BASE . $path;
|
|
$token = _kc_admin_token();
|
|
$headers = ["Authorization: Bearer $token", "Content-Type: application/json"];
|
|
|
|
$ch = curl_init($url);
|
|
curl_setopt_array($ch, [
|
|
CURLOPT_CUSTOMREQUEST => $method,
|
|
CURLOPT_HTTPHEADER => $headers,
|
|
CURLOPT_RETURNTRANSFER => true,
|
|
CURLOPT_TIMEOUT => 15,
|
|
CURLOPT_HEADER => true,
|
|
]);
|
|
if ($body !== null) {
|
|
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
|
|
}
|
|
|
|
$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, '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 {
|
|
$name = strtolower(iconv('UTF-8', 'ASCII//TRANSLIT//IGNORE', $lastname));
|
|
$name = preg_replace('/[^a-z]/', '', $name);
|
|
$len = strlen($name);
|
|
if ($len <= 2) return $name;
|
|
return $name[0] . ($len - 2) . $name[$len - 1];
|
|
}
|
|
|
|
function kc_username_exists(string $username): bool {
|
|
$resp = _kc_request('GET', '/users?username=' . urlencode($username) . '&exact=true');
|
|
if ($resp['status'] !== 200) return false;
|
|
return count(json_decode($resp['body'], true) ?? []) > 0;
|
|
}
|
|
|
|
function kc_generate_username(string $lastname, string $firstname): string {
|
|
$fn = strtolower(preg_replace('/[^a-z]/i', '', iconv('UTF-8', 'ASCII//TRANSLIT//IGNORE', $firstname)));
|
|
$code = _kc_encode_username($lastname);
|
|
$base = $fn . '.' . $code;
|
|
|
|
if (!kc_username_exists($base)) return $base;
|
|
|
|
for ($i = 2; $i <= 99; $i++) {
|
|
$try = $base . $i;
|
|
if (!kc_username_exists($try)) return $try;
|
|
}
|
|
return $base . uniqid('', false);
|
|
}
|
|
|
|
function kc_create_user(string $username, string $email, string $first_name, string $last_name, string $password): string {
|
|
$resp = _kc_request('POST', '/users', [
|
|
'username' => $username,
|
|
'email' => $email,
|
|
'firstName' => $first_name,
|
|
'lastName' => $last_name,
|
|
'enabled' => true,
|
|
'emailVerified' => false,
|
|
'credentials' => [['type' => 'password', 'value' => $password, 'temporary' => false]],
|
|
]);
|
|
|
|
if ($resp['status'] === 409) {
|
|
$detail = json_decode($resp['body'], true)['errorMessage'] ?? '';
|
|
$msg = str_contains(strtolower($detail), 'email')
|
|
? 'Cet email est déjà associé à un compte existant.'
|
|
: 'Ce nom d\'utilisateur est déjà utilisé.';
|
|
throw new KcUserExistsException($msg);
|
|
}
|
|
if ($resp['status'] !== 201) {
|
|
throw new RuntimeException("Erreur création compte ({$resp['status']}) : {$resp['body']}");
|
|
}
|
|
|
|
// L'ID est dans le header Location
|
|
preg_match('#/users/([a-f0-9-]+)#', $resp['headers'], $m);
|
|
return $m[1] ?? '';
|
|
}
|
|
|
|
function kc_get_otp_credential(string $user_id): ?array {
|
|
$resp = _kc_request('GET', "/users/$user_id/credentials");
|
|
if ($resp['status'] !== 200) return null;
|
|
foreach (json_decode($resp['body'], true) ?? [] as $c) {
|
|
if ($c['type'] === 'otp') return $c;
|
|
}
|
|
return null;
|
|
}
|
|
|
|
function kc_delete_credential(string $user_id, string $credential_id): void {
|
|
$resp = _kc_request('DELETE', "/users/$user_id/credentials/$credential_id");
|
|
if ($resp['status'] >= 300) {
|
|
throw new RuntimeException("Erreur suppression credential ({$resp['status']})");
|
|
}
|
|
}
|
|
|
|
function kc_update_name(string $user_id, string $first_name, string $last_name): void {
|
|
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 {
|
|
kc_modifier_compte($user_id, ['email' => $email, 'emailVerified' => false], 'mettre à jour l\'adresse');
|
|
}
|
|
|
|
function kc_set_password(string $user_id, string $password): void {
|
|
$resp = _kc_request('PUT', "/users/$user_id/reset-password", [
|
|
'type' => 'password',
|
|
'value' => $password,
|
|
'temporary' => false,
|
|
]);
|
|
if ($resp['status'] >= 300) {
|
|
throw new RuntimeException("Erreur changement mot de passe ({$resp['status']})");
|
|
}
|
|
}
|
|
|
|
// 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') ?? [];
|
|
}
|
|
|
|
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');
|
|
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 {
|
|
$resp = _kc_request('POST', '/groups', ['name' => $name]);
|
|
if ($resp['status'] === 409) throw new RuntimeException("Le groupe « $name » existe déjà.");
|
|
if ($resp['status'] !== 201) throw new RuntimeException("Erreur création groupe ({$resp['status']})");
|
|
}
|
|
|
|
function kc_delete_group(string $group_id): void {
|
|
$resp = _kc_request('DELETE', "/groups/$group_id");
|
|
if ($resp['status'] >= 300) throw new RuntimeException("Erreur suppression groupe ({$resp['status']})");
|
|
}
|
|
|
|
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 = _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'];
|
|
}
|
|
throw new RuntimeException("Groupe « $group_name » introuvable dans Keycloak.");
|
|
}
|
|
|
|
function kc_add_to_group(string $user_id, string $group_name): void {
|
|
$group_id = _kc_group_id($group_name);
|
|
$resp = _kc_request('PUT', "/users/$user_id/groups/$group_id");
|
|
if ($resp['status'] >= 300) {
|
|
throw new RuntimeException("Erreur ajout groupe ({$resp['status']})");
|
|
}
|
|
}
|
|
|
|
function kc_remove_from_group(string $user_id, string $group_name): void {
|
|
$group_id = _kc_group_id($group_name);
|
|
$resp = _kc_request('DELETE', "/users/$user_id/groups/$group_id");
|
|
if ($resp['status'] >= 300) {
|
|
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') ?? [];
|
|
}
|
|
|
|
// ── 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);
|
|
}
|