Configuration security.yaml¶
Référence de la configuration de sécurité de Kirexo, telle que déclarée dans config/packages/security.yaml et config/routes.yaml. Pour le pourquoi de cette architecture (deux firewalls, masquage 404 de l'admin), voir Architecture des firewalls Kirexo.
Provider d'utilisateurs¶
Un unique provider Doctrine, partagé par les deux firewalls.
| Provider | Type | Classe | Propriété d'identification |
|---|---|---|---|
app_user_provider |
entity |
App\Entity\User |
email |
Firewalls¶
Déclarés dans l'ordre ci-dessous. Symfony retient le premier firewall dont le pattern correspond à l'URL ; un firewall sans pattern agit comme fallback.
| Firewall | pattern |
lazy |
provider |
Sécurisé |
|---|---|---|---|---|
dev |
^/(_(profiler\|wdt)\|css\|images\|js)/ |
— | — | non (security: false) |
public_site |
(aucun — request_matcher: App\Security\PublicSiteRequestMatcher) |
— | — | non (security: false) |
admin |
^/admin |
oui | app_user_provider |
oui |
user |
(aucun — fallback) | oui | app_user_provider |
oui |
Les firewalls admin et user déclarent en plus user_checker: App\Security\UserChecker (voir User checker).
public_site : isolation multi-tenant, par request_matcher et non par pattern
Sur un domaine de site public, aucune authentification n'a lieu : ni token de session applicative, ni cookie remember-me. Le firewall ne se sélectionne pas sur le chemin — les URL d'un site public sont quelconques — mais sur l'attribut de requête _kirexo_public_site, posé par HostResolutionSubscriber et lu par src/Security/PublicSiteRequestMatcher.php.
Sa position dans la liste est ce qui rend la règle sûre : le premier firewall qui matche gagne, et sur un domaine applicatif l'attribut est absent — public_site ne matche pas, admin et user sont inchangés. Contexte multi-tenant : Domaines de site.
Options form_login¶
Les firewalls admin et user utilisent l'authentification par formulaire native de Symfony (form_login). Chaque firewall déclare en plus un authenticator custom SwitchSpaceAuthenticator (voir Authenticators custom ci-dessous). La soumission du formulaire — le Live Component email-first, src/Twig/Components/EmailFirstLogin.php — cible le check_path de chaque firewall.
| Option | Firewall admin |
Firewall user |
|---|---|---|
login_path |
app_admin_login |
app_login |
check_path |
app_admin_login_check |
app_login_check |
default_target_path |
app_admin_dashboard |
app_user_home |
username_parameter |
email |
email |
password_parameter |
password |
password |
enable_csrf |
true |
true |
Après une connexion réussie, chaque firewall redirige vers l'accueil de son espace : /admin (app_admin_dashboard) pour l'admin, /u (app_user_home) pour l'utilisateur. Ces deux pages sont décrites dans la Référence des espaces utilisateur et admin.
username_parameter est fixé à email (et non _username) car l'identification se fait sur l'email, cohérent avec la propriété du provider Doctrine.
Options logout¶
| Option | Firewall admin |
Firewall user |
Rôle |
|---|---|---|---|
path |
app_admin_logout |
app_logout |
Route interceptée par le firewall pour déclencher la déconnexion. |
target |
app_home |
app_home |
Route de redirection après déconnexion. |
clear_site_data |
['cookies'] |
['cookies'] |
Émet l'en-tête HTTP Clear-Site-Data: "cookies" à la déconnexion, demandant au navigateur de purger les cookies du site. |
clear_site_data : défense en profondeur de la déconnexion globale
clear_site_data: ['cookies'] complète l'effacement ciblé des cookies remember-me réalisé côté serveur par src/Security/EventSubscriber/ClearRememberMeCookiesSubscriber.php. Ce subscriber, branché sur les dispatchers des deux firewalls, efface REMEMBERME_USER et REMEMBERME_ADMIN à chaque LogoutEvent, pour qu'une déconnexion depuis un espace déconnecte aussi l'autre. Le raisonnement complet (bug #69, contextes de sécurité désynchronisés) est détaillé dans Déconnexion cohérente. En HTTP local/test (cookies non secure), Clear-Site-Data reste inoffensif ; la garantie testable côté serveur est l'effacement du subscriber.
Authenticators custom¶
Les deux firewalls déclarent un custom_authenticator App\Security\Authenticator\SwitchSpaceAuthenticator qui authentifie les arrivées depuis l'autre espace via un jeton de bascule signé à usage unique (?_switch_token). Voir Mécanisme de bascule entre espaces.
User checker¶
| Option | Firewall admin |
Firewall user |
|---|---|---|
user_checker |
App\Security\UserChecker |
App\Security\UserChecker |
src/Security/UserChecker.php implémente UserCheckerInterface :
| Méthode | Comportement |
|---|---|
checkPreAuth() |
Si l'utilisateur est un App\Entity\User et que isActive() est faux (compte désactivé ou supprimé), lève une DisabledException (message interne « Compte inactif. »). Sinon, ne fait rien. |
checkPostAuth() |
Ne fait rien. |
checkPreAuth() est appelé pour les trois chemins d'authentification des deux firewalls : form_login, remember_me et SwitchSpaceAuthenticator. Il s'exécute avant la vérification du mot de passe.
DisabledException n'est pas une exception à message personnalisé : l'AuthenticatorManager la remplace par une BadCredentialsException. La page de connexion affiche donc le même message qu'un mauvais mot de passe. Cela suppose expose_security_errors à sa valeur par défaut none (l'option n'est pas déclarée dans security.yaml). Raisonnement : Couper l'accès d'un compte.
Remember-me (« Se souvenir de moi »)¶
Chaque firewall (admin et user) active le remember_me natif de Symfony. Quand la case « Se souvenir de moi » du formulaire est cochée (paramètre _remember_me), un cookie persistant maintient la session après la fermeture du navigateur. Pour le parcours utilisateur, voir Rester connecté avec « Se souvenir de moi ».
| Option | Firewall admin |
Firewall user |
Rôle |
|---|---|---|---|
secret |
%kernel.secret% |
%kernel.secret% |
Clé de signature du cookie (dérivée d'APP_SECRET). |
lifetime |
2592000 (30 j) |
2592000 (30 j) |
Durée de vie du cookie, en secondes. |
name |
REMEMBERME_ADMIN |
REMEMBERME_USER |
Nom du cookie — distinct par espace. |
path |
/ |
/ |
Portée du cookie. |
secure |
%env(bool:REMEMBER_ME_SECURE)% |
%env(bool:REMEMBER_ME_SECURE)% |
Cookie transmis sur HTTPS uniquement quand true (cf. REMEMBER_ME_SECURE). |
httponly |
true |
true |
Cookie inaccessible au JavaScript. |
samesite |
lax |
lax |
Non envoyé sur les requêtes cross-site, hors navigation top-level. |
always_remember_me |
false |
false |
Opt-in : le cookie n'est posé que si la case est cochée. |
signature_properties |
['password', 'disabledAt', 'deletedAt'] |
['password', 'disabledAt', 'deletedAt'] |
Le hash du mot de passe et l'état du compte entrent dans la signature du cookie. |
signature_properties — invalidation au reset et à la désactivation
Les valeurs de ces propriétés de App\Entity\User entrent dans la signature du cookie. Un changement de l'une d'elles invalide automatiquement tous les cookies « se souvenir de moi » émis avant, sur tous les appareils, sans liste de cookies à révoquer côté serveur :
password: toute modification du mot de passe (réinitialisation, cf. Réinitialiser son mot de passe) change le hash ;disabledAt: la désactivation d'un compte pose une date (cf. Gérer les comptes utilisateurs) ;deletedAt: la suppression logique d'un compte pose une date.
Déploiement : tous les cookies existants invalidés une fois
Ajouter disabledAt et deletedAt à signature_properties a changé la formule de signature. Les cookies « se souvenir de moi » émis avant le déploiement de ce changement ne sont plus valides : chaque personne concernée doit se reconnecter une fois avec son mot de passe. Le même effet se reproduit à chaque modification future de la liste.
Limite : la réactivation rend sa validité à un cookie ancien
La signature ne dépend que des valeurs courantes. Remettre disabledAt à null (réactivation) redonne donc la même signature qu'avant la désactivation : un cookie émis avant la désactivation et jamais présenté pendant redevient valide. Un cookie présenté pendant la désactivation est, lui, effacé du navigateur à ce moment-là.
Rate limiter (login throttling)¶
Chaque firewall active login_throttling : après trop de tentatives de connexion échouées sur un même couple (IP + identifiant), l'accès est temporairement bloqué. Une connexion réussie remet le compteur à zéro. Pour le pourquoi (brute-force, credential stuffing, admin plus strict), voir Pourquoi limiter les tentatives de connexion.
| Option | Firewall admin |
Firewall user |
|---|---|---|
max_attempts |
3 |
5 |
interval |
15 minutes |
15 minutes |
Symfony génère à partir de cette configuration le rate limiter interne security.login_throttling, indexé par IP + identifiant.
Limiteurs nommés exposés en parallèle
config/packages/rate_limiter.yaml déclare en plus deux limiteurs nommés login_user_throttle (limit 5) et login_admin_throttle (limit 3), en policy sliding_window sur le pool cache.app. Le rate limiting effectif des logins reste celui généré par login_throttling ci-dessus ; ces définitions nommées existent pour qu'un service ou un composant UX puisse consulter le compteur (ex. afficher les essais restants) sans réimplémenter le décompte.
Routes de sécurité¶
Déclarées dans config/routes.yaml, sauf les deux routes de login GET qui sont déclarées en attribut #[Route] sur leur controller (chargées via le resource ../src/Controller/).
| Route | Chemin | Controller | Méthode |
|---|---|---|---|
app_login |
/login |
src/Controller/AppLoginController.php |
GET |
app_admin_login |
/admin/login |
src/Controller/AppAdminLoginController.php |
GET |
app_login_check |
/login_check |
(aucun) | — |
app_admin_login_check |
/admin/login_check |
(aucun) | — |
app_logout |
/logout |
(aucun) | — |
app_admin_logout |
/admin/logout |
(aucun) | — |
Routes sans controller
app_login_check, app_admin_login_check, app_logout et app_admin_logout n'ont aucune action de controller. Elles existent uniquement pour être référencées par form_login (check_path) et logout (path) ; le firewall les intercepte avant qu'un controller ne soit atteint. Déclarer ces routes en YAML sans controller est la convention Symfony pour ce cas.
access_control¶
Règles évaluées dans l'ordre ; Symfony applique la première dont le path correspond.
| Ordre | path |
roles |
|---|---|---|
| 1 | ^/admin/login |
PUBLIC_ACCESS |
| 2 | ^/admin |
ROLE_ADMIN |
| 3 | ^/switch |
IS_AUTHENTICATED_FULLY |
| 4 | ^/u |
ROLE_USER |
| 5 | ^/login |
PUBLIC_ACCESS |
^/switch exige IS_AUTHENTICATED_FULLY et non un rôle : il couvre l'émission du jeton de bascule vers l'admin (app_switch_to_admin, POST /switch, src/Controller/AppSwitchToAdminController.php), réservée à une session authentifiée par mot de passe — un utilisateur revenu par un cookie remember-me n'est pas FULLY et ne peut donc pas en émettre. Le sens inverse (app_switch_to_user, POST /admin/switch) est couvert par la règle ^/admin. Cf. Mécanisme de bascule entre espaces.
L'ordre des deux premières règles est critique : ^/admin/login (public) doit précéder ^/admin (ROLE_ADMIN), sinon la page de login admin exigerait d'être déjà admin pour s'afficher. Détails dans l'explication associée.
access_control ne masque pas l'admin
access_control gère l'autorisation (un rôle a-t-il le droit ?), pas le masquage (l'admin avoue-t-il son existence ?). Le 404 servi aux visiteurs de l'espace user sur ^/admin est porté par src/EventSubscriber/AdminAreaAccessSubscriber.php, indépendamment de access_control. Voir Masquer l'admin : 404 plutôt que 403.
Surcharge when@test¶
En environnement de test, security.yaml affaiblit volontairement le hashage des mots de passe pour accélérer la suite de tests :
| Paramètre | Valeur test |
|---|---|
algorithm |
auto |
cost |
4 |
time_cost |
3 |
memory_cost |
10 |
Ces valeurs n'ont aucun effet en dev ni en prod, où le hashage reste sur auto.