Aller au contenu

Gestion des comptes — référence

Référence des mécanismes de gestion des comptes exposés à l'administration : invitations, désactivation et réactivation, suppression logique et réintégration, suppression définitive des comptes, journal d'audit et protections associées. Le parcours pas-à-pas vit dans le guide Gérer les comptes utilisateurs.

Vue d'ensemble

Index des routes

La gestion des comptes compte onze routes, toutes servies par un contrôleur invokable dans src/Controller/ :

Domaine Routes Détail
Invitations app_admin_invitations, app_admin_invitation_create, app_admin_invitation_resend, app_admin_invitation_delete, app_invitation_accept (publique) Invitations — routes
Désactivation et réactivation app_admin_users, app_admin_user_disable, app_admin_user_enable Désactivation et réactivation — routes
Suppression logique et réintégration app_admin_user_delete, app_admin_user_restore Suppression logique — routes
Suppression définitive app_admin_user_purge Suppression définitive — route

Les dix routes admin sont sous /admin ; seule app_invitation_accept (/invitation/{token}) est publique.

États

Objet État Condition Libellé affiché
Compte Actif disabledAt et deletedAt valent null (User::isActive() vrai) « Actif » (.bo-tag--ok)
Compte Désactivé disabledAt non null, deletedAt null « Désactivé » (.bo-tag--muted)
Compte Supprimé deletedAt non null, quel que soit disabledAt Listé dans l'encart « Comptes supprimés »
Invitation En attente expiresAt postérieur à l'instant courant « En attente » (.bo-tag--ok)
Invitation Expirée expiresAt atteint ou dépassé « Expirée » (.bo-tag--muted)

Un compte supprimé définitivement n'a plus d'état : sa ligne n'existe plus. Une invitation acceptée non plus : elle est supprimée à la création du compte.

Ce qu'un administrateur ne peut pas faire

Les seules écritures d'un administrateur sur un compte tiers sont les huit gestes de cette page : inviter, renvoyer une invitation, supprimer une invitation, désactiver, réactiver, supprimer, réintégrer, supprimer définitivement. Aucun écran ni aucune route ne permet de :

  • choisir ou modifier le mot de passe, l'adresse e-mail ou le prénom d'un compte (l'invité choisit son prénom et son mot de passe à l'acceptation) ;
  • modifier les rôles d'un compte après sa création (le rôle d'une invitation, lui, peut être remplacé par une réinvitation tant qu'elle n'est pas acceptée) ;
  • lire, rédiger, modifier ou publier le contenu d'un compte : les écrans d'avertissement n'en montrent que des nombres ;
  • désactiver une invitation : elle se supprime ;
  • se désactiver, se supprimer ou se supprimer définitivement soi-même, ni retirer le dernier administrateur actif (voir Invariant « au moins un administrateur actif ») ;
  • modifier ou supprimer un motif de modération déjà enregistré.

Invitations

Une invitation n'est pas un compte : elle vit dans sa propre table (invitation, entité src/Entity/Invitation.php) et aucun User n'existe avant son acceptation. Tout le métier est porté par src/Service/User/InvitationManager.php.

Routes

Nom Chemin Méthodes Accès Contrôleur
app_admin_invitations /admin/invitations GET ROLE_ADMIN src/Controller/AppAdminInvitationsController.php
app_admin_invitation_create /admin/invitations/inviter GET, POST ROLE_ADMIN src/Controller/AppAdminInvitationCreateController.php
app_admin_invitation_resend /admin/invitations/{id}/renvoyer POST ROLE_ADMIN src/Controller/AppAdminInvitationResendController.php
app_admin_invitation_delete /admin/invitations/{id}/supprimer POST ROLE_ADMIN src/Controller/AppAdminInvitationDeleteController.php
app_invitation_accept /invitation/{token} GET, POST public (anonyme) src/Controller/AppInvitationAcceptController.php
  • {id} est contraint par Requirement::UUID_V7 ; un identifiant inconnu donne un 404.
  • {token} est contraint par InvitationTokenGenerator::TOKEN_PATTERN ([0-9a-f]{60}). Tout autre format est rejeté en 404 par le routeur, avant le contrôleur.
  • Les routes admin sont couvertes par l'access_control ^/admin (config/packages/security.yaml) et par #[IsGranted('ROLE_ADMIN')]. Un visiteur anonyme est redirigé vers /admin/login ; un visiteur connecté côté utilisateur reçoit un 404 (src/EventSubscriber/AdminAreaAccessSubscriber.php).
  • La route d'acceptation est hors /admin et n'a aucun contrôle d'accès : un visiteur déjà connecté n'est pas redirigé et peut créer un autre compte.

Tous les formulaires sont en HTML natif (POST puis redirection), fonctionnels sans JavaScript.

