@astratra/security 0.1.1 → 1.0.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,9 +1,9 @@
1
1
  # @astratra/security
2
2
 
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`.
3
+ Primitives de sécurité applicative pour l'authentification, l'autorisation,
4
+ le rate limiting, une CSP configurable, un WAF heuristique et
5
+ WebAuthn/passkeys — génériques et découplées de toute base de données, ORM
6
+ ou liste de rôles fixe. Dépend de `@astratra/core`.
7
7
 
8
8
  Partout où un vrai projet a besoin de persistance (révocation de session,
9
9
  stockage de credentials WebAuthn, alerte de brute-force), c'est un
@@ -24,15 +24,15 @@ const authMiddleware = createAuthMiddleware({
24
24
  });
25
25
 
26
26
  app.use('/api', authMiddleware);
27
- app.delete('/api/schools/:id', authorizeRoles('owner', 'admin'), handler);
27
+ app.delete('/api/projects/:id', authorizeRoles('owner', 'admin'), handler);
28
28
  ```
29
29
 
30
- Par defaut, le middleware limite la verification a `HS256`. Si ton application
30
+ Par défaut, le middleware limite la vérification à `HS256`. Si ton application
31
31
  utilise un autre algorithme, configure explicitement `algorithms`.
32
32
 
33
- Si tu extrais le token depuis un cookie, configure le cookie cote application
33
+ Si tu extrais le token depuis un cookie, configure le cookie côté application
34
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
35
+ nécessiter une protection CSRF selon tes routes, tes méthodes HTTP et ton
36
36
  mode d'authentification.
37
37
 
38
38
  ## Rate limiting
@@ -54,10 +54,43 @@ const { createWafMiddleware } = require('@astratra/security');
54
54
  app.use(createWafMiddleware({ message: { success: false, message: 'Requête bloquée.' } }));
55
55
  ```
56
56
 
57
- Cette couche detecte des patterns evidents SQLi/XSS/traversee de chemin/RCE
57
+ Cette couche détecte des patterns évidents SQLi/XSS/traversée de chemin/RCE
58
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.
59
+ validation des entrées, les requêtes paramétrées, une CSP, la sanitation
60
+ adaptée au contexte, ni un WAF/reverse proxy réseau.
61
+
62
+ ## CSP (Content Security Policy)
63
+
64
+ ```js
65
+ const { createCspMiddleware } = require('@astratra/security');
66
+ app.use(createCspMiddleware());
67
+ ```
68
+
69
+ Sans option, la politique par défaut est `default-src 'none';
70
+ frame-ancestors 'none'; base-uri 'none'` — adaptée à une API qui ne sert que
71
+ du JSON. Pour une app qui sert aussi du HTML/JS (SPA servie par un serveur
72
+ Express, pas juste consommée via fetch), surcharge `directives` :
73
+
74
+ ```js
75
+ app.use(createCspMiddleware({
76
+ directives: {
77
+ 'default-src': ["'self'"],
78
+ 'script-src': ["'self'"],
79
+ 'style-src': ["'self'", "'unsafe-inline'"],
80
+ 'connect-src': ["'self'", 'https://api.mon-app.test']
81
+ }
82
+ }));
83
+ ```
84
+
85
+ `reportOnly: true` envoie `Content-Security-Policy-Report-Only` au lieu de
86
+ bloquer, utile pour tester une politique avant de l'appliquer réellement.
87
+
88
+ Pour une SPA React/Vite consommée séparément (comme `@astratra/saas-kit-ui`),
89
+ la CSP se pose plutôt sur le HTML statique lui-même (balise `<meta
90
+ http-equiv="Content-Security-Policy">` injectée au build, jamais en dev — une
91
+ CSP statique en dev casse le websocket HMR de Vite). Voir
92
+ `examples/dashboard-ui/vite.config.js` pour un exemple qui n'injecte la
93
+ balise que sur `vite build`.
61
94
 
62
95
  ## WebAuthn / passkeys
63
96
 
@@ -76,14 +109,11 @@ const webauthn = createWebauthnService(store, {
76
109
  optionnellement `saveRecoveryCodes`/`consumeRecoveryCode` pour les codes de
77
110
  récupération. Aucun Mongoose, aucun rôle fixe autorisé à enregistrer une clé
78
111
  — 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.
112
+ présenter WebAuthn comme un argument de sécurité fort, prévois une revue de
113
+ sécurité externe sur l'intégration complète.
81
114
 
82
115
  ## Tests
83
116
 
84
117
  ```bash
85
118
  npm test --workspace @astratra/security
