Référence d'API — @nodefony/security — throttle

stable

Documentation › Référence d’API › @nodefony/security › throttle

Générée depuis les déclarations de types publiées de @nodefony/security 10.0.0-beta.5 : exactement ce que reçoit une application qui l’installe. Cette page n’existe dans aucun dépôt — pour la corriger, on corrige le TSDoc du code.

@nodefony/security#

import { … } from "@nodefony/security" — 2 symboles.

Classes (1)#

LoginThrottler#

class LoginThrottler

Limiteur de tentatives de login en mémoire, par identifiant saisi.

• readonly freeAttempts: number
• readonly baseDelayS: number
• readonly capDelayS: number
• readonly maxTracked: number
• constructor(options?: ILoginThrottleOptions, now?: () => number)
• check(identifier: string): number — L’identifiant peut-il tenter un login maintenant ?
• recordFailure(identifier: string): void — Enregistre un échec : au-delà de freeAttempts, arme un délai exponentiel baseDelayS × 2^(échecs - freeAttempts - 1), plafonné à capDelayS.
• recordSuccess(identifier: string): void — Login réussi : oublie l’identifiant (le délai repart de zéro — NIST : l’utilisateur légitime ne traîne pas la dette d’un attaquant passé).
• get trackedCount(): number — Nombre d’identifiants actuellement suivis (introspection / tests).

Interfaces (1)#

ILoginThrottleOptions#

interface ILoginThrottleOptions

Politique de backoff du throttling de login (NIST SP 800-63B §5.2.2).

• freeAttempts?: number — Échecs consécutifs tolérés sans délai (défaut 3 — fautes de frappe).
• baseDelayS?: number — Délai (s) après freeAttempts — double à chaque échec suivant (défaut 1).
• capDelayS?: number — Plafond du délai (s) — défaut 900 (15 min).
• maxTracked?: number — Borne du nombre d’identifiants suivis (anti-fuite mémoire, défaut 10 000).

← Toutes les références d’API