app_admin_invitations rend templates/admin/invitations/index.html.twig : bouton Inviter (btn btn-primary, seule action primaire de l'écran), tableau bo-table bo-invitations__table enveloppé dans une région défilante .bo-table-wrap (aria-labelledby="invitations-table-title", tabindex="0"), état en .bo-tag avec puce et texte, et, par ligne, deux formulaires POST dans un groupe .bo-actions : Renvoyer (btn btn-secondary btn-sm) et Supprimer (btn btn-danger btn-sm). app_admin_invitation_create rend templates/admin/invitations/create.html.twig : champ email, groupe de boutons radio role (libellés de AccountRole::label()), bouton Envoyer l'invitation (btn btn-primary) et lien Annuler.

Durées

Constante Valeur Effet
Invitation::LIFETIME PT72H Un lien expire 72 heures après son dernier envoi.
Invitation::RESEND_DELAY PT5M Deux envois à une même invitation sont séparés d'au moins 5 minutes. À 5 minutes pile, le renvoi est autorisé.

Ces durées sont en dur : ni variable d'environnement, ni réglage d'instance. Une invitation expirée reste en base et dans la liste (« Expirée ») ; aucun nettoyage automatique n'est prévu.

Cycle de vie

Opération Déclencheur Effet
Émission POST /admin/invitations/inviter, adresse sans invitation Crée l'invitation, génère un jeton, met l'e-mail en file.
Réinvitation POST /admin/invitations/inviter, adresse déjà invitée Renvoi soumis au délai de 5 min ; le rôle soumis remplace les rôles de l'invitation.
Renvoi POST /admin/invitations/{id}/renvoyer Renvoi soumis au délai de 5 min ; rôles inchangés ; possible sur une invitation expirée.
Suppression POST /admin/invitations/{id}/supprimer Suppression réelle de la ligne ; l'adresse redevient invitable.
Acceptation POST /invitation/{token} valide Crée le compte et son carnet, supprime l'invitation.

Un renvoi (ou une réinvitation) génère un nouveau jeton et remplace le sélecteur stocké : l'ancien lien cesse de fonctionner immédiatement. L'inviteur (invitedBy) et la date de création ne changent pas.

Le délai de renvoi est contrôlé dans la transaction, après une relecture verrouillée de l'invitation (InvitationRepositoryInterface::findForUpdate(), verrou PESSIMISTIC_WRITE) : deux renvois concurrents sont sérialisés et le second est refusé. Une double soumission du formulaire d'émission, qui heurte la contrainte d'unicité sur email, est convertie en refus « renvoi trop tôt » : un seul e-mail part.

L'envoi de l'e-mail est la dernière instruction de la transaction : si la mise en file échoue, l'invitation n'est pas enregistrée.

Contrôles à l'émission

Appliqués dans cet ordre par InvitationManager::invite() :

  1. Adresse trim()ée, non vide, au format e-mail, 180 caractères au plus.
  2. Rôle parmi user, admin, both (src/Entity/Enum/AccountRole.php).
  3. Adresse d'un compte supprimé : refus avec l'issue à suivre.
  4. Adresse d'un compte existant, actif ou désactivé : refus.

L'unicité est sensible à la casse, comme pour app:user:create.

Rôles

Valeur du formulaire Libellé Rôles stockés
user Utilisateur ROLE_USER
admin Administrateur ROLE_ADMIN
both Utilisateur et administrateur ROLE_USER, ROLE_ADMIN

Messages

Portés par src/Service/User/Exception/InvitationException.php et par les contrôleurs.

Situation Message Réponse
Adresse vide « Merci de saisir une adresse e-mail. » 422, formulaire réaffiché
Adresse invalide ou trop longue Message de la contrainte de validation 422
Rôle absent ou inconnu « Choisissez un rôle : utilisateur, administrateur, ou les deux. » 422
Compte actif ou désactivé « Cette adresse est déjà utilisée par un compte. » 422
Compte supprimé « Cette adresse appartient à un compte supprimé : réintégrez-le ou supprimez-le définitivement pour pouvoir l'inviter. » 422
Délai de 5 min non écoulé « Une invitation vient d'être envoyée à cette adresse. Réessayez dans M min SS s. » 422 (émission) ou flash invitation_error (renvoi)
Invitation supprimée entre l'affichage de la liste et le renvoi « Cette invitation n'existe plus. » flash invitation_error
Jeton CSRF invalide (émission, acceptation) « Session expirée, merci de renvoyer le formulaire. » 422
Jeton CSRF invalide (renvoi, suppression) — 403

Succès, en flash invitation_success :

Action Message
Émission ou réinvitation « Invitation envoyée à adresse. »
Renvoi « Invitation renvoyée à adresse. »
Suppression « Invitation à adresse supprimée. »
Acceptation « Votre compte est créé. Connectez-vous avec l'adresse adresse et le mot de passe que vous venez de choisir. »

Jetons CSRF

Formulaire Identifiant
Émission invitation_create
Renvoi invitation_resend-<id RFC 4122>
Suppression invitation_delete-<id RFC 4122>
Acceptation invitation_accept

Tous sont transmis dans le champ _csrf_token et stockés en session.

Format du jeton

Généré par src/Security/InvitationTokenGenerator.php.

Partie Taille Source Stockage
Sélecteur (selector) 20 caractères hex (10 octets) random_bytes En clair, colonne unique : clé de recherche.
Vérificateur (verifier) 40 caractères hex (20 octets, 160 bits) random_bytes Jamais stocké. Seul son HMAC-SHA256 (64 hex, clé kernel.secret) l'est, dans hashedVerifier.
Jeton (token) 60 caractères hex minuscules selector . verifier Jamais stocké dans la table invitation.

La vérification compare le HMAC du vérificateur soumis au hash stocké en temps constant (hash_equals). Changer APP_SECRET invalide donc toutes les invitations en cours.

Le jeton n'apparaît en clair que dans l'URL /invitation/{token} de l'e-mail. Cette URL absolue est calculée pendant la requête admin, pas par le worker Messenger.

Acceptation

AppInvitationAcceptController :

  • GET avec un jeton vivant : formulaire « Créer votre compte Kirexo », adresse affichée en lecture seule, champs first_name, password, password_confirm.
  • POST : validations dans cet ordre, chacune renvoyant un 422 avec le prénom pré-rempli (jamais les mots de passe) :
    1. mot de passe et confirmation identiques, puis mot de passe non vide et d'au moins 8 caractères (règle partagée avec la réinitialisation, PasswordResetCompletionProcessor::validateNewPassword()) ;
    2. prénom non vide après trim(), 100 caractères au plus.
  • Création, dans une seule transaction :
    • un User avec l'adresse et les rôles de l'invitation, le mot de passe haché, invitedBy et invitedAt renseignés (User::recordInvitation()) ;
    • un carnet nommé « Le carnet de <prénom> » (Notebook::defaultName()) ;
    • la suppression de l'invitation.
  • Aucune authentification automatique. Redirection vers app_login (/login) si le compte porte ROLE_USER (rôles user et both), sinon vers app_admin_login (/admin/login). La redirection ne porte pas le jeton.

Si une adresse a été prise entre-temps (par exemple par app:user:create), l'acceptation échoue avec la réponse neutre.

Anti-énumération

Un jeton inconnu, expiré, renouvelé (sélecteur remplacé) ou déjà consommé (ligne supprimée) donne exactement la même réponse, en GET comme en POST :

  • code HTTP 404 ;
  • gabarit templates/invitation/invalid.html.twig, « Lien d'invitation invalide », avec le seul message « Ce lien d'invitation n'est pas valide. Demandez une nouvelle invitation à votre administrateur. » ;
  • aucun contenu dépendant de la requête (ni jeton CSRF, ni adresse, ni date) : le corps est identique octet pour octet.

Quand le format est invalide ou le sélecteur inconnu, un HMAC factice est calculé pour égaliser le coût du rejet avec celui d'un vérificateur faux.

Toutes les réponses de /invitation/{token} (formulaire, erreurs, réponse neutre) portent :

En-tête Valeur Raison
Referrer-Policy no-referrer Le jeton de l'URL ne fuit pas vers un site tiers.
Cache-Control no-store La page n'est pas mise en cache.

Caviardage des journaux

src/Logging/InvitationTokenRedactionProcessor.php est un processor Monolog enregistré par #[AsMonologProcessor] sur tous les canaux et handlers. Il remplace le jeton par [REDACTED] :

Emplacement Remplacement
message /invitation/<60 hex> → /invitation/[REDACTED]
context.request_uri même remplacement
context.route_parameters.token [REDACTED], uniquement si context.route vaut app_invitation_accept

Un enregistrement sans correspondance est rendu inchangé. Le processor existe parce que le RouterListener de Symfony journalise l'URI et les paramètres de route sur le canal request.

Résidus connus

Sentry

Sentry (register_error_listener: true, config/packages/sentry.yaml) capture l'URL de la requête lors d'une erreur 500, hors Monolog. Le processor de caviardage ne la couvre pas : une 500 sur /invitation/{token} envoie le jeton à Sentry. Le risque est borné : jeton à usage unique, valable 72 h, invalidé par un renvoi.

Message Messenger

L'e-mail part sous forme de SendEmailMessage sérialisé sur le transport async (RabbitMQ). Ce message contient l'URL d'acceptation, donc le jeton. Après échec définitif, il est conservé dans le transport failed (table messenger_messages). La table invitation, elle, ne contient jamais le jeton. C'est le même résidu que pour la réinitialisation de mot de passe.

Désactivation et réactivation

Un compte désactivé porte une date dans User::$disabledAt (colonne disabled_at, nullable). Rien d'autre n'est modifié : la réactivation remet la colonne à null sans perte. L'état se lit par un prédicat unique, User::isActive() (src/Entity/User.php), vrai si et seulement si disabledAt et deletedAt valent null.

Méthode de User Effet
disable(\DateTimeImmutable $at) Pose disabledAt. Idempotente : garde la date de la première désactivation.
enable() Remet disabledAt à null. Ne touche pas deletedAt.
softDelete(\DateTimeImmutable $at) Pose deletedAt. Idempotente. Ne touche pas disabledAt.
restore(\DateTimeImmutable $at) Remet deletedAt à null et pose disabledAt s'il était null (une date antérieure est conservée). Après l'appel, isActive() est toujours faux.

Seul src/Service/User/AccountStateManager.php appelle ces transitions en dehors des fixtures. La suppression logique et la réintégration sont détaillées dans Suppression logique et réintégration ; l'autorisation, le service, les refus et les jetons CSRF décrits ci-dessous couvrent les quatre gestes. La suppression définitive a son propre service ; son attribut de Voter et son jeton CSRF figurent dans les tables ci-dessous.

Routes

Nom Chemin Méthodes Accès Contrôleur
app_admin_users /admin/utilisateurs GET ROLE_ADMIN src/Controller/AppAdminUsersController.php
app_admin_user_disable /admin/utilisateurs/{id}/desactiver GET, POST USER_DISABLE sur le compte src/Controller/AppAdminUserDisableController.php
app_admin_user_enable /admin/utilisateurs/{id}/reactiver POST USER_ENABLE sur le compte src/Controller/AppAdminUserEnableController.php
  • {id} est contraint par Requirement::UUID_V7 et résolu en entité User ; un identifiant inconnu donne un 404.
  • Les trois routes sont sous ^/admin : mêmes règles de visiteur anonyme (redirection vers /admin/login) et de compte de l'espace utilisateur (404) que pour les invitations.
  • app_admin_user_disable en GET rend l'écran de confirmation templates/admin/users/disable.html.twig ; en POST, il désactive puis redirige vers app_admin_users.
  • app_admin_user_enable n'a pas d'écran : il réactive puis redirige vers app_admin_users.

Tous les formulaires sont en HTML natif (POST puis redirection), fonctionnels sans JavaScript.

Liste des comptes

app_admin_users charge les comptes par UserRepositoryInterface::findNotDeletedWithModerationNotes() : tous les comptes dont deletedAt est null, actifs et désactivés mêlés, triés par e-mail croissant, avec leurs notes de modération et leurs auteurs en une seule requête (fetch join), notes triées de la plus récente à la plus ancienne.

Paramètre filter Comptes affichés
active isActive() vrai
disabled isActive() faux
absent ou toute autre valeur tous

Le filtrage se fait en PHP sur isActive(). Les compteurs des cartes Tous, Actifs et Désactivés sont calculés sur la liste non filtrée. La carte du filtre courant porte aria-current="true".

Chaque ligne porte deux actions : « Désactiver » si le compte est actif, sinon « Réactiver » ; puis « Supprimer », lien vers l'écran d'avertissement. Le caractère opérant de chaque action dépend uniquement du Voter, interrogé par access_decision() dans templates/admin/users/index.html.twig. Une action refusée est rendue par templates/admin/users/_denied_action.html.twig : <button type="button" class="btn btn-sm bo-action" aria-disabled="true">, hors de tout formulaire, jamais avec l'attribut disabled, relié par aria-describedby à un <span class="bo-action__reason"> qui affiche la première raison du Voter (ou « Action indisponible. » à défaut). Le bouton reste focalisable et ne soumet rien.

Rendu :

Élément Markup
Filtres Trois liens bo-stat bo-stat--link dans un role="group" ; la carte courante porte is-active et aria-current="true".
Tableau <table class="bo-table bo-users__table"> enveloppé dans <div class="bo-table-wrap" role="region" aria-labelledby="users-table-title" tabindex="0">, nommé par une <caption class="sr-only">. Seul ce conteneur défile horizontalement.
Actions de ligne Regroupées dans <div class="bo-actions">. « Désactiver » et « Supprimer » : liens btn btn-danger btn-sm vers les écrans de confirmation ; « Réactiver » : formulaire POST avec bouton btn btn-secondary btn-sm. Chaque libellé est complété, pour les lecteurs d'écran, par « le compte adresse » en sr-only.
Motifs Seconde ligne <tr class="bo-note-row"><td colspan="7">.

Aucun Live Component ni data-controller : la page, ses filtres et ses dépliants fonctionnent sans JavaScript. Les classes CSS sont décrites dans Design system — Composants de la gestion des comptes.

Autorisation : UserManagementVoter

src/Security/Voter/UserManagementVoter.php vote sur un sujet App\Entity\User.

Constante Attribut
UserManagementVoter::DISABLE USER_DISABLE
UserManagementVoter::ENABLE USER_ENABLE
UserManagementVoter::DELETE USER_DELETE
UserManagementVoter::RESTORE USER_RESTORE
UserManagementVoter::PURGE USER_PURGE

Contrôles, dans l'ordre. Le premier qui échoue refuse et pose sa raison sur le Vote :

Attribut Condition de refus Raison
tous Le token ne porte pas un App\Entity\User. « Authentification requise. »
tous Le token n'a pas ROLE_ADMIN (décidé par l'AccessDecisionManager). « Action réservée aux administrateurs. »
USER_DISABLE Le compte visé est celui de l'acteur (UUID comparés par equals()). « Vous ne pouvez pas désactiver votre propre compte : Kirexo doit toujours garder un administrateur actif. »
USER_DISABLE Le compte visé n'est pas actif. « Ce compte n'est pas actif. »
USER_ENABLE Le compte visé est supprimé (deletedAt non null). « Un compte supprimé se réintègre, il ne se réactive pas. »
USER_ENABLE Le compte visé est déjà actif. « Ce compte est déjà actif. »
USER_DELETE Le compte visé est celui de l'acteur (UUID comparés par equals()). « Vous ne pouvez pas supprimer votre propre compte : Kirexo doit toujours garder un administrateur actif. »
USER_DELETE Le compte visé est déjà supprimé. « Ce compte est déjà supprimé. »
USER_RESTORE Le compte visé n'est pas supprimé. « Ce compte n'est pas supprimé. »
USER_PURGE Le compte visé est celui de l'acteur (UUID comparés par equals()). « Vous ne pouvez pas supprimer définitivement votre propre compte. »
USER_PURGE Le compte visé n'est pas supprimé (deletedAt vaut null) : actif ou seulement désactivé. « Seul un compte supprimé peut être supprimé définitivement. »

