Module sécurité renforcée

Lien isolé Accueil docs Formation
Modules métier

2FA TOTP, verrouillage compte, historique connexions, whitelist IP.

Préparation du module de sécurité (7 niveaux) — LIVRÉ

Statut : septembre 2026 — module implémenté et commercialisable.
Add-on enhanced_security via ShopAddonService. Voir docs/PLAN_PHASES_RESTANTES.md et docs/AGENT_IA_SUPPORT_CLIENT.md.

Ce document préparait le développement du module de sécurité supplémentaire (option payante). Il est conservé comme référence historique.


Checklist de livraison (cochée)

# Fonctionnalité Statut
1 2FA TOTP (web + mobile otp_code) ✅
2 Verrouillage compte (3 tentatives, déblocage admin + e-mail) ✅
3 Expiration MDP 90 j + écran obligatoire ✅
4 MDP compromis (Password::uncompromised()) ✅
5 Journalisation connexions (login_logs) ✅
6 Alerte HTTPS dans paramètres ✅
7 Sessions strictes + « Déconnecter partout » ✅
— Déblocage par email (lien signé 24 h) ✅

Implémentation : AccountSecurityService, PasswordPolicyService, AccountUnlockController, app/Support/Totp.php, migrations 2026_09_04_17*.


1. Rappel des 7 niveaux à livrer

# Fonctionnalité Livrable principal
1 Authentification à deux facteurs (2FA) TOTP, écran activation, vérification au login
2 Verrouillage de compte Compteur échecs, déblocage admin + email
3 Expiration des mots de passe password_changed_at, politique 90 j, écran changement obligatoire
4 Mot de passe compromis (Have I Been Pwned) Règle Password::uncompromised(), messages FR
5 Journalisation des connexions Table + écriture, page « Historique des connexions »
6 HTTPS et cookie secure Config + message dans paramètres si pas HTTPS
7 Session stricte Déconnexion autres appareils au changement MDP + « Se déconnecter partout »

2. État actuel à conserver (déjà en place)

  • Rate limiting : 5 tentatives / 15 min par IP sur le login (throttle:login).
  • Règles MDP : 8 caractères, 1 lettre, 1 chiffre (centralisé dans AppServiceProvider).
  • Import v1 : mots de passe sécurisés (bcrypt ou hash aléatoire + « Mot de passe oublié »).
  • Session : régénération après login, déconnexion propre.
  • CSRF : protection sur tous les formulaires.

Référence : docs/SECURITE_MOTS_DE_PASSE.md.


3. Prérequis techniques avant de démarrer

3.1 Environnement

  • Laravel à jour (compatible PHP 8.1+).
  • Base de données migrable (MySQL/MariaDB ou PostgreSQL).
  • TOTP natif (app/Support/Totp.php) — pas de paquet Composer externe.

3.2 Paquets à prévoir

  • 2FA (TOTP) : implémenté nativement (Totp.php).
  • Have I Been Pwned : Password::uncompromised() si module actif.

3.3 Modèle User et boutique

  • Colonnes 2FA, verrouillage, password_changed_at, sessions_invalidated_at.
  • Feature flags security.core, security.2fa, security.login_logs par boutique.

3.4 Feature flag « Module sécurité »

  • Add-on enhanced_security dans ShopAddonService.
  • Middleware EnsureAccountSecurity, gates permissions.

4. Ordre recommandé des développements

(Ordre historique — tous les niveaux 1 à 7 + déblocage e-mail sont livrés.)


5. Points d’attention

  • 2FA : déblocage par admin (UserController::unlock) ou lien e-mail signé (AccountUnlockController) ; codes de secours = phase ultérieure.
  • Verrouillage : rate limit IP (existant) + verrouillage compte (livré).
  • Journalisation : pas de MDP en clair ; rétention à définir côté ops.
  • Expiration MDP : backfill password_changed_at via migration.

6. Checklist lancement semaine prochaine

  • Module sécurité activable par boutique (add-on).
  • Tests feature AccountSecurityTest.
  • Documentation agent IA + page APK /telechargement-apk.

7. Fichiers à consulter au démarrage

Fichier Rôle
app/Services/AccountSecurityService.php Cœur module sécurité
app/Services/PasswordPolicyService.php Politique MDP boutique
app/Http/Controllers/Auth/LoginController.php Login web + 2FA challenge
app/Http/Controllers/Api/Mobile/AuthController.php Login mobile + otp_code
app/Models/User.php Colonnes sécurité
config/security.php Tentatives, expiration, TOTP
docs/AGENT_IA_SUPPORT_CLIENT.md Support client / commercial