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 parRequirement::UUID_V7; un identifiant inconnu donne un 404.{token}est contraint parInvitationTokenGenerator::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
/adminet 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() :
- Adresse
trim()ée, non vide, au format e-mail, 180 caractères au plus. - Rôle parmi
user,admin,both(src/Entity/Enum/AccountRole.php). - Adresse d'un compte supprimé : refus avec l'issue à suivre.
- 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) :
- 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()) ; - prénom non vide après
trim(), 100 caractères au plus.
- 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,
- Création, dans une seule transaction :
- un
Useravec l'adresse et les rôles de l'invitation, le mot de passe haché,invitedByetinvitedAtrenseignés (User::recordInvitation()) ; - un carnet nommé « Le carnet de <prénom> » (
Notebook::defaultName()) ; - la suppression de l'invitation.
- un
- Aucune authentification automatique. Redirection vers
app_login(/login) si le compte porteROLE_USER(rôlesuseretboth), sinon versapp_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 parRequirement::UUID_V7et 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_disableenGETrend l'écran de confirmationtemplates/admin/users/disable.html.twig; enPOST, il désactive puis redirige versapp_admin_users.app_admin_user_enablen'a pas d'écran : il réactive puis redirige versapp_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 :
- La justification est normalisée :
trim(), et une chaîne vide devientnull. - Dans la transaction :
- contrôle de l'invariant administrateur (voir ci-dessous) ;
- relecture verrouillée du compte (
findForUpdate()) ; refusaccountGones'il n'existe plus ; - refus
accountStateChangedsi le compte n'est plus actif ; User::disable()avec l'heure de l'horloge Symfony (ClockInterface) ;- si une justification est présente,
User::recordModerationNote()avec l'acteur,ModerationAction::Disabledet la même heure ; save()avec flush ;- dispatch synchrone de
UserAccessRevoked.
- 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 :
- Dans la transaction : relecture verrouillée du compte (refus
accountGones'il n'existe plus) ; refusaccountStateChangeds'il est supprimé ou déjà actif ;User::enable();save()avec flush ; dispatch synchrone deUserAccessRestored. - 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()etdelete().
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é) :
- Si le compte visé est celui de l'acteur : refus
selfRevocation. UserRepositoryInterface::lockActiveAdminIds()verrouille et retourne les identifiants des administrateurs actifs.- 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, partemplates/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 parRequirement::UUID_V7et résolu en entitéUser; un identifiant inconnu donne un 404.- Les deux routes sont sous
^/adminet suivent les mêmes règles d'accès que les autres routes admin. - Le Voter est évalué en
GETcomme enPOST: l'écran d'avertissement de sa propre ligne ou d'un compte déjà supprimé répond 403, de même qu'unPOSTforgé. app_admin_user_restoren'a pas d'écran : il réintègre puis redirige versapp_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 :
- Jeton CSRF invalide : 403.
- Justification trop longue : 422, écran réaffiché.
- Adresse de confirmation différente : 422, écran réaffiché, inventaire recalculé, justification conservée ; le champ de confirmation est vide. Aucune écriture.
- Appel de
AccountStateManager::delete(), puis flash et redirection versapp_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 :
- La justification est normalisée :
trim(), et une chaîne vide devientnull. - Dans la transaction :
- contrôle de l'invariant administrateur avec
ModerationAction::Deleted; - relecture verrouillée du compte (
findForUpdate()) ; refusaccountGones'il n'existe plus ; - refus
accountStateChangedsi le compte est déjà supprimé (double soumission, suppression concurrente) ; User::softDelete()avec l'heure de l'horloge Symfony ;- si une justification est présente,
User::recordModerationNote()avec l'acteur,ModerationAction::Deletedet la même heure ; save()avec flush ;- dispatch synchrone de
UserAccessRevoked, même si le compte était déjà désactivé.
- contrôle de l'invariant administrateur avec
- 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 :
- Dans la transaction : relecture verrouillée du compte (refus
accountGones'il n'existe plus) ; refusnotDeleteds'il n'est pas supprimé ;User::restore();save()avec flush. - 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 parRequirement::UUID_V7et résolu en entitéUser: un compte inconnu, ou déjà effacé, donne un 404.- La route est sous
^/adminet suit les mêmes règles d'accès que les autres routes admin. #[IsGranted(UserManagementVoter::PURGE)]protègeGETetPOST: 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--purgetitré « 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 :
- Jeton CSRF invalide : 403.
- 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é.
- Appel de
AccountPurgerInterface::purge(), puis flash et redirection versapp_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 :
- Capture de l'identifiant du compte, de celui de l'acteur, et de l'empreinte
emailHashde l'adresse. - Dans
UserRepositoryInterface::transactional():- relecture verrouillée du compte (
findForUpdate(),PESSIMISTIC_WRITE, instance rafraîchie) ; refusalreadyPurgeds'il n'existe plus ; - refus
notDeletedsideletedAtvautnull(défense serveur indépendante du Voter : une réintégration a pu se produire depuis l'affichage de l'écran) ; - dispatch synchrone de
UserPurged; UserRepositoryInterface::remove($compte, true): un seul flush pour les suppressions programmées par les plugins et leDELETEdu compte.
- relecture verrouillée du compte (
- 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 parAccountStateManagerest écrite dans la transaction, juste avant le refus et le rollback. Elle trace précisément une opération annulée. Celle émise parAccountPurger, commeaccount.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 EmpreinteemailHash).
É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¶
- Gérer les comptes utilisateurs : inviter, renvoyer et supprimer une invitation, désactiver, réactiver, supprimer, réintégrer et supprimer définitivement un compte depuis l'espace admin.
- Référence : bus d'événements des plugins : l'événement
UserPurgedet le contrat imposé aux plugins qui s'y abonnent. - Référence : contrat de plugin : la capability
PublicPresenceInventoryInterfacequi alimente l'inventaire de présence publique. - Couper l'accès d'un compte : pourquoi le
UserCheckerne suffit pas, et pourquoi le refus de connexion reste indiscernable d'un mauvais mot de passe. - Cycle de vie d'un compte : pourquoi un compte non actif disparaît du public mais reste visible de la modération, pourquoi la suppression est logique, pourquoi un compte réintégré revient désactivé, et pourquoi l'effacement définitif est un second geste.
- Créer un compte utilisateur en ligne de commande :
app:user:create. - Recevoir les e-mails en développement : le transport
asyncet Mailpit. security.yaml: firewalls etaccess_control.