USER_DELETE est accordé sur un compte actif comme sur un compte désactivé, administrateur ou non. USER_PURGE n'est accordé que sur un compte supprimé logiquement, administrateur ou non ; il ne contrôle pas l'invariant « au moins un administrateur actif », un compte supprimé n'étant déjà plus un administrateur actif.

Un refus du Voter sur une route donne un 403. Le Voter ne compte pas les administrateurs actifs : ce contrôle appartient au service (voir ci-dessous).

Service : AccountStateManager

Contrat : src/Service/User/AccountStateManagerInterface.php, implémenté par src/Service/User/AccountStateManager.php (alias déclaré dans config/services.yaml).

Méthode Rôle
disable(User $account, User $actor, ?string $justification): void Désactive le compte ; enregistre et envoie la justification si elle est fournie.
enable(User $account, User $actor): void Réactive un compte désactivé et non supprimé. Ni note, ni e-mail.
delete(User $account, User $actor, ?string $justification): void Supprime logiquement le compte ; enregistre et envoie la justification si elle est fournie. Voir delete().
restore(User $account, User $actor): void Réintègre un compte supprimé, qui revient désactivé. Ni événement, ni note, ni e-mail. Voir restore().

Chaque méthode opère dans UserRepositoryInterface::transactional(), qui délègue à EntityManager::wrapInTransaction() : commit si la closure réussit ; sinon rollback, EntityManager fermé et exception relancée.

