MODULE 60 / 72
✉️
Scénario : inscription avec email de confirmation
Étape 1 — Soumission : `POST /auth/register { email, password, name }`. Validation : email au bon format, password assez fort (longueur, variété), email pas déjà utilisé.
Étape 2 — Création de l'utilisateur : hash du password avec bcrypt/argon2 (coût : 100-300 ms — c'est volontaire, pour rendre le brute-force coûteux). INSERT en BDD avec `email_verified: false`. L'utilisateur existe mais ne peut pas se connecter tant que l'email n'est pas validé. Attention : certains antivirus ouvrent les liens en GET — préférez une confirmation par POST (bouton) ou un token valable jusqu'à expiration.
Étape 3 — Génération du token de confirmation : un token aléatoire cryptographiquement sûr (32+ octets, généré par `crypto.randomBytes`). Stocké en BDD (hashé, comme un mot de passe) avec une expiration (24-48h typiquement).
Étape 4 — Envoi asynchrone : on NE bloque PAS la requête HTTP pendant l'envoi d'email (sinon latence horrible). On pousse un job dans une queue : `{ type: 'send_confirmation_email', user_id: 123, token: 'xyz' }`. Le backend répond immédiatement `201 Created`.
Étape 5 — Worker email : un process séparé consomme la queue. Il récupère le job, compose l'email via un template (MJML, React Email, Handlebars), l'envoie via un service transactionnel (Postmark, SendGrid, Resend, AWS SES). En cas d'échec : retry automatique avec backoff (3 tentatives espacées).
Étape 6 — L'utilisateur clique sur le lien : `GET /verify?token=xyz`. Le backend cherche le token, vérifie qu'il n'a pas expiré, marque `email_verified: true`, supprime ou invalide le token. Redirection vers la page de login. Attention : certains antivirus ouvrent les liens en GET — préférez une confirmation par POST (bouton) ou un token valable jusqu'à expiration.
Les pièges classiques : (1) Envoyer l'email SYNCHRONE dans la requête → utilisateur qui attend 3s. (2) Ne pas limiter les renvois → spam massif. (3) Token non-expiré → risque de fuite. (4) Révéler dans la réponse d'erreur si un email est déjà utilisé → permet l'énumération de comptes (problème de vie privée).
⚡ ANALOGIE — LA DEMANDE D'ABONNEMENT À UN MAGAZINE
Vous remplissez le bulletin (inscription). Le magazine crée votre dossier mais ne vous envoie rien encore. Ils vous postent un courrier avec un code unique (email de confirmation). Tant que vous ne leur renvoyez pas ce code, votre abonnement reste inactif. Le code expire après 2 semaines — si vous oubliez, il faut recommencer. Le postier (worker email) livre les courriers, pas le magazine lui-même — le magazine continue son travail pendant ce temps.
📐 SCHÉMA
Inscription
POST /auth/register
Validation + hash bcrypt
BDD
INSERT user (verified: false)
+ token hashé + expiration
Queue
Push job 'send_email'
Redis / RabbitMQ / SQS
Réponse
201 Created
Immédiate, sans attendre l'email
Worker
Consume job → SendGrid
Async, retry si échec
Email reçu
User clique le lien
GET /verify?token=...
Vérif
UPDATE verified: true
Token invalidé
💬 QUESTION INTERACTIVE
1/5
"Votre service email (SendGrid) tombe pendant 2 heures. Que se passe-t-il pour les utilisateurs qui s'inscrivent pendant cette panne ?"
🎯 PIÈGE / QUESTION D'ENTRETIEN
Pourquoi ne JAMAIS répondre 'Cet email est déjà utilisé' lors de l'inscription ?