Authentification à deux facteurs (2FA)¶
Contexte¶
L’ANSSI recommande la mise en place d’une authentification à deux facteurs (2FA) pour sécuriser l’accès des comptes privilégiés (en l’occurrence, l’accès à l’interface d’administration Wagtail)
Sites Conformes intègre wagtail-2fa pour mettre en place un système de mot de passe à usage unique basé sur le temps (Time based One Time Password ou TOTP.) Cette méthode de 2FA repose sur une application tierce installée sur le téléphone de l’utilisateur, qui génère un code à 6 chiffres renouvelé toutes les 30 secondes. Lors de la connexion, ce code est exigé en complément du mot de passe.
Activation¶
Par défaut, la 2FA est optionnelle sur Sites Conformes : les utilisateurs peuvent la configurer, mais elle n’est pas obligatoire. Pour la rendre obligatoire pour tous les accès à l’interface d’administration :
WAGTAIL_2FA_REQUIRED=True
Avec cette option, tout utilisateur authentifié sans appareil 2FA configuré est automatiquement redirigé vers la page de configuration avant de pouvoir accéder à l’interface d’administration.
Fonctionnement¶
Pour l’utilisateur¶
À la première connexion (ou si la 2FA est obligatoire), l’utilisateur est redirigé vers
/cms-admin/2fa/devices/new.Il scanne le QR code avec une application compatible (Google Authenticator, Aegis, Authy, 1Password…).
Il saisit un code de vérification pour confirmer la configuration.
Lors des connexions suivantes, un écran intermédiaire lui demande son code à 6 chiffres.
Confirmation par code envoyé par e-mail¶
Pour ajouter ou modifier un appareil, wagtail-2fa demande normalement le mot
de passe actuel de l’utilisateur. Ce n’est pas possible après une connexion
via ProConnect : le compte peut ne pas avoir de mot de passe (comptes créés
lors d’une connexion ProConnect), ou la connexion par mot de passe peut être
désactivée (SF_DISABLE_LOCAL_LOGIN).
Quand la session a été ouverte via ProConnect, le champ « Mot de passe actuel » est donc remplacé par un code de confirmation, envoyé à l’adresse e-mail du compte via le bouton « Recevoir un code » placé à côté du champ. Après une connexion par mot de passe, c’est toujours le mot de passe qui est demandé. Ce code :
comporte 6 chiffres et reste valable 15 minutes, durée réglable avec
SF_2FA_EMAIL_CODE_VALIDITY_DURATION(le temps d’installer l’application d’authentification et de scanner le QR code) ;ne peut servir qu’une fois et est refusé après 3 essais erronés, nombre réglable avec
SF_2FA_EMAIL_CODE_MAX_ATTEMPTS;ne peut être redemandé qu’après un délai d’une minute.
Avertissement
Ce code nécessite l’envoi d’e-mails (DEFAULT_FROM_EMAIL renseigné, voir
Référence des variables d’environnement) et une adresse e-mail sur le
compte. Sinon, l’ajout d’un appareil est bloqué et un message invite à
contacter l’administrateur du site : il serait sinon possible sans aucune
confirmation.
Avec WAGTAIL_2FA_REQUIRED=True, un utilisateur sans appareil reste alors
bloqué sur la page de configuration. Configurez l’envoi d’e-mails avant
d’activer SF_DISABLE_LOCAL_LOGIN avec une 2FA obligatoire.
Accéder à la gestion des appareils 2FA¶
Le lien vers la page de gestion des appareils 2FA est accessible depuis :
Liste des utilisateurs :
/cms-admin/users/→ bouton “Gérer 2FA” sur chaque ligne (réservé aux administrateurs)Page de compte : cliquer sur son avatar/nom en bas à gauche → “Paramètres du compte” → onglet “Plus d’actions” (onglet visible uniquement si des actions sont disponibles) → “Manage your 2FA devices”
Middleware et fichiers statiques¶
Lorsque WAGTAIL_2FA_REQUIRED=True, le middleware VerifyUserMiddleware
intercepte toutes les requêtes entrantes pour les utilisateurs non vérifiés.
Cela inclut les requêtes vers les fichiers statiques (CSS, JS),
ce qui empêche le navigateur de les charger.
Sites Conformes fournit une sous-classe du middleware qui exclut les URLs statiques et médias de cette vérification.
Elle remplace wagtail_2fa.middleware.VerifyUserMiddleware dans MIDDLEWARE :
# config/settings.py
MIDDLEWARE = [
...
"sites_conformes.dashboard.middleware.VerifyUserStaticFilesMiddleware",
...
]