disable(), dans l'ordre :

  1. La justification est normalisée : trim(), et une chaîne vide devient null.
  2. Dans la transaction :
    1. contrôle de l'invariant administrateur (voir ci-dessous) ;
    2. relecture verrouillée du compte (findForUpdate()) ; refus accountGone s'il n'existe plus ;
    3. refus accountStateChanged si le compte n'est plus actif ;
    4. User::disable() avec l'heure de l'horloge Symfony (ClockInterface) ;
    5. si une justification est présente, User::recordModerationNote() avec l'acteur, ModerationAction::Disabled et la même heure ;
    6. save() avec flush ;
    7. dispatch synchrone de UserAccessRevoked.
  3. Après le commit : entrée d'audit account.disabled, puis envoi de l'e-mail si une justification est présente.

enable(), dans l'ordre :

  1. Dans la transaction : relecture verrouillée du compte (refus accountGone s'il n'existe plus) ; refus accountStateChanged s'il est supprimé ou déjà actif ; User::enable() ; save() avec flush ; dispatch synchrone de UserAccessRestored.
  2. Après le commit : entrée d'audit account.enabled.

Un abonné de UserAccessRevoked ou UserAccessRestored qui lève une exception annule toute l'opération : état, note de modération, audit de réussite et e-mail. Détail des événements : Événements de domaine de l'état d'un compte.

enable() ne contrôle pas l'invariant administrateur : une réactivation ne peut qu'ajouter des administrateurs actifs.

Invariant « au moins un administrateur actif »

Il reste toujours au moins un compte actif portant ROLE_ADMIN. Il se décline en trois refus :

# Refus Portée
F-a Un administrateur ne peut pas se désactiver lui-même. Toujours, même s'il reste d'autres administrateurs actifs.
F-b Un administrateur ne peut pas se supprimer lui-même. Toujours, même s'il reste d'autres administrateurs actifs.
F-c Personne ne peut désactiver ou supprimer le dernier administrateur actif. Même un autre administrateur, même par un POST forgé.

Une invitation d'administrateur non acceptée ne compte pas : aucun compte n'existe derrière elle. L'invariant est protégé à deux niveaux :

  • le Voter refuse l'auto-désactivation et l'auto-suppression ;
  • le service revérifie, sous verrou, avant toute écriture, dans disable() et delete().

enable() et restore() ne le contrôlent pas : ni l'une ni l'autre ne peut retirer un administrateur actif.

Contrôle du service (AccountStateManager::assertAdminInvariant(), privé) :

  1. Si le compte visé est celui de l'acteur : refus selfRevocation.
  2. UserRepositoryInterface::lockActiveAdminIds() verrouille et retourne les identifiants des administrateurs actifs.
  3. Si le compte visé fait partie de ces identifiants et qu'il y en a au plus un : refus lastActiveAdmin.

Requête de lockActiveAdminIds() (src/Repository/UserRepository.php) :

SELECT id FROM "user"
 WHERE roles::jsonb @> '["ROLE_ADMIN"]'
   AND disabled_at IS NULL AND deleted_at IS NULL
 ORDER BY id
   FOR UPDATE
Méthode du repository Verrou Hors transaction
lockActiveAdminIds(): list<Uuid> FOR UPDATE sur les lignes des administrateurs actifs, acquis dans l'ordre des id. \LogicException
findForUpdate(Uuid $id): ?User PESSIMISTIC_WRITE sur la ligne du compte ; l'instance gérée est rafraîchie (Query::HINT_REFRESH). Retourne null si le compte n'existe plus. exception Doctrine (TransactionRequiredException)

Les verrous sont tenus jusqu'à la fin de la transaction qui écrit. Deux désactivations ou suppressions concurrentes de deux administrateurs sont donc sérialisées : la seconde attend, relit un jeu d'administrateurs actifs réduit, puis refuse.

Un compte déjà désactivé ne fait pas partie du jeu verrouillé : sa suppression n'est jamais refusée pour lastActiveAdmin, seulement pour selfRevocation.

Refus et messages

Les refus du service lèvent src/Service/User/Exception/AdminInvariantViolationException.php. Son message est affiché tel quel en flash user_error.

Code de refus (audit) Fabrique Message Méthodes
selfRevocation selfRevocation(ModerationAction::Disabled) « Vous ne pouvez pas désactiver votre propre compte. » disable()
selfRevocation selfRevocation(ModerationAction::Deleted) « Vous ne pouvez pas supprimer votre propre compte. » delete()
lastActiveAdmin lastActiveAdmin(ModerationAction::Disabled) « Ce compte est le dernier administrateur actif : impossible de le désactiver. Kirexo ne peut pas rester sans administrateur. » disable()
lastActiveAdmin lastActiveAdmin(ModerationAction::Deleted) « Ce compte est le dernier administrateur actif : impossible de le supprimer. Kirexo ne peut pas rester sans administrateur. » delete()
accountStateChanged accountStateChanged() « L'état de ce compte a changé entretemps. Rechargez la liste. » disable(), enable(), delete()
accountGone accountGone() « Ce compte n'existe plus : il a été supprimé définitivement entretemps. » toutes
notDeleted notDeleted() « Ce compte n'est pas supprimé : il n'y a rien à réintégrer. » restore()

Réponses des contrôleurs :

Situation Réponse
Refus du Voter 403
Jeton CSRF invalide 403
Justification de plus de 2000 caractères après trim() (désactivation, suppression) 422, formulaire réaffiché avec le texte saisi et « La justification ne doit pas dépasser 2000 caractères. »
Adresse de confirmation différente de celle du compte (suppression) 422, écran réaffiché avec la justification saisie et « L'adresse saisie ne correspond pas à celle du compte. »
AdminInvariantViolationException flash user_error, redirection vers app_admin_users
Désactivation réussie flash user_success « Le compte adresse est désactivé. », complété par « Le motif lui est envoyé par e-mail et reste affiché à côté du compte. » si une justification non vide a été saisie
Réactivation réussie flash user_success « Le compte adresse est réactivé. »
Suppression réussie flash user_success « Le compte adresse est supprimé. Rien n'est détruit : il est réintégrable depuis l'encart des comptes supprimés. », complété par « Le motif lui est envoyé par e-mail et reste affiché à côté du compte. » si une justification non vide a été saisie
Réintégration réussie flash user_success « Le compte adresse est réintégré. Il est désactivé : réactivez-le séparément pour le remettre en ligne. »

