Entête partagé : identité, déconnexion et bascule¶
Cette page explique pourquoi Kirexo affiche un même entête en haut de la page d'accueil publique et des deux espaces (utilisateur et admin), ce qu'il montre selon l'état de connexion et le type de compte, et pourquoi la présence du bouton de bascule n'est qu'une commodité d'affichage — l'autorisation réelle restant portée par le Voter CanSwitchSpaceVoter. Pour le parcours pas-à-pas de la bascule côté utilisateur, voir le how-to Basculer entre l'espace administrateur et l'espace utilisateur.
Un entête, trois contextes¶
Le même entête coiffe trois contextes qui n'ont pourtant rien de commun :
- la page d'accueil publique, accessible à tout le monde (anonyme ou connecté) ;
- l'espace utilisateur (
/u), réservé aux comptes authentifiés sur le firewalluser; - l'espace d'administration (
/admin), réservé aux comptes authentifiés sur le firewalladmin.
Plutôt que de dupliquer trois barres de navigation, Kirexo factorise cet entête dans un unique composant Twig : src/Twig/Components/Header.php et son gabarit templates/components/Header.html.twig. Il est intégré via une seule balise, <twig:Header space="…" />, dans les deux layouts d'espace (templates/base_user.html.twig, templates/base_admin.html.twig) comme dans les pages qui n'en dépendent pas : l'accueil (templates/home/index.html.twig), les deux pages de connexion posées en plein écran et l'écran de réinitialisation de mot de passe. La valeur de space y suit l'espace visé, pas l'état d'authentification : /admin/login rend son entête en space="admin" bien qu'aucune session n'existe encore, ce qui lui donne sa pastille « Admin » dès le seuil. Sur un écran anonyme, l'entête se réduit au sélecteur de thème — plus, sur le seul accueil public, au lien « Se connecter ».
Le composant ne porte aucun état serveur interactif : il n'affiche que des liens et des formulaires POST. C'est donc un composant Twig simple, pas un Live Component — conformément à la règle « pas de Live Component si un composant statique suffit ». L'ouverture du menu de compte est un disclosure piloté côté navigateur (un bouton aria-expanded qui montre une région de liens) : aucun aller-retour serveur, donc rien qui justifierait un Live Component. Ce n'est délibérément pas un role="menu", dont la sémantique ARIA imposerait une navigation au clavier que le contenu — des liens et des formulaires — ne suit pas.
La prop space pilote tout l'affichage¶
Le composant reçoit une unique propriété, space, qui vaut public, user ou admin selon le layout qui l'instancie. Cette valeur détermine :
- la cible de la brand — l'accueil de l'espace courant (
app_user_home,app_admin_dashboard) ou l'accueil public (app_home) ; - le marquage de l'espace d'administration — une pastille « Admin » à côté du mot « Kirexo », et non un suffixe textuel ;
- la route de déconnexion ciblée (
app_admin_logoutdans l'espace admin,app_logoutailleurs) ; - le sens de la bascule pour un compte mixte (vers l'admin depuis
/u, vers l'utilisateur depuis/admin) ; - les entrées propres à un espace — « Plugins » côté utilisateur, « Plugins » et « Réglages » côté admin ;
- l'affichage, ou non, du lien « Se connecter » (réservé à l'accueil public anonyme).
space est une donnée d'affichage choisie par le layout, jamais une donnée de sécurité : ce n'est pas elle qui protège les espaces. Le cloisonnement réel reste assuré par les deux firewalls et access_control (voir Architecture des firewalls).
Le nom affiché est le prénom, jamais l'email¶
Le bouton qui ouvre le menu porte le prénom du compte (getDisplayName()), pas son adresse. Ce n'est pas cosmétique : l'entête est visible sur l'accueil public, donc potentiellement par-dessus l'épaule de n'importe qui, et une adresse email affichée en permanence est à la fois une donnée personnelle exposée et une cible d'énumération offerte gratuitement. Le prénom identifie suffisamment la session pour l'usage recherché — savoir qui est connecté.
Ce qui s'affiche selon l'état¶
L'entête combine deux dimensions : suis-je connecté ? et, si oui, mon compte est-il mixte ?. Le tableau résume les cas.
| Contexte | État du compte | Entête affiché |
|---|---|---|
Accueil public (space="public") |
Anonyme | Brand + sélecteur de thème + lien « Se connecter » (vers app_login) |
Accueil public (space="public") |
Connecté | Brand + bouton « Mon espace » + menu du compte (thème, « Se déconnecter »). Pas de bascule |
Espace user (space="user") |
Connecté, non mixte | Brand + menu : thème, « Plugins » (+ entrées contribuées par les plugins actifs), « Se déconnecter » |
Espace user (space="user") |
Connecté, mixte | Idem, plus « Espace admin » (formulaire de bascule) |
Espace admin (space="admin") |
Connecté, non mixte | Brand + pastille « Admin » + menu : thème, « Plugins », « Réglages », « Se déconnecter » |
Espace admin (space="admin") |
Connecté, mixte | Idem, plus « Espace user » (formulaire de bascule) |
Le sélecteur de thème est le seul élément présent dans tous les cas — dans le menu quand un compte est connecté, à plat dans l'entête sinon : c'est une préférence de visiteur, elle n'a pas à dépendre d'une session (voir Pourquoi un accent d'instance piloté serveur).
Quelques points méritent d'être soulignés.
L'accueil public ne propose jamais le login admin¶
Sur la page d'accueil, un visiteur anonyme ne voit qu'un seul lien de connexion : « Se connecter », qui mène vers la page de login utilisateur (app_login). L'entête ne propose jamais de lien vers /admin/login. C'est cohérent avec le masquage 404 de l'admin : l'espace d'administration ne s'annonce pas aux visiteurs publics. Un administrateur connaît son URL de login ; elle n'a pas à être exposée depuis l'accueil.
Sur l'accueil, un compte connecté ne voit pas la bascule¶
Si un compte est connecté lorsqu'il consulte l'accueil public, son menu ne propose pas la bascule d'espace : getSwitchTarget() rend null dès que space vaut public, même pour un compte mixte. La raison tient à ce qu'est la bascule — une transition depuis un espace vers l'autre. Depuis l'accueil, qui n'appartient à aucun firewall d'espace, il n'existe pas d'espace de départ : proposer « Espace admin » y reviendrait à inventer une origine.
L'accueil offre en revanche un raccourci que les autres contextes n'ont pas : le bouton « Mon espace », hors menu. Il n'est rendu que là — dans l'espace utilisateur on y est déjà, et dans l'espace admin c'est la bascule qui joue ce rôle.
La déconnexion suit le firewall de l'espace¶
Chaque espace possède sa propre session de firewall. L'entête cible donc la bonne route de logout selon space : app_admin_logout quand space="admin", app_logout sinon. Se déconnecter de l'espace admin ne déconnecte pas une éventuelle session utilisateur, et inversement — c'est une conséquence directe de la séparation en deux firewalls.
Le bouton de bascule n'apparaît que pour les comptes mixtes¶
Le bouton de bascule — libellé « Espace admin » ou « Espace user » selon la cible — n'est rendu que si le compte est mixte, c'est-à-dire porteur à la fois de ROLE_USER et ROLE_ADMIN. Pour un compte qui n'a qu'un seul de ces rôles, basculer n'aurait pas de cible légitime : le bouton est donc absent. Le sens de la bascule découle de space : depuis user, on bascule vers admin ; depuis admin, vers user ; depuis public, jamais (l'accueil n'est pas un espace de départ).
La visibilité du bouton est une commodité, pas une autorisation¶
C'est le point conceptuel important de cette page.
Le composant expose une méthode getSwitchTarget() qui renvoie l'espace de destination ('admin', 'user') ou null. Le gabarit n'affiche le formulaire de bascule que lorsque cette méthode renvoie une cible. Cette méthode décide en lisant les rôles du compte courant (isMixed()) et l'espace courant.
Cette logique d'affichage ne fait pas autorité. Elle sert uniquement à éviter de présenter un bouton qui mènerait à un échec — une question d'ergonomie, pas de sécurité. L'autorisation réelle de basculer est portée ailleurs, en un seul endroit faisant foi : le Voter src/Security/Voter/CanSwitchSpaceVoter.php, qui n'accorde l'attribut CAN_SWITCH_SPACE qu'aux comptes mixtes. Ce Voter garde les deux controllers de bascule via #[IsGranted(CanSwitchSpaceVoter::CAN_SWITCH_SPACE)] (src/Controller/AppSwitchToAdminController.php et src/Controller/AppSwitchToUserController.php).
Autrement dit, même si l'entête affichait le bouton à tort, ou si un compte forgeait manuellement un POST vers /switch ou /admin/switch, la requête serait rejetée par le Voter avant toute génération de jeton. Le formulaire de bascule porte d'ailleurs son propre jeton CSRF (switch_space), et le mécanisme complet — jeton signé à usage unique, vérification de rôle à la consommation — est détaillé dans Mécanisme de bascule entre espaces.
Pourquoi dédoubler le contrôle (affichage + Voter) ?
La condition d'affichage de l'entête (isMixed()) et le Voter CanSwitchSpaceVoter répondent à la même question — « ce compte peut-il basculer ? » — mais ne jouent pas le même rôle. Le composant améliore l'expérience (ne pas montrer un bouton qui échouerait) ; le Voter assure la sécurité (refuser toute bascule illégitime, quel que soit l'affichage). Si les deux divergeaient, c'est toujours le Voter qui tranche : il est le seul à faire autorité. C'est une application directe de la règle du projet « aucune décision d'autorisation inline » — la décision vit dans un Voter, pas dans un gabarit.
Voir aussi¶
- Mécanisme de bascule entre espaces — le jeton signé à usage unique derrière le bouton de bascule, et le Voter
CanSwitchSpaceVoter. - Architecture des firewalls — la séparation en deux firewalls, les deux sessions de logout, et le masquage 404 de l'admin.
- Espaces utilisateur et admin — les deux dashboards qui portent cet entête.
- Se connecter à Kirexo — le parcours d'authentification déclenché par le lien « Se connecter ».
- Basculer entre l'espace administrateur et l'espace utilisateur — le guide pratique côté utilisateur.