@astratra/security 1.13.0 → 1.14.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -0
- package/package.json +1 -1
- package/src/index.d.ts +3 -1
- package/src/rateLimiters.js +21 -9
package/README.md
CHANGED
|
@@ -407,6 +407,20 @@ app.use('/auth', createLoginLimiter({
|
|
|
407
407
|
app.use('/auth/login', createAccountLimiter({ onBlocked: ({ identifier }) => { /* ... */ } }));
|
|
408
408
|
```
|
|
409
409
|
|
|
410
|
+
Un compteur par zone, pour qu'un dépassement sur une page ne bloque pas les autres. Les noms forment une liste fermée, jamais une valeur tirée librement de l'adresse demandée :
|
|
411
|
+
|
|
412
|
+
```js
|
|
413
|
+
const ZONES = new Set(['notes', 'reunions']);
|
|
414
|
+
app.use(createApiLimiter({
|
|
415
|
+
max: 300,
|
|
416
|
+
area: (req) => {
|
|
417
|
+
const premier = req.path.split('/')[1];
|
|
418
|
+
if (req.path.endsWith('/chapitres')) return { name: 'chapitres', max: 2000 };
|
|
419
|
+
return { name: ZONES.has(premier) ? premier : 'autres' };
|
|
420
|
+
}
|
|
421
|
+
}));
|
|
422
|
+
```
|
|
423
|
+
|
|
410
424
|
`createAccountLimiter()` identifie le compte via `req.body.email` par défaut : comme
|
|
411
425
|
`createWafMiddleware()`, il doit être monté APRÈS `express.json()`/`express.urlencoded()`.
|
|
412
426
|
Avant, `req.body` vaut `undefined` et toutes les tentatives retombent sur la clé
|
package/package.json
CHANGED
package/src/index.d.ts
CHANGED
|
@@ -304,7 +304,9 @@ export interface AccountLimiterOptions extends RateLimitOptions {
|
|
|
304
304
|
onBlocked?: (context: AccountBlockedContext) => Awaitable<void>;
|
|
305
305
|
}
|
|
306
306
|
|
|
307
|
-
|
|
307
|
+
/** Un compteur à part pour une zone de l'application ; `max` remplace la limite générale. */
|
|
308
|
+
export interface RateLimitArea { name: string; max?: number }
|
|
309
|
+
export function createApiLimiter(options?: RateLimitOptions & { area?: (req: any) => RateLimitArea | null | undefined }): RequestHandler;
|
|
308
310
|
export function createLoginLimiter(options?: LoginLimiterOptions): RequestHandler;
|
|
309
311
|
export function createAccountLimiter(options?: AccountLimiterOptions): RequestHandler;
|
|
310
312
|
export function skipLocalhost(req: RequestLike): boolean;
|
package/src/rateLimiters.js
CHANGED
|
@@ -174,15 +174,27 @@ const withOptionalStore = (limiterOptions, store) => {
|
|
|
174
174
|
|
|
175
175
|
const defaultApiSkip = () => (process.env.NODE_ENV === 'production' ? undefined : skipLocalhost);
|
|
176
176
|
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
177
|
+
/**
|
|
178
|
+
* `area(req)` sépare les compteurs : chaque zone rendue (`{ name, max }`) a le
|
|
179
|
+
* sien, par adresse. Avec un seul compteur, une boucle ou un gros téléchargement
|
|
180
|
+
* sur une page rendait toutes les autres indisponibles. L'application donne une
|
|
181
|
+
* liste fermée de noms : un nom tiré librement de l'adresse demandée offrirait
|
|
182
|
+
* un compteur neuf à chaque requête, donc plus aucune limite.
|
|
183
|
+
*/
|
|
184
|
+
const createApiLimiter = (options = {}) => {
|
|
185
|
+
const fallback = options.max || 300;
|
|
186
|
+
const { area } = options;
|
|
187
|
+
return rateLimit(withOptionalStore({
|
|
188
|
+
windowMs: options.windowMs || 15 * 60 * 1000,
|
|
189
|
+
max: area ? (req) => area(req)?.max || fallback : fallback,
|
|
190
|
+
...(area ? { keyGenerator: (req) => `${area(req)?.name || 'default'}:${getIp(req)}` } : {}),
|
|
191
|
+
skip: options.skip ?? defaultApiSkip(),
|
|
192
|
+
standardHeaders: options.standardHeaders ?? true,
|
|
193
|
+
legacyHeaders: options.legacyHeaders ?? false,
|
|
194
|
+
validate: options.validate || { ip: false },
|
|
195
|
+
message: options.message || DEFAULT_API_MESSAGE
|
|
196
|
+
}, resolveStore(options)));
|
|
197
|
+
};
|
|
186
198
|
|
|
187
199
|
const createLoginLimiter = (options = {}) => rateLimit(withOptionalStore({
|
|
188
200
|
windowMs: options.windowMs || 15 * 60 * 1000,
|