86
119
  ```
87
-
88
- 21 tests, aucune vraie base de données ni cérémonie WebAuthn navigateur
89
- requise.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@astratra/security",
3
- "version": "0.1.1",
3
+ "version": "1.0.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",
@@ -26,7 +26,7 @@
26
26
  "access": "public"
27
27
  },
28
28
  "dependencies": {
29
- "@astratra/core": "^0.1.0",
29
+ "@astratra/core": "^1.0.0",
30
30
  "@simplewebauthn/server": "^13.1.2",
31
31
  "express-rate-limit": "^7.5.1",
32
32
  "jsonwebtoken": "^9.0.2"
package/src/csp.js ADDED
@@ -0,0 +1,40 @@
1
+ const DEFAULT_DIRECTIVES = {
2
+ 'default-src': ["'none'"],
3
+ 'frame-ancestors': ["'none'"],
4
+ 'base-uri': ["'none'"]
5
+ };
6
+
7
+ function buildHeaderValue(directives) {
8
+ return Object.entries(directives)
9
+ .filter(([, sources]) => Array.isArray(sources) && sources.length > 0)
10
+ .map(([directive, sources]) => `${directive} ${sources.join(' ')}`)
11
+ .join('; ');
12
+ }
13
+
14
+ function mergeDirectives(base, overrides) {
15
+ const merged = { ...base };
16
+ for (const [directive, sources] of Object.entries(overrides || {})) {
17
+ merged[directive] = sources;
18
+ }
19
+ return merged;
20
+ }
21
+
22
+ function createCspMiddleware(options = {}) {
23
+ const directives = mergeDirectives(DEFAULT_DIRECTIVES, options.directives);
24
+ const headerValue = buildHeaderValue(directives);
25
+ const headerName = options.reportOnly
26
+ ? 'Content-Security-Policy-Report-Only'
27
+ : 'Content-Security-Policy';
28
+
29
+ return (req, res, next) => {
30
+ if (headerValue) {
31
+ res.setHeader(headerName, headerValue);
32
+ }
33
+ next();
34
+ };
35
+ }
36
+
37
+ module.exports = {
38
+ createCspMiddleware,
39
+ DEFAULT_CSP_DIRECTIVES: DEFAULT_DIRECTIVES
40
+ };
package/src/index.d.ts CHANGED
@@ -87,6 +87,16 @@ export interface WafOptions {
87
87
  }
88
88
 
89
89
  export function createWafMiddleware(options?: WafOptions): RequestHandler;
90
+
91
+ export type CspDirectives = Record<string, string[]>;
92
+
93
+ export interface CspOptions {
94
+ directives?: CspDirectives;
95
+ reportOnly?: boolean;
96
+ }
97
+
98
+ export function createCspMiddleware(options?: CspOptions): RequestHandler;
99
+ export const DEFAULT_CSP_DIRECTIVES: CspDirectives;
90
100
  export const WAF_PATTERNS: RegExp[];
91
101
 
92
102
  export const CHALLENGE_TTL_MS: number;
package/src/index.js CHANGED
@@ -2,5 +2,6 @@ module.exports = {
2
2
  ...require('./jwtAuth'),
3
3
  ...require('./rateLimiters'),
4
4
  ...require('./waf'),
5
- ...require('./webauthn')
5
+ ...require('./webauthn'),
6
+ ...require('./csp')
6
7
  };
@@ -145,10 +145,12 @@ const withOptionalStore = (limiterOptions, store) => {
145
145
  return { ...limiterOptions, store };
146
146
  };
147
147
 
148
+ const defaultApiSkip = () => (process.env.NODE_ENV === 'production' ? undefined : skipLocalhost);
149
+
148
150
  const createApiLimiter = (options = {}) => rateLimit(withOptionalStore({
149
151
  windowMs: options.windowMs || 15 * 60 * 1000,
150
152
  max: options.max || 300,
151
- skip: options.skip || skipLocalhost,
153
+ skip: options.skip ?? defaultApiSkip(),
152
154
  standardHeaders: options.standardHeaders ?? true,
153
155
  legacyHeaders: options.legacyHeaders ?? false,
154
156
  validate: options.validate || { ip: false },
package/src/webauthn.js CHANGED
@@ -93,10 +93,17 @@ const normalizeChallenge = (pending) => {
93
93
  return {
94
94
  challenge: pending.challenge,
95
95
  origin: pending.origin || pending.metadata?.origin,
96
- rpID: pending.rpID || pending.metadata?.rpID
96
+ rpID: pending.rpID || pending.metadata?.rpID,
97
+ expiresAt: pending.expiresAt || pending.metadata?.expiresAt
97
98
  };
98
99
  };
99
100
 
101
+ const isExpiredChallenge = (pending) => {
102
+ if (!pending?.expiresAt) return false;
103
+ const expiresAt = new Date(pending.expiresAt).getTime();
104
+ return Number.isFinite(expiresAt) && expiresAt <= Date.now();
105
+ };
106
+
100
107
  const publicKeyToBase64Url = (publicKey) => {
101
108
  if (Buffer.isBuffer(publicKey)) return publicKey.toString('base64url');
102
109
  if (publicKey instanceof Uint8Array) return Buffer.from(publicKey).toString('base64url');
@@ -164,6 +171,9 @@ const createWebauthnService = (store, options = {}) => {
164
171
  if (!pending) {
165
172
  throw createError('No pending WebAuthn registration challenge.', 400);
166
173
  }
174
+ if (isExpiredChallenge(pending)) {
175
+ throw createError('Expired WebAuthn registration challenge.', 400);
176
+ }
167
177
 
168
178
  const verification = await verifyRegistrationResponse({
169
179
  response,
@@ -222,11 +232,17 @@ const createWebauthnService = (store, options = {}) => {
222
232
  if (!pending) {
223
233
  throw createError('No pending WebAuthn authentication challenge.', 400);
224
234
  }
235
+ if (isExpiredChallenge(pending)) {
236
+ throw createError('Expired WebAuthn authentication challenge.', 400);
237
+ }
225
238
 
226
239
  const stored = await store.getCredentialById(response.id);
227
240
  if (!stored) {
228
241
  throw createError('Unknown WebAuthn credential.', 401);
229
242
  }
243
+ if (String(stored.userId) !== String(userId)) {
244
+ throw createError('WebAuthn credential does not belong to this user.', 401);
245
+ }
230
246
 
231
247
  const credentialID = stored.credentialID || stored.id;
232
248
  const verification = await verifyAuthenticationResponse({