@request-shield/server 0.0.0-stage → 0.3.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/LICENSE +21 -0
- package/README.md +95 -2
- package/dist/cors.d.ts +25 -0
- package/dist/cors.d.ts.map +1 -0
- package/dist/cors.js +46 -0
- package/dist/cors.js.map +1 -0
- package/dist/express.d.ts +33 -0
- package/dist/express.d.ts.map +1 -0
- package/dist/express.js +81 -0
- package/dist/express.js.map +1 -0
- package/dist/fastify.d.ts +31 -0
- package/dist/fastify.d.ts.map +1 -0
- package/dist/fastify.js +58 -0
- package/dist/fastify.js.map +1 -0
- package/dist/hono.d.ts +31 -0
- package/dist/hono.d.ts.map +1 -0
- package/dist/hono.js +35 -0
- package/dist/hono.js.map +1 -0
- package/dist/index.d.ts +118 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +274 -0
- package/dist/index.js.map +1 -0
- package/dist/nestjs.d.ts +28 -0
- package/dist/nestjs.d.ts.map +1 -0
- package/dist/nestjs.js +70 -0
- package/dist/nestjs.js.map +1 -0
- package/dist/node.d.ts +22 -0
- package/dist/node.d.ts.map +1 -0
- package/dist/node.js +76 -0
- package/dist/node.js.map +1 -0
- package/dist/redis.d.ts +30 -0
- package/dist/redis.d.ts.map +1 -0
- package/dist/redis.js +33 -0
- package/dist/redis.js.map +1 -0
- package/package.json +84 -4
package/dist/index.js
ADDED
|
@@ -0,0 +1,274 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Server-side verifier for @request-shield clients, built on Web standards (WebCrypto + Fetch API types),
|
|
3
|
+
* so it runs on Node 20+, Bun, Deno and Cloudflare Workers. Mirrors the Go verifier in server/go.
|
|
4
|
+
*/
|
|
5
|
+
import { canonicalString, SHIELD_ERROR_HEADER, SHIELD_HEADERS } from '@request-shield/core';
|
|
6
|
+
export { SHIELD_ERROR_HEADER, SHIELD_HEADERS };
|
|
7
|
+
/** Request headers your CORS config must allow. */
|
|
8
|
+
export const SHIELD_REQUEST_HEADERS = Object.values(SHIELD_HEADERS);
|
|
9
|
+
export class MemoryShieldStore {
|
|
10
|
+
sessions = new Map();
|
|
11
|
+
nonces = new Map();
|
|
12
|
+
lastSweep = 0;
|
|
13
|
+
async saveSession(session) {
|
|
14
|
+
this.sessions.set(session.id, session);
|
|
15
|
+
}
|
|
16
|
+
async getSession(id) {
|
|
17
|
+
return this.sessions.get(id) ?? null;
|
|
18
|
+
}
|
|
19
|
+
async useNonce(sessionId, nonce, ttlMs) {
|
|
20
|
+
const now = Date.now();
|
|
21
|
+
this.sweep(now);
|
|
22
|
+
const key = `${sessionId}|${nonce}`;
|
|
23
|
+
const exp = this.nonces.get(key);
|
|
24
|
+
if (exp !== undefined && exp > now)
|
|
25
|
+
return false;
|
|
26
|
+
this.nonces.set(key, now + ttlMs);
|
|
27
|
+
return true;
|
|
28
|
+
}
|
|
29
|
+
sweep(now) {
|
|
30
|
+
if (now - this.lastSweep < 60_000)
|
|
31
|
+
return;
|
|
32
|
+
this.lastSweep = now;
|
|
33
|
+
for (const [k, exp] of this.nonces)
|
|
34
|
+
if (exp <= now)
|
|
35
|
+
this.nonces.delete(k);
|
|
36
|
+
for (const [id, s] of this.sessions)
|
|
37
|
+
if (s.expiresAt <= now)
|
|
38
|
+
this.sessions.delete(id);
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
const enc = new TextEncoder();
|
|
42
|
+
function b64urlEncode(bytes) {
|
|
43
|
+
let bin = '';
|
|
44
|
+
for (const b of bytes)
|
|
45
|
+
bin += String.fromCharCode(b);
|
|
46
|
+
return btoa(bin).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
|
|
47
|
+
}
|
|
48
|
+
function b64urlDecode(s) {
|
|
49
|
+
if (!/^[A-Za-z0-9_-]*$/.test(s))
|
|
50
|
+
return null;
|
|
51
|
+
try {
|
|
52
|
+
const bin = atob(s.replace(/-/g, '+').replace(/_/g, '/') + '='.repeat((4 - (s.length % 4)) % 4));
|
|
53
|
+
const out = new Uint8Array(bin.length);
|
|
54
|
+
for (let i = 0; i < bin.length; i++)
|
|
55
|
+
out[i] = bin.charCodeAt(i);
|
|
56
|
+
return out;
|
|
57
|
+
}
|
|
58
|
+
catch {
|
|
59
|
+
return null;
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
async function sha256(data) {
|
|
63
|
+
return new Uint8Array(await crypto.subtle.digest('SHA-256', data));
|
|
64
|
+
}
|
|
65
|
+
/** Same as the Go verifier: first 8 bytes of SHA-256(User-Agent), hex. */
|
|
66
|
+
async function hashUserAgent(ua) {
|
|
67
|
+
const h = await sha256(enc.encode(ua));
|
|
68
|
+
return Array.from(h.slice(0, 8), (b) => b.toString(16).padStart(2, '0')).join('');
|
|
69
|
+
}
|
|
70
|
+
function json(status, body, headers = {}) {
|
|
71
|
+
return new Response(JSON.stringify(body), {
|
|
72
|
+
status,
|
|
73
|
+
headers: { 'Content-Type': 'application/json', 'Cache-Control': 'no-store', ...headers },
|
|
74
|
+
});
|
|
75
|
+
}
|
|
76
|
+
const STATUS = {
|
|
77
|
+
missing: 401,
|
|
78
|
+
session: 401,
|
|
79
|
+
skew: 401,
|
|
80
|
+
signature: 401,
|
|
81
|
+
replay: 401,
|
|
82
|
+
body: 413,
|
|
83
|
+
origin: 403,
|
|
84
|
+
attestation: 403,
|
|
85
|
+
bad_request: 400,
|
|
86
|
+
};
|
|
87
|
+
export class ShieldServer {
|
|
88
|
+
cfg;
|
|
89
|
+
keyCache = new Map();
|
|
90
|
+
constructor(config) {
|
|
91
|
+
if (!config.verifyAttestation && !config.allowNoAttestation) {
|
|
92
|
+
throw new Error('request-shield: verifyAttestation is required (set allowNoAttestation only for local development)');
|
|
93
|
+
}
|
|
94
|
+
this.cfg = {
|
|
95
|
+
allowedOrigins: config.allowedOrigins ?? [],
|
|
96
|
+
allowedPlatforms: config.allowedPlatforms ?? ['web'],
|
|
97
|
+
verifyAttestation: config.verifyAttestation,
|
|
98
|
+
allowNoAttestation: config.allowNoAttestation ?? false,
|
|
99
|
+
sessionTtlMs: config.sessionTtlMs ?? 12 * 60 * 60 * 1000,
|
|
100
|
+
maxClockSkewMs: config.maxClockSkewMs ?? 60_000,
|
|
101
|
+
maxBodyBytes: config.maxBodyBytes ?? 10 * 1024 * 1024,
|
|
102
|
+
store: config.store ?? new MemoryShieldStore(),
|
|
103
|
+
bindUserAgent: config.bindUserAgent ?? true,
|
|
104
|
+
canonicalPath: config.canonicalPath ??
|
|
105
|
+
((r) => {
|
|
106
|
+
const u = new URL(r.url);
|
|
107
|
+
return u.pathname + u.search;
|
|
108
|
+
}),
|
|
109
|
+
onReject: config.onReject,
|
|
110
|
+
now: config.now ?? Date.now,
|
|
111
|
+
};
|
|
112
|
+
}
|
|
113
|
+
reject(request, code, reason) {
|
|
114
|
+
this.cfg.onReject?.(code, request, reason);
|
|
115
|
+
return {
|
|
116
|
+
ok: false,
|
|
117
|
+
code,
|
|
118
|
+
reason,
|
|
119
|
+
response: json(STATUS[code], { error: `shield_${code}` }, { [SHIELD_ERROR_HEADER]: code }),
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
/** Handle POST {publicKey, attestation, platform}; returns {sessionId, expiresAt, serverTime}. */
|
|
123
|
+
async register(request) {
|
|
124
|
+
if (request.method.toUpperCase() !== 'POST') {
|
|
125
|
+
return new Response('method not allowed', { status: 405, headers: { Allow: 'POST' } });
|
|
126
|
+
}
|
|
127
|
+
const raw = await request.arrayBuffer();
|
|
128
|
+
if (raw.byteLength > 16 * 1024)
|
|
129
|
+
return this.reject(request, 'bad_request', 'body too large').response;
|
|
130
|
+
let body;
|
|
131
|
+
try {
|
|
132
|
+
body = JSON.parse(new TextDecoder().decode(raw));
|
|
133
|
+
}
|
|
134
|
+
catch {
|
|
135
|
+
return this.reject(request, 'bad_request', 'invalid JSON').response;
|
|
136
|
+
}
|
|
137
|
+
body.platform ||= 'web';
|
|
138
|
+
if (!this.cfg.allowedPlatforms.includes(body.platform)) {
|
|
139
|
+
return this.reject(request, 'bad_request', `platform "${body.platform}" not allowed`).response;
|
|
140
|
+
}
|
|
141
|
+
if (body.platform === 'web' && this.cfg.allowedOrigins.length > 0) {
|
|
142
|
+
const origin = request.headers.get('origin') ?? '';
|
|
143
|
+
if (!this.cfg.allowedOrigins.includes(origin)) {
|
|
144
|
+
return this.reject(request, 'origin', `origin "${origin}" not allowed`).response;
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
const pk = body.publicKey;
|
|
148
|
+
const x = pk && b64urlDecode(pk.x ?? '');
|
|
149
|
+
const y = pk && b64urlDecode(pk.y ?? '');
|
|
150
|
+
if (!pk || pk.kty !== 'EC' || pk.crv !== 'P-256' || x?.length !== 32 || y?.length !== 32) {
|
|
151
|
+
return this.reject(request, 'bad_request', 'publicKey must be an EC P-256 JWK').response;
|
|
152
|
+
}
|
|
153
|
+
const publicKey = { kty: 'EC', crv: 'P-256', x: pk.x, y: pk.y };
|
|
154
|
+
let key;
|
|
155
|
+
try {
|
|
156
|
+
key = await importKey(publicKey); // also rejects points that are not on the curve
|
|
157
|
+
}
|
|
158
|
+
catch {
|
|
159
|
+
return this.reject(request, 'bad_request', 'invalid public key').response;
|
|
160
|
+
}
|
|
161
|
+
if (this.cfg.verifyAttestation) {
|
|
162
|
+
try {
|
|
163
|
+
await this.cfg.verifyAttestation(body, request);
|
|
164
|
+
}
|
|
165
|
+
catch (e) {
|
|
166
|
+
return this.reject(request, 'attestation', e instanceof Error ? e.message : String(e)).response;
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
const now = this.cfg.now();
|
|
170
|
+
const session = {
|
|
171
|
+
id: b64urlEncode(crypto.getRandomValues(new Uint8Array(32))),
|
|
172
|
+
publicKey,
|
|
173
|
+
platform: body.platform,
|
|
174
|
+
expiresAt: now + this.cfg.sessionTtlMs,
|
|
175
|
+
};
|
|
176
|
+
if (this.cfg.bindUserAgent)
|
|
177
|
+
session.userAgentHash = await hashUserAgent(request.headers.get('user-agent') ?? '');
|
|
178
|
+
await this.cfg.store.saveSession(session, this.cfg.sessionTtlMs);
|
|
179
|
+
this.keyCache.set(session.id, key);
|
|
180
|
+
return json(200, { sessionId: session.id, expiresAt: session.expiresAt, serverTime: now });
|
|
181
|
+
}
|
|
182
|
+
/**
|
|
183
|
+
* Verify a signed request. On success you get the session and the exact body bytes
|
|
184
|
+
* (the request body stream has been read, so use `body` instead of reading it again).
|
|
185
|
+
*/
|
|
186
|
+
async verify(request) {
|
|
187
|
+
if (request.method.toUpperCase() === 'OPTIONS') {
|
|
188
|
+
return this.reject(request, 'missing', 'preflight requests carry no signature');
|
|
189
|
+
}
|
|
190
|
+
const h = (n) => request.headers.get(n);
|
|
191
|
+
const sessionId = h(SHIELD_HEADERS.session);
|
|
192
|
+
const tsRaw = h(SHIELD_HEADERS.timestamp);
|
|
193
|
+
const nonce = h(SHIELD_HEADERS.nonce);
|
|
194
|
+
const sigRaw = h(SHIELD_HEADERS.signature);
|
|
195
|
+
if (!sessionId || !tsRaw || !nonce || !sigRaw || nonce.length > 64 || !/^\d{1,16}$/.test(tsRaw)) {
|
|
196
|
+
return this.reject(request, 'missing', 'request is not signed');
|
|
197
|
+
}
|
|
198
|
+
const now = this.cfg.now();
|
|
199
|
+
const skew = now - Number(tsRaw);
|
|
200
|
+
if (Math.abs(skew) > this.cfg.maxClockSkewMs) {
|
|
201
|
+
return this.reject(request, 'skew', `timestamp is ${Math.round(skew / 1000)}s off`);
|
|
202
|
+
}
|
|
203
|
+
const session = await this.cfg.store.getSession(sessionId);
|
|
204
|
+
if (!session || session.expiresAt <= now) {
|
|
205
|
+
return this.reject(request, 'session', 'unknown or expired session');
|
|
206
|
+
}
|
|
207
|
+
if (session.userAgentHash && session.userAgentHash !== (await hashUserAgent(h('user-agent') ?? ''))) {
|
|
208
|
+
return this.reject(request, 'session', 'User-Agent differs from the one that registered');
|
|
209
|
+
}
|
|
210
|
+
const body = new Uint8Array(await request.arrayBuffer());
|
|
211
|
+
if (body.byteLength > this.cfg.maxBodyBytes)
|
|
212
|
+
return this.reject(request, 'body', 'body too large');
|
|
213
|
+
const sig = b64urlDecode(sigRaw);
|
|
214
|
+
if (!sig || sig.length !== 64)
|
|
215
|
+
return this.reject(request, 'signature', 'malformed signature');
|
|
216
|
+
let key = this.keyCache.get(session.id);
|
|
217
|
+
if (!key) {
|
|
218
|
+
key = await importKey(session.publicKey);
|
|
219
|
+
this.keyCache.set(session.id, key);
|
|
220
|
+
}
|
|
221
|
+
const canonical = canonicalString(request.method, this.cfg.canonicalPath(request), tsRaw, nonce, b64urlEncode(await sha256(body)));
|
|
222
|
+
const valid = await crypto.subtle.verify({ name: 'ECDSA', hash: 'SHA-256' }, key, sig, enc.encode(canonical));
|
|
223
|
+
if (!valid)
|
|
224
|
+
return this.reject(request, 'signature', 'signature does not match this request');
|
|
225
|
+
// Only burn the nonce once the signature checks out, so junk can't fill the store.
|
|
226
|
+
if (!(await this.cfg.store.useNonce(session.id, nonce, 2 * this.cfg.maxClockSkewMs))) {
|
|
227
|
+
return this.reject(request, 'replay', 'this exact request was already used');
|
|
228
|
+
}
|
|
229
|
+
const contentType = request.headers.get('content-type') ?? '';
|
|
230
|
+
return { ok: true, session, body, formData: () => parseFormData(body, contentType) };
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
/** Parse multipart/form-data or application/x-www-form-urlencoded bytes into FormData (uses the platform parser). */
|
|
234
|
+
export function parseFormData(body, contentType) {
|
|
235
|
+
const copy = new Uint8Array(body.byteLength); // real copy (Buffer#slice would not copy)
|
|
236
|
+
copy.set(body);
|
|
237
|
+
return new Response(copy, { headers: { 'content-type': contentType } }).formData();
|
|
238
|
+
}
|
|
239
|
+
function importKey(jwk) {
|
|
240
|
+
return crypto.subtle.importKey('jwk', { ...jwk, ext: true }, { name: 'ECDSA', namedCurve: 'P-256' }, false, [
|
|
241
|
+
'verify',
|
|
242
|
+
]);
|
|
243
|
+
}
|
|
244
|
+
export function createShieldServer(config) {
|
|
245
|
+
return new ShieldServer(config);
|
|
246
|
+
}
|
|
247
|
+
/**
|
|
248
|
+
* Cloudflare Turnstile check for registration.
|
|
249
|
+
* createShieldServer({ verifyAttestation: turnstileVerifier({ secret: env.TURNSTILE_SECRET }) })
|
|
250
|
+
*/
|
|
251
|
+
export function turnstileVerifier(options) {
|
|
252
|
+
const f = options.fetch ?? globalThis.fetch.bind(globalThis);
|
|
253
|
+
return async (body) => {
|
|
254
|
+
if (body.platform !== 'web')
|
|
255
|
+
throw new Error(`turnstile cannot attest platform "${body.platform}"`);
|
|
256
|
+
if (!body.attestation)
|
|
257
|
+
throw new Error('missing turnstile token');
|
|
258
|
+
const res = await f('https://challenges.cloudflare.com/turnstile/v0/siteverify', {
|
|
259
|
+
method: 'POST',
|
|
260
|
+
headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
|
|
261
|
+
body: new URLSearchParams({ secret: options.secret, response: body.attestation }).toString(),
|
|
262
|
+
});
|
|
263
|
+
const out = (await res.json());
|
|
264
|
+
if (!out.success)
|
|
265
|
+
throw new Error(`turnstile rejected token: ${out['error-codes']?.join(', ')}`);
|
|
266
|
+
if (options.hostnames?.length && !options.hostnames.includes(out.hostname ?? '')) {
|
|
267
|
+
throw new Error(`turnstile hostname "${out.hostname}" not allowed`);
|
|
268
|
+
}
|
|
269
|
+
if (options.action && out.action !== options.action)
|
|
270
|
+
throw new Error(`turnstile action "${out.action}" mismatch`);
|
|
271
|
+
};
|
|
272
|
+
}
|
|
273
|
+
export { corsHeaders, withCors } from './cors.js';
|
|
274
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/nestjs.d.ts
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* NestJS guard (Express or Fastify platform).
|
|
3
|
+
*
|
|
4
|
+
* // main.ts: rawBody is required so the guard can check the exact bytes that were signed
|
|
5
|
+
* const app = await NestFactory.create(AppModule, { rawBody: true });
|
|
6
|
+
* const shield = createShieldServer({ allowedOrigins: [...], verifyAttestation });
|
|
7
|
+
* app.use('/shield/register', expressShield(shield).register); // Express platform
|
|
8
|
+
* app.useGlobalGuards(new ShieldGuard(shield, { exclude: (req) => req.url.startsWith('/health') }));
|
|
9
|
+
*
|
|
10
|
+
* // or per controller: @UseGuards(new ShieldGuard(shield))
|
|
11
|
+
*
|
|
12
|
+
* Handlers get req.shieldSession. For multipart uploads the guard parses the form itself
|
|
13
|
+
* (fields in req.body, files in req.files as web File objects); don't add FileInterceptor.
|
|
14
|
+
*/
|
|
15
|
+
import { type CanActivate, type ExecutionContext } from '@nestjs/common';
|
|
16
|
+
import type { ShieldServer } from './index.js';
|
|
17
|
+
export interface ShieldGuardOptions {
|
|
18
|
+
/** Return true to let a request through without verification (health checks, public routes). */
|
|
19
|
+
exclude?: (req: any) => boolean;
|
|
20
|
+
maxBodyBytes?: number;
|
|
21
|
+
}
|
|
22
|
+
export declare class ShieldGuard implements CanActivate {
|
|
23
|
+
private readonly shield;
|
|
24
|
+
private readonly options;
|
|
25
|
+
constructor(shield: ShieldServer, options?: ShieldGuardOptions);
|
|
26
|
+
canActivate(context: ExecutionContext): Promise<boolean>;
|
|
27
|
+
}
|
|
28
|
+
//# sourceMappingURL=nestjs.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"nestjs.d.ts","sourceRoot":"","sources":["../src/nestjs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAiB,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,MAAM,WAAW,kBAAkB;IACjC,gGAAgG;IAChG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAOD,qBAAa,WAAY,YAAW,WAAW;IAE3C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,kBAAuB;IAG7C,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;CAwC/D"}
|
package/dist/nestjs.js
ADDED
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* NestJS guard (Express or Fastify platform).
|
|
3
|
+
*
|
|
4
|
+
* // main.ts: rawBody is required so the guard can check the exact bytes that were signed
|
|
5
|
+
* const app = await NestFactory.create(AppModule, { rawBody: true });
|
|
6
|
+
* const shield = createShieldServer({ allowedOrigins: [...], verifyAttestation });
|
|
7
|
+
* app.use('/shield/register', expressShield(shield).register); // Express platform
|
|
8
|
+
* app.useGlobalGuards(new ShieldGuard(shield, { exclude: (req) => req.url.startsWith('/health') }));
|
|
9
|
+
*
|
|
10
|
+
* // or per controller: @UseGuards(new ShieldGuard(shield))
|
|
11
|
+
*
|
|
12
|
+
* Handlers get req.shieldSession. For multipart uploads the guard parses the form itself
|
|
13
|
+
* (fields in req.body, files in req.files as web File objects); don't add FileInterceptor.
|
|
14
|
+
*/
|
|
15
|
+
import { HttpException } from '@nestjs/common';
|
|
16
|
+
import { isFormContentType, readStream, splitForm, toShieldRequest } from './node.js';
|
|
17
|
+
function hasBody(req) {
|
|
18
|
+
const len = Number(req.headers['content-length'] ?? 0);
|
|
19
|
+
return len > 0 || req.headers['transfer-encoding'] !== undefined;
|
|
20
|
+
}
|
|
21
|
+
export class ShieldGuard {
|
|
22
|
+
shield;
|
|
23
|
+
options;
|
|
24
|
+
constructor(shield, options = {}) {
|
|
25
|
+
this.shield = shield;
|
|
26
|
+
this.options = options;
|
|
27
|
+
}
|
|
28
|
+
async canActivate(context) {
|
|
29
|
+
if (context.getType() !== 'http')
|
|
30
|
+
return true;
|
|
31
|
+
const http = context.switchToHttp();
|
|
32
|
+
const req = http.getRequest();
|
|
33
|
+
const res = http.getResponse();
|
|
34
|
+
if (req.method === 'OPTIONS' || this.options.exclude?.(req))
|
|
35
|
+
return true;
|
|
36
|
+
const raw = req.raw ?? req; // Fastify platform wraps the Node request
|
|
37
|
+
const contentType = String(req.headers['content-type'] ?? '');
|
|
38
|
+
let bytes;
|
|
39
|
+
if (req.rawBody instanceof Uint8Array) {
|
|
40
|
+
bytes = req.rawBody;
|
|
41
|
+
}
|
|
42
|
+
else if (!hasBody(req)) {
|
|
43
|
+
bytes = new Uint8Array();
|
|
44
|
+
}
|
|
45
|
+
else if (/^multipart\/form-data/i.test(contentType) && !raw.readableEnded) {
|
|
46
|
+
// Nest's body parsers skip multipart, so the stream is still unread here.
|
|
47
|
+
bytes = await readStream(raw, this.options.maxBodyBytes ?? 10 * 1024 * 1024);
|
|
48
|
+
}
|
|
49
|
+
else {
|
|
50
|
+
throw new Error('request-shield: request body is not available. Create the app with NestFactory.create(AppModule, { rawBody: true }).');
|
|
51
|
+
}
|
|
52
|
+
const result = await this.shield.verify(toShieldRequest(req.method, req.originalUrl ?? raw.url ?? req.url, req.headers, bytes));
|
|
53
|
+
if (!result.ok) {
|
|
54
|
+
const setHeader = typeof res.setHeader === 'function' ? res.setHeader.bind(res) : res.header.bind(res);
|
|
55
|
+
result.response.headers.forEach((v, k) => {
|
|
56
|
+
if (k.toLowerCase() !== 'content-type')
|
|
57
|
+
setHeader(k, v);
|
|
58
|
+
});
|
|
59
|
+
throw new HttpException(await result.response.json(), result.response.status);
|
|
60
|
+
}
|
|
61
|
+
req.shieldSession = result.session;
|
|
62
|
+
if (bytes.length && isFormContentType(contentType) && !req.rawBody) {
|
|
63
|
+
const { fields, files } = splitForm(await result.formData());
|
|
64
|
+
req.body = fields;
|
|
65
|
+
req.files = files;
|
|
66
|
+
}
|
|
67
|
+
return true;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
//# sourceMappingURL=nestjs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"nestjs.js","sourceRoot":"","sources":["../src/nestjs.ts"],"names":[],"mappings":"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"}
|
package/dist/node.d.ts
ADDED
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/** Helpers shared by the Node-based adapters (Express, Fastify, NestJS). Internal. */
|
|
2
|
+
import type { ShieldRequest } from './index.js';
|
|
3
|
+
/** Read a Node request stream into bytes, stopping once `limit` is exceeded. */
|
|
4
|
+
export declare function readStream(stream: AsyncIterable<Uint8Array>, limit: number): Promise<Uint8Array>;
|
|
5
|
+
export declare function toShieldRequest(method: string, pathWithQuery: string, nodeHeaders: Record<string, string | string[] | undefined>, body: Uint8Array): ShieldRequest;
|
|
6
|
+
export declare function copyToArrayBuffer(bytes: Uint8Array): ArrayBuffer;
|
|
7
|
+
export declare function isFormContentType(contentType: string): boolean;
|
|
8
|
+
/** Split FormData into plain fields and web File objects; repeated names become arrays. */
|
|
9
|
+
export declare function splitForm(form: FormData): {
|
|
10
|
+
fields: Record<string, string | string[]>;
|
|
11
|
+
files: Record<string, File | File[]>;
|
|
12
|
+
};
|
|
13
|
+
/**
|
|
14
|
+
* Decode a verified body the way handlers expect: JSON → object, forms/uploads → fields + files, else text.
|
|
15
|
+
* Returns undefined body for an empty request.
|
|
16
|
+
*/
|
|
17
|
+
export declare function decodeBody(bytes: Uint8Array, contentType: string, formData: () => Promise<FormData>): Promise<{
|
|
18
|
+
body: unknown;
|
|
19
|
+
files?: Record<string, File | File[]>;
|
|
20
|
+
}>;
|
|
21
|
+
export declare function toNodeBuffer(bytes: Uint8Array): Uint8Array;
|
|
22
|
+
//# sourceMappingURL=node.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,gFAAgF;AAChF,wBAAsB,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAgBtG;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EAC1D,IAAI,EAAE,UAAU,GACf,aAAa,CAaf;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAIhE;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,CAAC,CAAA;CAAE,CAS7H;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,GAChC,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CASnE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAG1D"}
|
package/dist/node.js
ADDED
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
/* eslint-disable @typescript-eslint/no-explicit-any */
|
|
2
|
+
/** Read a Node request stream into bytes, stopping once `limit` is exceeded. */
|
|
3
|
+
export async function readStream(stream, limit) {
|
|
4
|
+
const chunks = [];
|
|
5
|
+
let size = 0;
|
|
6
|
+
for await (const chunk of stream) {
|
|
7
|
+
size += chunk.length;
|
|
8
|
+
if (size > limit)
|
|
9
|
+
break;
|
|
10
|
+
chunks.push(chunk);
|
|
11
|
+
}
|
|
12
|
+
const out = new Uint8Array(size > limit ? limit + 1 : size);
|
|
13
|
+
let offset = 0;
|
|
14
|
+
for (const c of chunks) {
|
|
15
|
+
out.set(c.subarray(0, out.length - offset), offset);
|
|
16
|
+
offset += c.length;
|
|
17
|
+
if (offset >= out.length)
|
|
18
|
+
break;
|
|
19
|
+
}
|
|
20
|
+
return out;
|
|
21
|
+
}
|
|
22
|
+
export function toShieldRequest(method, pathWithQuery, nodeHeaders, body) {
|
|
23
|
+
const headers = new Headers();
|
|
24
|
+
for (const [k, v] of Object.entries(nodeHeaders)) {
|
|
25
|
+
if (v !== undefined)
|
|
26
|
+
headers.set(k, Array.isArray(v) ? v.join(', ') : v);
|
|
27
|
+
}
|
|
28
|
+
return {
|
|
29
|
+
method,
|
|
30
|
+
url: `http://${headers.get('host') ?? 'localhost'}${pathWithQuery}`,
|
|
31
|
+
headers,
|
|
32
|
+
// Copy into a fresh ArrayBuffer. Node Buffers are often views into a shared memory pool, and
|
|
33
|
+
// Buffer#slice does NOT copy, so `.slice().buffer` would expose the whole pool.
|
|
34
|
+
arrayBuffer: async () => copyToArrayBuffer(body),
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
export function copyToArrayBuffer(bytes) {
|
|
38
|
+
const out = new Uint8Array(bytes.byteLength);
|
|
39
|
+
out.set(bytes);
|
|
40
|
+
return out.buffer;
|
|
41
|
+
}
|
|
42
|
+
export function isFormContentType(contentType) {
|
|
43
|
+
return /^multipart\/form-data|^application\/x-www-form-urlencoded/i.test(contentType);
|
|
44
|
+
}
|
|
45
|
+
/** Split FormData into plain fields and web File objects; repeated names become arrays. */
|
|
46
|
+
export function splitForm(form) {
|
|
47
|
+
const fields = {};
|
|
48
|
+
const files = {};
|
|
49
|
+
for (const [name, value] of form.entries()) {
|
|
50
|
+
const bucket = typeof value === 'string' ? fields : files;
|
|
51
|
+
const prev = bucket[name];
|
|
52
|
+
bucket[name] = prev === undefined ? value : Array.isArray(prev) ? [...prev, value] : [prev, value];
|
|
53
|
+
}
|
|
54
|
+
return { fields, files };
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* Decode a verified body the way handlers expect: JSON → object, forms/uploads → fields + files, else text.
|
|
58
|
+
* Returns undefined body for an empty request.
|
|
59
|
+
*/
|
|
60
|
+
export async function decodeBody(bytes, contentType, formData) {
|
|
61
|
+
if (!bytes.length)
|
|
62
|
+
return { body: undefined };
|
|
63
|
+
if (isFormContentType(contentType)) {
|
|
64
|
+
const { fields, files } = splitForm(await formData());
|
|
65
|
+
return { body: fields, files };
|
|
66
|
+
}
|
|
67
|
+
const text = new TextDecoder().decode(bytes);
|
|
68
|
+
if (/json/i.test(contentType))
|
|
69
|
+
return { body: JSON.parse(text) };
|
|
70
|
+
return { body: text };
|
|
71
|
+
}
|
|
72
|
+
export function toNodeBuffer(bytes) {
|
|
73
|
+
const B = globalThis.Buffer;
|
|
74
|
+
return B ? B.from(bytes) : bytes;
|
|
75
|
+
}
|
|
76
|
+
//# sourceMappingURL=node.js.map
|
package/dist/node.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"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"}
|
package/dist/redis.d.ts
ADDED
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Redis-backed ShieldStore, so every server instance shares sessions and used nonces.
|
|
3
|
+
*
|
|
4
|
+
* // node-redis (`redis` package, v4+)
|
|
5
|
+
* import { createClient } from 'redis';
|
|
6
|
+
* const redis = await createClient({ url }).connect();
|
|
7
|
+
* createShieldServer({ store: new RedisShieldStore(nodeRedis(redis)), ... });
|
|
8
|
+
*
|
|
9
|
+
* // ioredis
|
|
10
|
+
* import Redis from 'ioredis';
|
|
11
|
+
* createShieldServer({ store: new RedisShieldStore(ioredis(new Redis(url))), ... });
|
|
12
|
+
*/
|
|
13
|
+
import type { ShieldStore, StoredSession } from './index.js';
|
|
14
|
+
/** The two Redis operations the store needs. Use nodeRedis() / ioredis(), or implement for another client. */
|
|
15
|
+
export interface RedisCommands {
|
|
16
|
+
get(key: string): Promise<string | null>;
|
|
17
|
+
/** SET key value PX ttlMs [NX]; resolve true if the value was written. */
|
|
18
|
+
set(key: string, value: string, ttlMs: number, onlyIfAbsent: boolean): Promise<boolean>;
|
|
19
|
+
}
|
|
20
|
+
export declare function nodeRedis(client: any): RedisCommands;
|
|
21
|
+
export declare function ioredis(client: any): RedisCommands;
|
|
22
|
+
export declare class RedisShieldStore implements ShieldStore {
|
|
23
|
+
private readonly redis;
|
|
24
|
+
private readonly prefix;
|
|
25
|
+
constructor(redis: RedisCommands, prefix?: string);
|
|
26
|
+
saveSession(session: StoredSession, ttlMs: number): Promise<void>;
|
|
27
|
+
getSession(id: string): Promise<StoredSession | null>;
|
|
28
|
+
useNonce(sessionId: string, nonce: string, ttlMs: number): Promise<boolean>;
|
|
29
|
+
}
|
|
30
|
+
//# sourceMappingURL=redis.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../src/redis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D,8GAA8G;AAC9G,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,0EAA0E;IAC1E,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzF;AAGD,wBAAgB,SAAS,CAAC,MAAM,EAAE,GAAG,GAAG,aAAa,CAMpD;AAED,wBAAgB,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,aAAa,CAMlD;AAGD,qBAAa,gBAAiB,YAAW,WAAW;IAEhD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,KAAK,EAAE,aAAa,EACpB,MAAM,SAAY;IAG/B,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAK3D,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG5E"}
|
package/dist/redis.js
ADDED
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
/* eslint-disable @typescript-eslint/no-explicit-any */
|
|
2
|
+
export function nodeRedis(client) {
|
|
3
|
+
return {
|
|
4
|
+
get: (key) => client.get(key),
|
|
5
|
+
set: async (key, value, ttlMs, nx) => (await client.set(key, value, nx ? { PX: ttlMs, NX: true } : { PX: ttlMs })) === 'OK',
|
|
6
|
+
};
|
|
7
|
+
}
|
|
8
|
+
export function ioredis(client) {
|
|
9
|
+
return {
|
|
10
|
+
get: (key) => client.get(key),
|
|
11
|
+
set: async (key, value, ttlMs, nx) => (await (nx ? client.set(key, value, 'PX', ttlMs, 'NX') : client.set(key, value, 'PX', ttlMs))) === 'OK',
|
|
12
|
+
};
|
|
13
|
+
}
|
|
14
|
+
/* eslint-enable @typescript-eslint/no-explicit-any */
|
|
15
|
+
export class RedisShieldStore {
|
|
16
|
+
redis;
|
|
17
|
+
prefix;
|
|
18
|
+
constructor(redis, prefix = 'shield:') {
|
|
19
|
+
this.redis = redis;
|
|
20
|
+
this.prefix = prefix;
|
|
21
|
+
}
|
|
22
|
+
async saveSession(session, ttlMs) {
|
|
23
|
+
await this.redis.set(`${this.prefix}s:${session.id}`, JSON.stringify(session), Math.max(1, Math.ceil(ttlMs)), false);
|
|
24
|
+
}
|
|
25
|
+
async getSession(id) {
|
|
26
|
+
const raw = await this.redis.get(`${this.prefix}s:${id}`);
|
|
27
|
+
return raw ? JSON.parse(raw) : null;
|
|
28
|
+
}
|
|
29
|
+
useNonce(sessionId, nonce, ttlMs) {
|
|
30
|
+
return this.redis.set(`${this.prefix}n:${sessionId}:${nonce}`, '1', Math.max(1, Math.ceil(ttlMs)), true);
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=redis.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"redis.js","sourceRoot":"","sources":["../src/redis.ts"],"names":[],"mappings":"AAqBA,uDAAuD;AACvD,MAAM,UAAU,SAAS,CAAC,MAAW;IACnC,OAAO;QACL,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QAC7B,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CACnC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI;KACxF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,MAAW;IACjC,OAAO;QACL,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QAC7B,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CACnC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;KAC1G,CAAC;AACJ,CAAC;AACD,sDAAsD;AAEtD,MAAM,OAAO,gBAAgB;IAER;IACA;IAFnB,YACmB,KAAoB,EACpB,SAAS,SAAS;QADlB,UAAK,GAAL,KAAK,CAAe;QACpB,WAAM,GAAN,MAAM,CAAY;IAClC,CAAC;IAEJ,KAAK,CAAC,WAAW,CAAC,OAAsB,EAAE,KAAa;QACrD,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACvH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1D,OAAO,GAAG,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,CAAC;IAED,QAAQ,CAAC,SAAiB,EAAE,KAAa,EAAE,KAAa;QACtD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC3G,CAAC;CACF"}
|