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

  1. À la première connexion (ou si la 2FA est obligatoire), l’utilisateur est redirigé vers /cms-admin/2fa/devices/new.

  2. Il scanne le QR code avec une application compatible (Google Authenticator, Aegis, Authy, 1Password…).

  3. Il saisit un code de vérification pour confirmer la configuration.

  4. 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",
    ...
]