Les flashes user_success et user_error sont affichés par templates/base_admin.html.twig.

Jetons CSRF

Formulaire Identifiant
Désactivation user_disable-<id RFC 4122>
Réactivation user_enable-<id RFC 4122>
Suppression user_delete-<id RFC 4122>
Réintégration user_restore-<id RFC 4122>
Suppression définitive user_purge-<id RFC 4122>

Transmis dans le champ _csrf_token.

Notes de modération

Une justification de désactivation ou de suppression est conservée dans une UserModerationNote (src/Entity/UserModerationNote.php, table user_moderation_note).

Champ Type Contenu
id UUIDv7 Identifiant de la note.
user User, non nul Compte concerné. Clé étrangère ON DELETE CASCADE.
author User, nullable Administrateur auteur. Clé étrangère ON DELETE SET NULL : l'auteur s'affiche « — » si son compte n'existe plus.
action ModerationAction Disabled (libellé « Désactivation ») ou Deleted (« Suppression »).
justification texte Texte saisi, après trim(). Non vide, UserModerationNote::JUSTIFICATION_MAX_LENGTH (2000) caractères au plus.
occurredAt date-heure Heure du geste : identique à disabledAt pour une désactivation, à deletedAt pour une suppression.
  • Création : uniquement par User::recordModerationNote(), persistée par cascade avec le compte. Aucun repository de notes n'existe.
  • Durée de vie : aucune route ne modifie ni ne supprime une note. Une réactivation ou une réintégration la conserve ; une suppression ajoute la sienne sans écraser celles des désactivations. Elle disparaît seulement avec la ligne du compte (cascade SQL).
  • Affichage : sous la ligne du compte dans app_admin_users, dans la liste principale comme dans l'encart des comptes supprimés, par templates/admin/users/_moderation_notes.html.twig. La note la plus récente est affichée en clair ; à partir de deux notes, les précédentes sont dans un <details> « Historique des motifs (n) ». Le texte est échappé puis passé à nl2br.

E-mail au titulaire

Envoyé par AccountStateManager::disable() et AccountStateManager::delete() uniquement si une justification non vide a été saisie, après le commit de la transaction.

Élément Valeur
Destinataire Adresse du compte désactivé ou supprimé.
Sujet « Kirexo : désactivation de votre compte » ou « Kirexo : suppression de votre compte », dérivé du libellé de ModerationAction
Gabarit templates/email/account_moderation.html.twig, qui étend email/base.html.twig
Contexte firstName, action, justification, space (user)
Expéditeur Aucun from() explicite : valeur de framework.mailer.headers.From.
Transport async (Messenger), comme tous les e-mails.

Contenu, selon action :

action Titre Phrase
Disabled « Votre compte Kirexo a été désactivé » « Un administrateur de Kirexo a désactivé votre compte. Vous ne pouvez plus vous connecter. »
Deleted « Votre compte Kirexo a été supprimé » « Un administrateur de Kirexo a supprimé votre compte. Vous ne pouvez plus vous connecter. »

Le titre est suivi d'une salutation par le prénom et de la phrase, puis de la justification (nl2br). L'e-mail ne contient aucun lien et aucune donnée du compte autre que le prénom. La réactivation et la réintégration n'envoient aucun e-mail.

Effets sur l'accès du compte

Mécanisme Fichier Effet pour un compte non actif
UserChecker::checkPreAuth() src/Security/UserChecker.php Lève DisabledException sur les deux firewalls, pour le formulaire, le cookie « Se souvenir de moi » et le jeton de bascule d'espace. Le message affiché est celui d'identifiants invalides.
User::isEqualTo() src/Entity/User.php Une session ouverte est désauthentifiée à la requête suivante si l'identifiant, le mot de passe, les rôles (sans tenir compte de l'ordre), disabledAt ou deletedAt (comparés à la seconde) ont changé.
signature_properties config/packages/security.yaml Le hash du cookie remember-me inclut password, disabledAt et deletedAt.
PasswordResetRequestProcessor src/Security/PasswordResetRequestProcessor.php Aucune demande de réinitialisation n'est créée ni envoyée ; la page de confirmation neutre est la même.

Configuration détaillée : security.yaml. Raisonnement : Couper l'accès d'un compte.

Effets publics d'un compte non actif

Un compte non actif (User::isActive() faux), désactivé ou supprimé, n'a aucune présence publique. Les effets s'appliquent dès la requête qui suit le commit de la désactivation ou de la suppression, et s'annulent de la même façon à la réactivation. Une réintégration ne les annule pas : le compte revient désactivé.

