@astratra/security 0.1.0 → 0.1.1
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 +22 -6
- package/package.json +1 -1
- package/src/index.d.ts +5 -0
- package/src/jwtAuth.js +15 -4
package/README.md
CHANGED
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
# @astratra/security
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
3
|
+
Primitives de securite applicative pour l'authentification, l'autorisation,
|
|
4
|
+
le rate limiting, un WAF heuristique et WebAuthn/passkeys — generiques et
|
|
5
|
+
decouplees de toute base de donnees, ORM ou liste de roles fixe. Depend de
|
|
6
|
+
`@astratra/core`.
|
|
6
7
|
|
|
7
8
|
Partout où un vrai projet a besoin de persistance (révocation de session,
|
|
8
9
|
stockage de credentials WebAuthn, alerte de brute-force), c'est un
|
|
@@ -16,6 +17,9 @@ const { createAuthMiddleware, authorizeRoles } = require('@astratra/security');
|
|
|
16
17
|
const authMiddleware = createAuthMiddleware({
|
|
17
18
|
secret: process.env.JWT_SECRET,
|
|
18
19
|
legacySecret: process.env.JWT_SECRET_OLD, // optionnel, pour la rotation de clé
|
|
20
|
+
algorithms: ['HS256'], // allowlist explicite
|
|
21
|
+
issuer: 'mon-app', // optionnel, recommande en production
|
|
22
|
+
audience: 'mon-api', // optionnel, recommande en production
|
|
19
23
|
verifySession: async (decoded) => sessionStore.isActive(decoded) // vérification de révocation optionnelle
|
|
20
24
|
});
|
|
21
25
|
|
|
@@ -23,6 +27,14 @@ app.use('/api', authMiddleware);
|
|
|
23
27
|
app.delete('/api/schools/:id', authorizeRoles('owner', 'admin'), handler);
|
|
24
28
|
```
|
|
25
29
|
|
|
30
|
+
Par defaut, le middleware limite la verification a `HS256`. Si ton application
|
|
31
|
+
utilise un autre algorithme, configure explicitement `algorithms`.
|
|
32
|
+
|
|
33
|
+
Si tu extrais le token depuis un cookie, configure le cookie cote application
|
|
34
|
+
avec `HttpOnly`, `Secure` en HTTPS et un `SameSite` adapte. Un cookie JWT peut
|
|
35
|
+
necessiter une protection CSRF selon tes routes, tes methodes HTTP et ton
|
|
36
|
+
mode d'authentification.
|
|
37
|
+
|
|
26
38
|
## Rate limiting
|
|
27
39
|
|
|
28
40
|
```js
|
|
@@ -42,8 +54,10 @@ const { createWafMiddleware } = require('@astratra/security');
|
|
|
42
54
|
app.use(createWafMiddleware({ message: { success: false, message: 'Requête bloquée.' } }));
|
|
43
55
|
```
|
|
44
56
|
|
|
45
|
-
|
|
46
|
-
`req.path`, `req.query` et `req.body`.
|
|
57
|
+
Cette couche detecte des patterns evidents SQLi/XSS/traversee de chemin/RCE
|
|
58
|
+
dans `req.path`, `req.query` et `req.body`. Elle ne remplace pas la
|
|
59
|
+
validation des entrees, les requetes parametrees, une CSP, la sanitation
|
|
60
|
+
adaptee au contexte, ni un WAF/reverse proxy reseau.
|
|
47
61
|
|
|
48
62
|
## WebAuthn / passkeys
|
|
49
63
|
|
|
@@ -61,7 +75,9 @@ const webauthn = createWebauthnService(store, {
|
|
|
61
75
|
`updateCredentialCounter`, `saveChallenge`, `consumeChallenge`, et
|
|
62
76
|
optionnellement `saveRecoveryCodes`/`consumeRecoveryCode` pour les codes de
|
|
63
77
|
récupération. Aucun Mongoose, aucun rôle fixe autorisé à enregistrer une clé
|
|
64
|
-
— ce
|
|
78
|
+
— ce controle d'acces reste a la charge de l'app consommatrice. Avant de
|
|
79
|
+
presenter WebAuthn comme production-ready, prevois une revue de securite
|
|
80
|
+
externe sur l'integration complete.
|
|
65
81
|
|
|
66
82
|
## Tests
|
|
67
83
|
|
package/package.json
CHANGED
package/src/index.d.ts
CHANGED
|
@@ -23,6 +23,11 @@ export type Awaitable<T> = T | Promise<T>;
|
|
|
23
23
|
export interface AuthMiddlewareOptions<TDecoded = Record<string, unknown>> {
|
|
24
24
|
secret: string;
|
|
25
25
|
legacySecret?: string;
|
|
26
|
+
algorithms?: string[];
|
|
27
|
+
issuer?: string;
|
|
28
|
+
audience?: string | string[];
|
|
29
|
+
clockTolerance?: number;
|
|
30
|
+
maxAge?: string | number;
|
|
26
31
|
message?: unknown;
|
|
27
32
|
extractToken?: (req: RequestLike) => string | null | undefined;
|
|
28
33
|
verifySession?: (decoded: TDecoded) => Awaitable<boolean>;
|
package/src/jwtAuth.js
CHANGED
|
@@ -10,6 +10,8 @@ const DEFAULT_FORBIDDEN = {
|
|
|
10
10
|
message: 'Forbidden.'
|
|
11
11
|
};
|
|
12
12
|
|
|
13
|
+
const DEFAULT_ALGORITHMS = ['HS256'];
|
|
14
|
+
|
|
13
15
|
const defaultExtractToken = (req) => {
|
|
14
16
|
const cookieToken = req.cookies && req.cookies.token;
|
|
15
17
|
if (cookieToken) return cookieToken;
|
|
@@ -22,12 +24,20 @@ const defaultExtractToken = (req) => {
|
|
|
22
24
|
return null;
|
|
23
25
|
};
|
|
24
26
|
|
|
25
|
-
const
|
|
27
|
+
const verificationOptionsFrom = (options = {}) => ({
|
|
28
|
+
algorithms: options.algorithms || DEFAULT_ALGORITHMS,
|
|
29
|
+
...(options.issuer ? { issuer: options.issuer } : {}),
|
|
30
|
+
...(options.audience ? { audience: options.audience } : {}),
|
|
31
|
+
...(options.clockTolerance !== undefined ? { clockTolerance: options.clockTolerance } : {}),
|
|
32
|
+
...(options.maxAge ? { maxAge: options.maxAge } : {})
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
const verifyWithRotation = (token, secret, legacySecret, verificationOptions) => {
|
|
26
36
|
try {
|
|
27
|
-
return jwt.verify(token, secret);
|
|
37
|
+
return jwt.verify(token, secret, verificationOptions);
|
|
28
38
|
} catch (error) {
|
|
29
39
|
if (legacySecret && error.name === 'JsonWebTokenError') {
|
|
30
|
-
return jwt.verify(token, legacySecret);
|
|
40
|
+
return jwt.verify(token, legacySecret, verificationOptions);
|
|
31
41
|
}
|
|
32
42
|
throw error;
|
|
33
43
|
}
|
|
@@ -40,6 +50,7 @@ const createAuthMiddleware = (options = {}) => {
|
|
|
40
50
|
|
|
41
51
|
const extractToken = options.extractToken || defaultExtractToken;
|
|
42
52
|
const unauthorizedMessage = options.message || DEFAULT_UNAUTHORIZED;
|
|
53
|
+
const verificationOptions = verificationOptionsFrom(options);
|
|
43
54
|
|
|
44
55
|
return async (req, res, next) => {
|
|
45
56
|
try {
|
|
@@ -48,7 +59,7 @@ const createAuthMiddleware = (options = {}) => {
|
|
|
48
59
|
return res.status(401).json(unauthorizedMessage);
|
|
49
60
|
}
|
|
50
61
|
|
|
51
|
-
const decoded = verifyWithRotation(token, options.secret, options.legacySecret);
|
|
62
|
+
const decoded = verifyWithRotation(token, options.secret, options.legacySecret, verificationOptions);
|
|
52
63
|
|
|
53
64
|
if (options.verifySession) {
|
|
54
65
|
const isActive = await options.verifySession(decoded);
|