---
title: "Référence d'API — @nodefony/security — throttle"
source: docs/api/security/throttle.md
url: https://nodefony.github.io/nodefony-core/docs/api/security/throttle/
---


[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`

```ts
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`

```ts
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](../../)