@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 CHANGED
@@ -1,8 +1,9 @@
1
1
  # @astratra/security
2
2
 
3
- Authentification, autorisation, rate limiting, WAF et WebAuthn/passkeys —
4
- générique et découplé de toute base de données, ORM ou liste de rôles fixe.
5
- Dépend de `@astratra/core`.
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
- Bloque les patterns SQLi/XSS/traversée de chemin/RCE courants dans
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 contrôle d'accès reste à la charge de l'app consommatrice.
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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@astratra/security",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Generic authentication and security middleware for Astratra workspaces.",
5
5
  "main": "src/index.js",
6
6
  "types": "src/index.d.ts",
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 verifyWithRotation = (token, secret, legacySecret) => {
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);