MODULE 61 / 72
🔑
Scénario : reset de mot de passe oublié
Étape 1 — Demande : l'utilisateur saisit son email sur `/forgot-password`. Frontend envoie `POST /auth/forgot-password { email }`. Réponse : toujours `200 OK` avec un message neutre — peu importe si l'email existe ou non (anti-énumération).
Étape 2 — Génération du token : si l'utilisateur existe, on génère un token cryptographiquement sûr (32+ octets random). On le stocke en BDD hashé (pas en clair — si la BDD fuite, le token est utilisable) avec une expiration COURTE : 15 à 60 minutes max. Plus court qu'une inscription : on attend que l'utilisateur agisse tout de suite.
Étape 3 — Envoi async : push en queue du job 'send_password_reset'. Worker l'envoie via SendGrid/Postmark avec un lien du type `https://app.com/reset?token=xyz`. Réponse HTTP immédiate au frontend.
Étape 4 — Invalidation des anciens tokens : quand un nouveau token est généré, les anciens pour ce user sont supprimés ou invalidés. Sinon un utilisateur qui clique plusieurs fois 'J'ai oublié mon mot de passe' se retrouve avec 5 liens valides simultanément = risque.
Étape 5 — Clic sur le lien : l'utilisateur arrive sur une page de reset avec le token dans l'URL. Frontend affiche un formulaire 'Nouveau mot de passe' + confirmation. Important : le token ne doit PAS être loggé (URL dans les access logs = fuite).
Étape 6 — Soumission du nouveau mot de passe : `POST /auth/reset-password { token, new_password }`. Backend vérifie le token (hash comparaison, expiration), hashe le nouveau password, update en BDD, invalide le token, invalide toutes les sessions actives de cet utilisateur (sécurité : si le reset vient d'un compte compromis, on déconnecte le pirate).
Étape 7 — Notification : envoi d'un email de confirmation 'Votre mot de passe a été changé'. Si ce n'est pas vous, contactez-nous. C'est la dernière défense si quelqu'un a pris le contrôle — l'utilisateur légitime est alerté.
Rate limiting : on limite à 3-5 demandes par email et par IP par heure, sinon on devient un vecteur de spam pour les utilisateurs (ou de DDoS pour SendGrid).
⚡ ANALOGIE — LE DUPLICATA DE CLÉ À LA LOGE
Vous avez perdu vos clés. Vous allez à la loge — le gardien ne vous reconnaît pas, mais il connaît votre adresse (email). Il vous envoie un code à usage unique par courrier qui expire en 1h — vous devez agir vite. Vous venez avec ce code, il vous remet une nouvelle clé ET invalide toutes les autres copies en circulation. Il vous envoie un message de confirmation 'Clé remplacée aujourd'hui à 15h' — si c'était pas vous, appelez la police. Rate limiting = le gardien refuse d'envoyer plus de 3 codes par jour à la même adresse, sinon quelqu'un pourrait spammer vos voisins.
📐 SCHÉMA
Demande
POST /forgot-password {email}
Réponse neutre systématique
BDD
INSERT token (hashé, exp 30min)
Invalide anciens tokens
Queue
Push job 'send_reset_email'
Async
Worker
Envoie email avec lien
Via SendGrid/Postmark
Clic
GET /reset?token=...
Affiche formulaire
Reset
POST /reset-password
Hash + invalide sessions
Notification
Email de confirmation
Alerte si intrusion
💬 QUESTION INTERACTIVE
1/5
"Un utilisateur vous dit 'je viens de changer mon mot de passe mais je suis encore connecté sur mon ancien téléphone que j'ai perdu'. Que doit faire votre système ?"
🎯 PIÈGE / QUESTION D'ENTRETIEN
Pourquoi la durée de vie d'un token de reset de mot de passe est-elle bien plus courte que celle d'un token de confirmation d'email ?