Surface Mécanisme Fichier Compte non actif
Sites du plugin Web (accueil, article, page spéciale, feuille de style, sonde) Gate SitePublicAccessChecker::isPluginEnabledForOwner() src/Service/Plugin/SitePublicAccessChecker.php 404 sur tous les domaines du compte. Voir SitePublicAccessCheckerInterface.
Requêtes de lecture du plugin Web (page d'articles, comptage, article unitaire) Jointure JOIN "user" u ON u.id = a.author_id AND u.disabled_at IS NULL AND u.deleted_at IS NULL src/Plugin/Web/src/Repository/PublishedWebArticleFinder.php Articles exclus (défense en profondeur, derrière le gate).
Cache de rendu des sites UserAccessCacheSubscriber src/Plugin/Web/src/EventSubscriber/UserAccessCacheSubscriber.php Cache de chaque site invalidé à la désactivation, à la suppression et à la réactivation.
Fil d'accueil de la plateforme (app_home) ArticleRepositoryInterface::findPublishedForPublic() src/Repository/ArticleRepository.php Articles exclus. Si tous les articles publiés sont concernés, l'accueil affiche l'état vide.
Dashboard de modération (app_admin_dashboard) ArticleRepositoryInterface::findPublishedForModeration() src/Repository/ArticleRepository.php Articles toujours listés et comptés dans les indicateurs.

Méthodes de lecture des articles publiés :

Méthode Filtre sur l'auteur Consommateur
findPublishedForPublic(): array Jointure interne sur l'auteur, disabledAt IS NULL et deletedAt IS NULL ; auteur hydraté dans la même requête. ArticleFeedProvider::publishedFeed() (src/Service/Article/ArticleFeedProvider.php)
findPublishedForModeration(): array Aucun. AppAdminDashboardController (src/Controller/AppAdminDashboardController.php)

Les deux retournent une list<Article> d'articles published, triés par publishedAt décroissant. Les autres lectures (countPublished(), findPublishedAnalyzedIds(), …) ne filtrent pas l'auteur.

Résiduel : /site.css

La feuille de style publique d'un site est servie avec Cache-Control: public, max-age=300 : une copie peut rester jusqu'à 5 minutes dans un cache navigateur ou proxy après la désactivation. Voir SitePublicAccessCheckerInterface.

Raisonnement : Effacement public.

Suppression logique et réintégration

Un compte supprimé porte une date dans User::$deletedAt (colonne deleted_at, nullable). Rien n'est détruit : compte, carnets, articles, sites, domaines et notes de modération restent en base. La suppression ne touche pas disabledAt : un compte peut être désactivé puis supprimé. Aucune migration n'accompagne ces gestes.

L'adresse e-mail d'un compte supprimé reste occupée (unicité sur toute la table "user") : elle ne peut pas être réinvitée (voir Contrôles à l'émission). Elle ne redevient libre qu'après la suppression définitive du compte.

L'autorisation (USER_DELETE, USER_RESTORE), les refus, les réponses des contrôleurs et les jetons CSRF sont décrits avec ceux de la désactivation, dans Désactivation et réactivation.

Routes

Nom Chemin Méthodes Accès Contrôleur
app_admin_user_delete /admin/utilisateurs/{id}/supprimer GET, POST USER_DELETE sur le compte src/Controller/AppAdminUserDeleteController.php
app_admin_user_restore /admin/utilisateurs/{id}/reintegrer POST USER_RESTORE sur le compte src/Controller/AppAdminUserRestoreController.php
  • {id} est contraint par Requirement::UUID_V7 et résolu en entité User ; un identifiant inconnu donne un 404.
  • Les deux routes sont sous ^/admin et suivent les mêmes règles d'accès que les autres routes admin.
  • Le Voter est évalué en GET comme en POST : l'écran d'avertissement de sa propre ligne ou d'un compte déjà supprimé répond 403, de même qu'un POST forgé.
  • app_admin_user_restore n'a pas d'écran : il réintègre puis redirige vers app_admin_users.

Aucun Live Component, aucun confirm() JavaScript : formulaires HTML natifs (POST puis redirection), fonctionnels sans JavaScript.

Écran d'avertissement

app_admin_user_delete en GET rend templates/admin/users/delete.html.twig :

  • fil d'Ariane Admin › Utilisateurs › Supprimer ;
  • titre « Supprimer le compte de prénom » et rappel de l'adresse ;
  • avertissement, dans un encadré .bo-callout--danger : suppression logique, rien n'est détruit, connexion impossible, sessions coupées, contenu retiré de l'espace public, compte réintégrable, effacement réel distinct et ultérieur ;
  • l'inventaire du compte (templates/admin/users/_inventory.html.twig) ;
  • le formulaire de confirmation.

Inventaire, strictement quantitatif (aucun titre ni contenu d'article) :

Rubrique Source Contenu
Carnets UserRepositoryInterface::countContentByOwner(), clé notebooks Nombre de carnets possédés, actifs et archivés.
Articles countContentByOwner(), clés articles et publishedArticles « n, dont m publiés » : articles dont le compte est l'auteur, tous statuts, dont ceux au statut published.
Présence publique PublicPresenceInventory::labelsFor() Liste des libellés déclarés par les plugins (domaines pour le plugin Web), ou « Aucune présence publique déclarée par les plugins. ». Voir PublicPresenceInventoryInterface.
Rôles User::getRoles() Libellés des rôles, suivis de « ce compte est administrateur. » si le compte porte ROLE_ADMIN.

countContentByOwner(User $owner): array renvoie array{notebooks: int, articles: int, publishedArticles: int}, calculé en deux requêtes scalaires sans hydratation ; un compte sans contenu donne trois zéros.

Formulaire (champ _csrf_token = jeton user_delete-<id RFC 4122>) :

Champ Élément Contrainte
email_confirmation <input type="text" inputmode="email" autocomplete="off" required>, libellé « Pour confirmer, saisissez l'adresse e-mail du compte » Comparé à l'adresse du compte après trim() et passage en minuscules des deux côtés.
justification <textarea maxlength="2000">, libellé « Justification (facultative) » 2000 caractères au plus après trim(). La notice « Si vous remplissez ce champ, son contenu sera envoyé par e-mail au titulaire du compte, puis conservé et affiché à côté de ce compte. » est placée au-dessus du champ et lui est reliée par aria-describedby.

Boutons, dans un groupe .bo-actions : « Supprimer le compte » (btn btn-danger) et le lien « Annuler » (btn btn-secondary) vers app_admin_users. Aucun des deux n'est btn-primary.

Traitement du POST, dans l'ordre :

  1. Jeton CSRF invalide : 403.
  2. Justification trop longue : 422, écran réaffiché.
  3. Adresse de confirmation différente : 422, écran réaffiché, inventaire recalculé, justification conservée ; le champ de confirmation est vide. Aucune écriture.
  4. Appel de AccountStateManager::delete(), puis flash et redirection vers app_admin_users.

Un message d'erreur de l'écran est affiché dans un <p role="alert">, relié au champ de confirmation par aria-describedby.

Service : delete() et restore()

delete(), dans l'ordre :

  1. La justification est normalisée : trim(), et une chaîne vide devient null.
  2. Dans la transaction :
    1. contrôle de l'invariant administrateur avec ModerationAction::Deleted ;
    2. relecture verrouillée du compte (findForUpdate()) ; refus accountGone s'il n'existe plus ;
    3. refus accountStateChanged si le compte est déjà supprimé (double soumission, suppression concurrente) ;
    4. User::softDelete() avec l'heure de l'horloge Symfony ;
    5. si une justification est présente, User::recordModerationNote() avec l'acteur, ModerationAction::Deleted et la même heure ;
    6. save() avec flush ;
    7. dispatch synchrone de UserAccessRevoked, même si le compte était déjà désactivé.
  3. Après le commit : entrée d'audit account.deleted, puis envoi de l'e-mail si une justification est présente.

restore(), dans l'ordre :

  1. Dans la transaction : relecture verrouillée du compte (refus accountGone s'il n'existe plus) ; refus notDeleted s'il n'est pas supprimé ; User::restore() ; save() avec flush.
  2. Après le commit : entrée d'audit account.restored.

restore() ne contrôle pas l'invariant administrateur, n'émet aucun événement, ne crée aucune note et n'envoie aucun e-mail. Après réintégration, deletedAt est null, disabledAt est non nul et isActive() est faux : le compte réapparaît dans la liste principale à l'état « Désactivé », avec sa date de désactivation d'origine s'il en avait une, sinon l'heure de la réintégration. Sa remise en ligne passe par app_admin_user_enable.

Un abonné de UserAccessRevoked qui lève une exception pendant delete() annule toute l'opération : deletedAt reste null, aucune note, aucun audit de réussite, aucun e-mail.

Encart des comptes supprimés

app_admin_users charge aussi les comptes supprimés par UserRepositoryInterface::findDeletedWithModerationNotes() : comptes dont deletedAt n'est pas null, triés par deletedAt décroissant puis par e-mail croissant, avec leurs notes de modération et leurs auteurs en une seule requête (fetch join), notes triées de la plus récente à la plus ancienne.

Ces comptes sont absents de la liste principale et des compteurs Tous, Actifs, Désactivés. Ils sont rendus après le tableau principal, quel que soit le paramètre filter :

Élément Valeur
Conteneur <details class="bo-disclosure bo-users-deleted">, sans attribut open ni data-controller : replié par défaut, dépliable sans JavaScript. Le tableau interne est enveloppé dans un .bo-table-wrap (région deleted-users-table-title).
Résumé « Comptes supprimés (n) »
Liste vide « Aucun compte supprimé. »
Colonnes E-mail, Prénom, Rôles, Supprimé le (d/m/Y H:i), actions.
Action « Réintégrer » Formulaire POST vers app_admin_user_restore, jeton user_restore-<id RFC 4122>. Si USER_RESTORE est refusé, action inopérante rendue par _denied_action.html.twig.
Action « Supprimer définitivement » Lien <a class="btn btn-sm bo-btn-purge">, avec une icône SVG aria-hidden="true", vers l'écran d'avertissement de app_admin_user_purge, jamais une suppression directe. Variante pleine, distincte du btn-danger de la suppression logique. Rendu seulement si is_granted(USER_PURGE, compte) ; sinon rien n'est affiché (pas d'action inopérante).
Motifs Seconde ligne bo-note-row sous le compte, même rendu que dans la liste principale.

Suppression définitive

La suppression définitive efface réellement un compte déjà supprimé logiquement, et tout ce qui s'y rapporte. C'est le seul geste d'administration qui exécute un DELETE sur la table "user". Son seul point d'entrée dans l'interface est l'encart des comptes supprimés.

Route

Nom Chemin Méthodes Accès Contrôleur
app_admin_user_purge /admin/utilisateurs/{id}/supprimer-definitivement GET, POST USER_PURGE sur le compte src/Controller/AppAdminUserPurgeController.php
  • {id} est contraint par Requirement::UUID_V7 et résolu en entité User : un compte inconnu, ou déjà effacé, donne un 404.
  • La route est sous ^/admin et suit les mêmes règles d'accès que les autres routes admin.
  • #[IsGranted(UserManagementVoter::PURGE)] protège GET et POST : l'URL d'un compte actif ou désactivé répond 403, même saisie à la main.
  • Aucun Live Component, aucun confirm() JavaScript : formulaire HTML natif (POST puis redirection), fonctionnel sans JavaScript.

Écran d'avertissement

app_admin_user_purge en GET rend templates/admin/users/purge.html.twig, distinct de l'écran de suppression logique :

  • titre de page « Supprimer définitivement — Admin — Kirexo », fil d'Ariane Admin › Utilisateurs › Supprimer définitivement ;
  • titre « Supprimer définitivement le compte adresse » ;
  • avertissement, avant l'inventaire, dans un encadré .bo-callout--danger.bo-callout--purge titré « Effacement irréversible » :
    • tout sera réellement détruit, sans retour possible : compte, carnets, articles, révisions, analyses, demandes de réinitialisation, activations de plugin, motifs de modération, sites publics, domaines, pages spéciales et thèmes ;
    • les URL publiques des articles deviennent définitivement introuvables (404) ;
    • l'adresse redevient disponible et pourra être réinvitée ;
    • aucun e-mail n'est envoyé au titulaire ;
  • l'inventaire du compte, même partiel et mêmes sources que pour la suppression logique (_inventory.html.twig, countContentByOwner(), PublicPresenceInventory::labelsFor()) ;
  • le formulaire de confirmation.

Formulaire (champ _csrf_token = jeton user_purge-<id RFC 4122>) :

Champ Élément Contrainte
email_confirmation <input type="text" inputmode="email" autocomplete="off" required>, libellé « Pour confirmer, saisissez l'adresse e-mail du compte » Comparé à l'adresse du compte après trim() et passage en minuscules des deux côtés.

Il n'y a pas de champ de justification. Boutons, dans un groupe .bo-actions : « Supprimer définitivement » (btn bo-btn-purge, variante pleine avec icône SVG aria-hidden="true") et le lien « Annuler » (btn btn-secondary) vers app_admin_users. Aucun des deux n'est btn-primary. Un message d'erreur est affiché dans un <p role="alert"> relié au champ par aria-describedby.

Traitement du POST, dans l'ordre :

  1. Jeton CSRF invalide : 403.
  2. Adresse de confirmation différente : 422, écran réaffiché avec « L'adresse saisie ne correspond pas à celle du compte. » et l'inventaire recalculé. Le service n'est pas appelé.
  3. Appel de AccountPurgerInterface::purge(), puis flash et redirection vers app_admin_users.

Service : AccountPurger

Contrat : src/Service/User/AccountPurgerInterface.php, implémenté par src/Service/User/AccountPurger.php (alias déclaré dans config/services.yaml).

Méthode Rôle
purge(User $account, User $actor): void Efface le compte supprimé logiquement, en une transaction. Lève AccountPurgeException sur refus ou échec.

purge(), dans l'ordre :

  1. Capture de l'identifiant du compte, de celui de l'acteur, et de l'empreinte emailHash de l'adresse.
  2. Dans UserRepositoryInterface::transactional() :
    1. relecture verrouillée du compte (findForUpdate(), PESSIMISTIC_WRITE, instance rafraîchie) ; refus alreadyPurged s'il n'existe plus ;
    2. refus notDeleted si deletedAt vaut null (défense serveur indépendante du Voter : une réintégration a pu se produire depuis l'affichage de l'écran) ;
    3. dispatch synchrone de UserPurged ;
    4. UserRepositoryInterface::remove($compte, true) : un seul flush pour les suppressions programmées par les plugins et le DELETE du compte.
  3. Après le commit : entrée d'audit account.purged.

Aucune notification : ni e-mail, ni note de modération. L'invariant « au moins un administrateur actif » n'est pas contrôlé.

UserRepositoryInterface::remove(User $user, bool $flush = true): void programme la suppression de l'entité, puis flushe si $flush vaut true.

Aucun accès Doctrine après purge() dans la même requête

En cas d'échec, wrapInTransaction() ferme l'EntityManager. En cas de succès, les lignes supprimées par cascade en base restent dans l'identity map. Le contrôleur ne fait donc que poser un flash et rediriger. Entre deux requêtes, le kernel.reset de Doctrine vide ou réinitialise l'EntityManager.

Concurrence avec une réintégration (qui relit elle aussi sous verrou) : la première opération à verrouiller la ligne l'emporte. Si la réintégration commite d'abord, la purge refuse avec notDeleted ; si la purge commite d'abord, la réintégration refuse avec accountGone.

Ce qui est effacé

Données Mécanisme
Sites du plugin Web, et avec eux domaines et pages spéciales Abonné UserPurgedSubscriber (suppression des sites), puis ON DELETE CASCADE depuis le site. Cache de chaque site invalidé.
Thèmes personnels du plugin Web Abonné UserPurgedSubscriber (référence sans clé étrangère).
Carnets, articles, révisions, analyses ON DELETE CASCADE depuis le compte (propriétaire du carnet ou auteur de l'article).
Demandes de réinitialisation de mot de passe ON DELETE CASCADE.
Activations de plugin ON DELETE CASCADE.
Motifs de modération du compte ON DELETE CASCADE sur user_moderation_note.user.
Données conservées Mécanisme
Motifs de modération écrits par le compte sur d'autres comptes ON DELETE SET NULL sur author : auteur affiché « — ».
Invitations émises par le compte ON DELETE SET NULL sur invitedBy : « Invitée par » affiche « — ».
Comptes invités par le compte ON DELETE SET NULL sur User.invitedBy.
Entrées du journal audit Hors base. Seule trace qui survit, sans l'adresse en clair.

L'adresse redevient libre : une invitation vers elle est acceptée.

Refus de la suppression définitive

Les refus et échecs du service lèvent src/Service/User/Exception/AccountPurgeException.php. Son message est affiché tel quel en flash user_error ; le détail technique d'un échec est chaîné en exception précédente et ne va qu'au journal.

Code (reason()) Fabrique Message
notDeleted notDeleted() « Seul un compte supprimé peut être supprimé définitivement. »
alreadyPurged alreadyPurged() « Ce compte a déjà été supprimé définitivement. »
purgeFailed failed(\Throwable $previous) « La suppression définitive a échoué : rien n'a été supprimé. »

purgeFailed couvre toute autre exception survenue dans la transaction : exception d'un abonné de UserPurged, échec du flush, violation de contrainte. Le rollback est complet : aucune donnée, ni du cœur ni des plugins, n'est supprimée.

Réponses du contrôleur :

Situation Réponse
Refus du Voter (compte actif, désactivé, ou propre compte) 403
Compte inconnu ou déjà effacé 404
Jeton CSRF invalide 403
Adresse de confirmation différente 422, écran réaffiché
AccountPurgeException flash user_error, redirection vers app_admin_users
Suppression définitive réussie flash user_success « Le compte adresse a été supprimé définitivement. Son adresse peut de nouveau être invitée. », redirection vers app_admin_users

Journal d'audit

Les actions de gestion des comptes sont journalisées sur le canal Monolog audit, déclaré dans config/packages/monolog.yaml. Les services émetteurs le reçoivent par #[WithMonologChannel('audit')].

Destination

Environnement Handler Sortie
prod audit (type: stream, level: info, formateur JSON) php://stderr, écrit immédiatement. Le canal est exclu du handler main (channels: ["!audit"]), dont le fingers_crossed ne conserverait un info qu'en cas d'erreur dans la requête.
dev main var/log/dev.log
test main (fingers_crossed) var/log/test.log, seulement si une erreur survient

Format des entrées

  • Le message est le nom de l'événement (ex. invitation.issued).
  • Le contexte utilise des clés en camelCase. Les identifiants sont au format RFC 4122 ; les dates en ISO 8601 (DATE_ATOM).
  • Aucune entrée ne contient de jeton, de vérificateur, de sélecteur ni d'URL d'acceptation.
  • Une entrée de réussite est écrite après la validation de la transaction : une opération annulée n'est pas journalisée comme réussie.
  • Exception : account.refused émise par AccountStateManager est écrite dans la transaction, juste avant le refus et le rollback. Elle trace précisément une opération annulée. Celle émise par AccountPurger, comme account.purge_failed, est écrite après le rollback.
  • Les entrées de la suppression définitive ne contiennent jamais l'adresse e-mail en clair, seulement son empreinte emailHash (voir Empreinte emailHash).

Événements émis

Événement Niveau Contexte Émetteur
invitation.issued info invitationId, email, roles, actorId, expiresAt InvitationManager::invite()
invitation.resent info invitationId, email, roles, actorId, expiresAt, rolesReplaced InvitationManager::invite() (rolesReplaced: true) et InvitationManager::resend() (rolesReplaced: false)
invitation.deleted info invitationId, email, actorId InvitationManager::delete()
invitation.accepted info invitationId, accountId, email, roles InvitationManager::accept()
account.disabled info accountId, actorId, email, roles, justification AccountStateManager::disable()
account.enabled info accountId, actorId, email, roles AccountStateManager::enable()
account.deleted info accountId, actorId, email, roles, justification AccountStateManager::delete()
account.restored info accountId, actorId, email, roles AccountStateManager::restore()
account.refused notice accountId, actorId, email, reason AccountStateManager::disable(), enable(), delete() et restore()
account.purged info accountId, actorId, emailHash AccountPurger::purge(), après le commit
account.refused notice action (purge), accountId, actorId, emailHash, reason AccountPurger::purge(), sur refus notDeleted ou alreadyPurged
account.purge_failed error action (purge), accountId, actorId, emailHash, exception AccountPurger::purge(), sur toute autre exception : rollback provoqué par un plugin ou par la base, rien n'est supprimé

actorId est l'identifiant de l'administrateur auteur de l'action ; accountId celui du compte créé (invitations) ou visé (account.*). email et roles sont ceux du compte visé. justification vaut le texte normalisé, ou null sans justification. exception est l'exception d'origine (message et trace), avant son enveloppement dans AccountPurgeException::failed().

reason porte un code stable, jamais le message affiché : selfRevocation, lastActiveAdmin, accountStateChanged, accountGone ou notDeleted pour AccountStateManager (voir Refus et messages) ; notDeleted ou alreadyPurged pour AccountPurger (voir Refus de la suppression définitive). Un account.refused sans clé action provient d'AccountStateManager. Les refus du Voter (403) ne sont pas journalisés sur ce canal, pas plus que les refus métier des invitations (adresse déjà utilisée, délai non écoulé, lien invalide).

Empreinte emailHash

Élément Valeur
Calcul hash_hmac('sha256', <adresse>, kernel.secret)
Entrée Adresse du compte telle que stockée, sans normalisation.
Clé Paramètre kernel.secret, soit APP_SECRET.
Sortie 64 caractères hexadécimaux minuscules.

L'empreinte permet de vérifier, secret en main, qu'une adresse donnée correspond à une entrée du journal ; elle ne permet pas de retrouver l'adresse par dictionnaire sans le secret. Changer APP_SECRET rend les empreintes antérieures impossibles à recalculer.

Fixtures

Compte désactivé

src/DataFixtures/UserFixtures.php charge un compte désactivé, référencé par la constante DISABLED_REFERENCE :

Adresse Prénom Rôle Désactivé Motifs
desactive@kirexo.local Dominique ROLE_USER il y a 10 jours deux notes Disabled de l'admin des fixtures : « Premier avertissement : contenu hors charte. » (−10 j) et « Compte de démonstration désactivé. » (−3 j)

Il illustre dans app_admin_users l'état « Désactivé », le motif le plus récent et « Historique des motifs (2) ».

Invitations

src/DataFixtures/InvitationFixtures.php (groupe invitations, dépend de UserFixtures) charge trois invitations à jetons connus, via castor fixtures:load :

Constante e-mail Adresse Rôle État Inviteur Usage
PENDING_EMAIL invitee@kirexo.local user En attente admin des fixtures Consommée par le test E2E d'acceptation.
PREVIEW_EMAIL apercu-invitation@kirexo.local user En attente admin des fixtures Réservée aux affichages (GET), jamais soumise.
EXPIRED_EMAIL expiree@kirexo.local both Expirée (émise il y a 4 jours) aucun (« — ») Illustre l'état « Expirée ».

Les jetons correspondants sont exposés par les constantes PENDING_TOKEN, PREVIEW_TOKEN et EXPIRED_TOKEN, réservées aux fixtures et aux tests. Par exemple, après chargement des fixtures, https://app.main.localhost/invitation/ suivi de InvitationFixtures::PREVIEW_TOKEN ouvre le formulaire d'acceptation. Les fixtures ne sont jamais chargées en production.

Voir aussi