alpinux-portail/web/inc/journal.php
Cédrix b399db012c
Recherche, derniers événements et journal de la console (#7)
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 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01V2csyno8m71DJFKYM1vgzV
2026-10-31 09:01:12 +01:00

86 lines
3.6 KiB
PHP

<?php
// Journal des gestes de la console d'administration : qui a fait quoi, sur
// quel compte, avec quel résultat. Une ligne JSON par geste, ajoutée sous
// verrou exclusif dans JOURNAL_FILE (hors racine web).
require_once __DIR__ . '/config.php';
require_once __DIR__ . '/auth.php';
// Inscrit un geste. Renvoie false si le journal n'a pas pu être écrit : le
// geste a eu lieu quand même, l'appelant doit le dire (journal_avertissement()).
function journal_ecrire(string $action, string $compte_id = '', string $compte_libelle = '',
string $detail = '', string $resultat = 'ok'): bool {
$admin = current_user() ?? [];
$ligne = json_encode([
'date' => 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;
}