Préparation du module de sécurité (7 niveaux) — LIVRÉ
Statut : septembre 2026 — module implémenté et commercialisable.
Add-onenhanced_securityviaShopAddonService. Voirdocs/PLAN_PHASES_RESTANTES.mdetdocs/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_logspar boutique.
3.4 Feature flag « Module sécurité »
- Add-on
enhanced_securitydansShopAddonService. - 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_atvia 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 |