@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 +46 -16
- package/package.json +2 -2
- package/src/csp.js +40 -0
- package/src/index.d.ts +10 -0
- package/src/index.js +2 -1
- package/src/rateLimiters.js +3 -1
- package/src/webauthn.js +17 -1
package/README.md
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
# @astratra/security
|
|
2
2
|
|
|
3
|
-
Primitives de
|
|
4
|
-
le rate limiting, un WAF heuristique et
|
|
5
|
-
|
|
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/
|
|
27
|
+
app.delete('/api/projects/:id', authorizeRoles('owner', 'admin'), handler);
|
|
28
28
|
```
|
|
29
29
|
|
|
30
|
-
Par
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
60
|
-
|
|
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
|
-
|
|
80
|
-
externe sur l'
|
|
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
|
|
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": "^
|
|
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
package/src/rateLimiters.js
CHANGED
|
@@ -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
|
|
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({
|