đ Apprenez l'authentification en la construisant correctement. Une implĂ©mentation de rĂ©fĂ©rence extensible et conforme aux normes pour Cloudflare Workers avec Hono, Turso, PBKDF2 et sessions Ă double jeton JWT.
Apprenez l'authentification en la construisant correctement.
DĂ©mo en direct · ModĂšle de menace · Flux dâauthentification · ADR
Note de dĂ©mo : Lâendpoint de connexion est protĂ©gĂ© par des dĂ©fis PoW adaptatifs â les Ă©checs rĂ©pĂ©tĂ©s augmentent la difficultĂ© de la preuve de travail. Un limiteur de dĂ©bit basĂ© sur le cache est implĂ©mentĂ© et testĂ© mais nâest pas activĂ© sur la dĂ©mo en direct ; activez
createCacheClientdansapp.tspour lâactiver.
Une implĂ©mentation de rĂ©fĂ©rence dâauthentification construite de zĂ©ro pour Cloudflare Workers â hachage de mot de passe PBKDF2, sessions Ă double jeton JWT, comparaison en temps constant, expiration glissante et un plugin dâobservabilitĂ© amovible â le tout assemblĂ© avec Hono, Turso (avec mise en cache optionnelle Valkey/Redis) et TypeScript strict.
Chaque choix de conception remonte à une norme : NIST SP 800-63B pour les identifiants, NIST SP 800-132 pour la dérivation de clés, OWASP ASVS pour la vérification, et RFC 8725 pour les bonnes pratiques JWT.
Vous livrez un produit ? Utilisez Better Auth Ă la place â il couvre OAuth, les clĂ©s dâaccĂšs, lâauthentification multifacteur, la limitation de dĂ©bit et bien plus encore prĂȘts Ă lâemploi avec un Ă©cosystĂšme de plugins actif. Ce dĂ©pĂŽt existe pour vous apprendre comment fonctionne lâauthentification, pas pour remplacer une bibliothĂšque de production.
| Couche | Ce quâelle fait |
|---|---|
| Stockage des mots de passe | PBKDF2-SHA384 avec sels de 128 bits, condensĂ© dâintĂ©gritĂ©, suivi de version (password-service.ts) |
| Gestion des sessions | Sessions cĂŽtĂ© serveur avec suivi dâappareil, expiration glissante, limite de 3 par utilisateur ; sessions optionnelles avec cache via Valkey/Redis (session-service.ts, cached-session-service.ts) |
| Changement de mot de passe | Re-vérification du mot de passe actuel, re-hachage PBKDF2 complet, révocation atomique de toutes les sessions (account-service.ts, ADR-004) |
| SchĂ©ma Ă double jeton JWT | Jeton dâaccĂšs de 15 min + jeton de rafraĂźchissement de 7 jours, liĂ©s Ă la session pour la rĂ©vocation (token-service.ts) |
| Middleware dâauthentification | Flux de rafraĂźchissement automatique, Ă©pinglage explicite HS256, validation de la revendication typ (require-auth.ts) |
| Cookies sécurisés | HttpOnly, Secure, SameSite=Strict, Path=/ (cookie.ts) |
| En-tĂȘtes de sĂ©curitĂ© | HSTS, CSP, CORP/COEP/COOP, Permissions-Policy, suppression des empreintes (security.ts) |
| Validation des entrées | Schémas Zod avec politique de mot de passe conforme NIST (longueur uniquement, pas de rÚgles de complexité) |
| Limitation de dĂ©bit | Limitation Ă fenĂȘtre fixe contre les attaques par force brute et par bourrage dâidentifiants : IP sur les routes dâauthentification publiques (ex. connexion), utilisateur sur les actions protĂ©gĂ©es ; pas de verrouillage dĂ©finitif (conforme NIST) (ADR-006) |
| Plugin dâobservabilitĂ© | ĂvĂ©nements de sĂ©curitĂ© structurĂ©s, dĂ©fis PoW adaptatifs, API /ops authentifiĂ©e par agent â se branche via middleware, amovible en supprimant un paquet (ADR-008) |
| Outillage CLI | TUI Go (plctl) pour interroger les Ă©vĂ©nements, gĂ©rer les sessions et provisionner les identifiants dâagent via lâinterface /ops (tools/cli/) |
| Tests de vecteurs dâattaque | AltĂ©ration JWT, confusion dâalgorithme, confusion de type, cas limites Unicode, vĂ©rifications de divulgation dâinformations |
Ce projet omet intentionnellement des fonctionnalitĂ©s qui sortent de son cadre pĂ©dagogique. Si vous Ă©tendez ce code vers la production (ou Ă©valuez ce quâun systĂšme dâauthentification de production nĂ©cessite), les tableaux ci-dessous organisent les lacunes par niveau de prioritĂ©.
Pour la plupart des projets rĂ©els, utilisez Better Auth plutĂŽt que de construire vous-mĂȘme ces fonctionnalitĂ©s.
| FonctionnalitĂ© | Pourquoi câest important | Norme / RĂ©fĂ©rence |
|---|---|---|
| VĂ©rification des mots de passe compromis | EmpĂȘche lâutilisation de mots de passe connus dans les fuites publiques | NIST SP 800-63B §5.1.1.2, API HIBP |
Découvrez les outils les plus utilisés par notre communauté.
Pas encore de données de popularité.