@particle-academy/fancy-service-token 0.0.0 → 0.1.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/dist/index.cjs +194 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +95 -0
- package/dist/index.d.ts +95 -0
- package/dist/index.js +187 -0
- package/dist/index.js.map +1 -0
- package/package.json +1 -1
package/dist/index.cjs
ADDED
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
'use strict';
|
|
2
|
+
|
|
3
|
+
var crypto = require('crypto');
|
|
4
|
+
var async_hooks = require('async_hooks');
|
|
5
|
+
|
|
6
|
+
// src/verifier.ts
|
|
7
|
+
var PREFIX = "fst1";
|
|
8
|
+
var SIGNATURE_CHARS = 43;
|
|
9
|
+
var REASONS = [
|
|
10
|
+
"missing",
|
|
11
|
+
"malformed",
|
|
12
|
+
"bad_signature",
|
|
13
|
+
"expired",
|
|
14
|
+
"not_yet_valid",
|
|
15
|
+
"wrong_audience",
|
|
16
|
+
"replayed"
|
|
17
|
+
];
|
|
18
|
+
var MemoryReplayStore = class {
|
|
19
|
+
constructor(maxEntries = 1e5) {
|
|
20
|
+
this.maxEntries = maxEntries;
|
|
21
|
+
this.seen = /* @__PURE__ */ new Map();
|
|
22
|
+
if (!Number.isInteger(maxEntries) || maxEntries < 1) throw new RangeError("maxEntries must be at least 1");
|
|
23
|
+
}
|
|
24
|
+
add(key, expiresAt, now) {
|
|
25
|
+
const held = this.seen.get(key);
|
|
26
|
+
if (held !== void 0 && held > now) return false;
|
|
27
|
+
if (this.seen.size >= this.maxEntries) {
|
|
28
|
+
for (const [k, v] of this.seen) if (v <= now) this.seen.delete(k);
|
|
29
|
+
if (this.seen.size >= this.maxEntries) return false;
|
|
30
|
+
}
|
|
31
|
+
this.seen.set(key, expiresAt);
|
|
32
|
+
return true;
|
|
33
|
+
}
|
|
34
|
+
};
|
|
35
|
+
var B64URL = /^[A-Za-z0-9_-]*$/;
|
|
36
|
+
var charset = (extra) => new Set("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789" + extra);
|
|
37
|
+
var KID = charset("._-");
|
|
38
|
+
var NAME = charset("._:/-");
|
|
39
|
+
var RID = charset("._:-");
|
|
40
|
+
var NONCE = charset("_-");
|
|
41
|
+
var DIGITS = new Set("0123456789");
|
|
42
|
+
function only(value, chars, min, max) {
|
|
43
|
+
if (value.length < min || value.length > max) return false;
|
|
44
|
+
for (const c of value) if (!chars.has(c)) return false;
|
|
45
|
+
return true;
|
|
46
|
+
}
|
|
47
|
+
function time(value) {
|
|
48
|
+
if (!only(value, DIGITS, 1, 12) || value[0] === "0") return null;
|
|
49
|
+
return Number(value);
|
|
50
|
+
}
|
|
51
|
+
function b64decode(text) {
|
|
52
|
+
if (text.length === 0 || text.length % 4 === 1 || !B64URL.test(text)) return null;
|
|
53
|
+
const raw = Buffer.from(text, "base64url");
|
|
54
|
+
if (raw.toString("base64url") !== text) return null;
|
|
55
|
+
return raw;
|
|
56
|
+
}
|
|
57
|
+
var no = (reason) => ({ ok: false, reason });
|
|
58
|
+
var Verifier = class {
|
|
59
|
+
constructor(options) {
|
|
60
|
+
const { clockSkew = 10, maxLifetime = 300, maxTokenBytes = 1024, minKeyBytes = 32 } = options;
|
|
61
|
+
for (const [label, value] of [
|
|
62
|
+
["clockSkew", clockSkew],
|
|
63
|
+
["maxLifetime", maxLifetime],
|
|
64
|
+
["maxTokenBytes", maxTokenBytes]
|
|
65
|
+
]) {
|
|
66
|
+
if (!Number.isInteger(value) || value < 0) throw new RangeError(`${label} must be a non-negative integer`);
|
|
67
|
+
}
|
|
68
|
+
if (!options.keys || options.keys.length === 0) throw new Error("at least one key is required");
|
|
69
|
+
if (!only(options.audience, NAME, 1, 128) || !only(options.issuer, NAME, 1, 128)) {
|
|
70
|
+
throw new Error("audience and issuer must be 1-128 chars of [A-Za-z0-9._:/-]");
|
|
71
|
+
}
|
|
72
|
+
this.keys = /* @__PURE__ */ new Map();
|
|
73
|
+
for (const key of options.keys) {
|
|
74
|
+
if (!only(key.kid, KID, 1, 64)) throw new Error("a key id must be 1-64 chars of [A-Za-z0-9._-]");
|
|
75
|
+
if (this.keys.has(key.kid)) throw new Error(`duplicate key id "${key.kid}"`);
|
|
76
|
+
if (!(key.secret instanceof Uint8Array) || key.secret.length < minKeyBytes) {
|
|
77
|
+
throw new Error(`key "${key.kid}" is shorter than ${minKeyBytes} bytes`);
|
|
78
|
+
}
|
|
79
|
+
this.keys.set(key.kid, key);
|
|
80
|
+
}
|
|
81
|
+
this.audience = options.audience;
|
|
82
|
+
this.issuer = options.issuer;
|
|
83
|
+
this.clockSkew = clockSkew;
|
|
84
|
+
this.maxLifetime = maxLifetime;
|
|
85
|
+
this.maxTokenBytes = maxTokenBytes;
|
|
86
|
+
this.requireNonce = options.requireNonce ?? true;
|
|
87
|
+
this.replayStore = options.replayStore === void 0 ? new MemoryReplayStore() : options.replayStore;
|
|
88
|
+
this.clock = options.clock ?? Date.now;
|
|
89
|
+
}
|
|
90
|
+
/** Never throws for any input: an unexpected failure is a `malformed` refusal. */
|
|
91
|
+
verify(token, now) {
|
|
92
|
+
try {
|
|
93
|
+
return this.check(token, now ?? Math.floor(this.clock() / 1e3));
|
|
94
|
+
} catch {
|
|
95
|
+
return no("malformed");
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
check(input, now) {
|
|
99
|
+
if (input === null || input === void 0 || input === "") return no("missing");
|
|
100
|
+
let token;
|
|
101
|
+
if (typeof input === "string") token = input;
|
|
102
|
+
else if (input instanceof Uint8Array) {
|
|
103
|
+
if (input.length === 0) return no("missing");
|
|
104
|
+
for (const b of input) if (b > 127) return no("malformed");
|
|
105
|
+
token = Buffer.from(input).toString("latin1");
|
|
106
|
+
} else return no("malformed");
|
|
107
|
+
if (token.length > this.maxTokenBytes) return no("malformed");
|
|
108
|
+
const parts = token.split(".");
|
|
109
|
+
if (parts.length !== 3 || parts[0] !== PREFIX || parts[2].length !== SIGNATURE_CHARS) return no("malformed");
|
|
110
|
+
const signature = b64decode(parts[2]);
|
|
111
|
+
const raw = b64decode(parts[1]);
|
|
112
|
+
if (!signature || !raw || signature.length !== 32) return no("malformed");
|
|
113
|
+
for (const b of raw) if (b > 127) return no("malformed");
|
|
114
|
+
const fields = raw.toString("latin1").split("\n");
|
|
115
|
+
if (fields.length !== 7) return no("malformed");
|
|
116
|
+
const [kid, iss, aud, iatS, expS, rid, nonce] = fields;
|
|
117
|
+
const iat = time(iatS);
|
|
118
|
+
const exp = time(expS);
|
|
119
|
+
if (!only(kid, KID, 1, 64) || !only(iss, NAME, 1, 128) || !only(aud, NAME, 1, 128) || !only(rid, RID, 1, 128) || iat === null || exp === null || exp <= iat || exp - iat > this.maxLifetime) {
|
|
120
|
+
return no("malformed");
|
|
121
|
+
}
|
|
122
|
+
if (nonce !== "") {
|
|
123
|
+
if (!only(nonce, NONCE, 16, 128)) return no("malformed");
|
|
124
|
+
} else if (this.requireNonce) return no("malformed");
|
|
125
|
+
const key = this.keys.get(kid);
|
|
126
|
+
const expected = crypto.createHmac("sha256", key ? key.secret : Buffer.alloc(32)).update(PREFIX + "." + parts[1], "latin1").digest();
|
|
127
|
+
if (!crypto.timingSafeEqual(expected, signature) || !key) return no("bad_signature");
|
|
128
|
+
if (key.acceptUntil !== void 0 && key.acceptUntil !== null && now > key.acceptUntil) return no("bad_signature");
|
|
129
|
+
if (iss !== this.issuer) return no("bad_signature");
|
|
130
|
+
if (aud !== this.audience) return no("wrong_audience");
|
|
131
|
+
if (now + this.clockSkew < iat) return no("not_yet_valid");
|
|
132
|
+
if (now >= exp + this.clockSkew) return no("expired");
|
|
133
|
+
if (nonce !== "" && this.replayStore && !this.replayStore.add(iss + "\n" + nonce, exp + this.clockSkew, now)) {
|
|
134
|
+
return no("replayed");
|
|
135
|
+
}
|
|
136
|
+
return { ok: true, claims: { kid, issuer: iss, audience: aud, issuedAt: iat, expiresAt: exp, requestId: rid } };
|
|
137
|
+
}
|
|
138
|
+
};
|
|
139
|
+
var storage = new async_hooks.AsyncLocalStorage();
|
|
140
|
+
function currentRequestId() {
|
|
141
|
+
return storage.getStore();
|
|
142
|
+
}
|
|
143
|
+
function serviceTokenMiddleware(options) {
|
|
144
|
+
const header = (options.header ?? "x-fancy-service-token").toLowerCase();
|
|
145
|
+
const exempt = new Set(options.exemptPaths ?? []);
|
|
146
|
+
const log = options.log ?? (() => void 0);
|
|
147
|
+
return function serviceToken(req, res, next) {
|
|
148
|
+
const path = (req.url ?? "").split("?")[0];
|
|
149
|
+
if (exempt.has(path)) {
|
|
150
|
+
next();
|
|
151
|
+
return;
|
|
152
|
+
}
|
|
153
|
+
let reason;
|
|
154
|
+
let claims;
|
|
155
|
+
const distinct = req.headersDistinct?.[header];
|
|
156
|
+
if (distinct && distinct.length > 1) {
|
|
157
|
+
reason = "malformed";
|
|
158
|
+
} else {
|
|
159
|
+
try {
|
|
160
|
+
const verdict = options.verifier.verify(distinct ? distinct[0] : req.headers[header]);
|
|
161
|
+
if (verdict.ok) claims = verdict.claims;
|
|
162
|
+
else reason = verdict.reason;
|
|
163
|
+
} catch (err) {
|
|
164
|
+
log({ level: "error", message: "service token verifier threw; refusing", errorClass: err?.constructor?.name ?? "unknown" });
|
|
165
|
+
reason = "malformed";
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
if (!claims) {
|
|
169
|
+
const refused = reason ?? "malformed";
|
|
170
|
+
log({ level: "warn", message: `service token refused: ${refused}`, reason: refused });
|
|
171
|
+
const body = JSON.stringify({ error: "service_token_refused", reason: refused });
|
|
172
|
+
res.statusCode = 401;
|
|
173
|
+
res.setHeader("content-type", "application/json");
|
|
174
|
+
res.setHeader("content-length", String(Buffer.byteLength(body)));
|
|
175
|
+
res.setHeader("cache-control", "no-store");
|
|
176
|
+
res.setHeader("www-authenticate", `FancyServiceToken error="${refused}"`);
|
|
177
|
+
res.setHeader("connection", "close");
|
|
178
|
+
res.end(body);
|
|
179
|
+
return;
|
|
180
|
+
}
|
|
181
|
+
req.serviceToken = claims;
|
|
182
|
+
log({ level: "debug", message: `service token accepted for request ${claims.requestId}`, requestId: claims.requestId });
|
|
183
|
+
storage.run(claims.requestId, () => next());
|
|
184
|
+
};
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
exports.MemoryReplayStore = MemoryReplayStore;
|
|
188
|
+
exports.PREFIX = PREFIX;
|
|
189
|
+
exports.REASONS = REASONS;
|
|
190
|
+
exports.Verifier = Verifier;
|
|
191
|
+
exports.currentRequestId = currentRequestId;
|
|
192
|
+
exports.serviceTokenMiddleware = serviceTokenMiddleware;
|
|
193
|
+
//# sourceMappingURL=index.cjs.map
|
|
194
|
+
//# sourceMappingURL=index.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/verifier.ts","../src/middleware.ts"],"names":["createHmac","timingSafeEqual","AsyncLocalStorage"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * The verifier for `fst1` service tokens. node:crypto only: createHmac and\n * timingSafeEqual. No JWT library and no cryptography of our own.\n *\n * The format and the ORDER of the checks are defined in the README and pinned\n * by the shared fixtures; the order decides which reason a token that is wrong\n * in two ways is refused with, so the PHP and Python legs follow it exactly.\n */\nimport { createHmac, timingSafeEqual } from \"node:crypto\";\n\nexport const PREFIX = \"fst1\";\nconst SIGNATURE_CHARS = 43;\n\nexport const REASONS = [\n \"missing\",\n \"malformed\",\n \"bad_signature\",\n \"expired\",\n \"not_yet_valid\",\n \"wrong_audience\",\n \"replayed\",\n] as const;\nexport type Reason = (typeof REASONS)[number];\n\nexport interface Key {\n kid: string;\n secret: Uint8Array;\n /** Unix seconds. Marks a PREVIOUS key, accepted until (and including) this second. */\n acceptUntil?: number | null;\n}\n\n/** The verified contents of a token. Never holds the token, the nonce or a secret. */\nexport interface Claims {\n kid: string;\n issuer: string;\n audience: string;\n issuedAt: number;\n expiresAt: number;\n requestId: string;\n}\n\nexport type Verdict = { ok: true; claims: Claims } | { ok: false; reason: Reason };\n\nexport interface ReplayStore {\n /** Record `key` until `expiresAt`. True if it was new; false if already held (or refused). */\n add(key: string, expiresAt: number, now: number): boolean;\n}\n\n/**\n * Per-process nonce memory. Fails CLOSED when full: a nonce it cannot record is\n * refused. Several processes behind one port need a shared store.\n */\nexport class MemoryReplayStore implements ReplayStore {\n private seen = new Map<string, number>();\n\n constructor(readonly maxEntries = 100_000) {\n if (!Number.isInteger(maxEntries) || maxEntries < 1) throw new RangeError(\"maxEntries must be at least 1\");\n }\n\n add(key: string, expiresAt: number, now: number): boolean {\n const held = this.seen.get(key);\n if (held !== undefined && held > now) return false;\n if (this.seen.size >= this.maxEntries) {\n for (const [k, v] of this.seen) if (v <= now) this.seen.delete(k);\n if (this.seen.size >= this.maxEntries) return false;\n }\n this.seen.set(key, expiresAt);\n return true;\n }\n}\n\nexport interface VerifierOptions {\n keys: Key[];\n audience: string;\n issuer: string;\n clockSkew?: number;\n maxLifetime?: number;\n maxTokenBytes?: number;\n requireNonce?: boolean;\n minKeyBytes?: number;\n /** `null` turns replay checks off. Default: a new MemoryReplayStore. */\n replayStore?: ReplayStore | null;\n /** Milliseconds, like Date.now. */\n clock?: () => number;\n}\n\nconst B64URL = /^[A-Za-z0-9_-]*$/;\nconst charset = (extra: string) => new Set(\"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789\" + extra);\nconst KID = charset(\"._-\");\nconst NAME = charset(\"._:/-\");\nconst RID = charset(\"._:-\");\nconst NONCE = charset(\"_-\");\nconst DIGITS = new Set(\"0123456789\");\n\nfunction only(value: string, chars: Set<string>, min: number, max: number): boolean {\n if (value.length < min || value.length > max) return false;\n for (const c of value) if (!chars.has(c)) return false;\n return true;\n}\n\nfunction time(value: string): number | null {\n if (!only(value, DIGITS, 1, 12) || value[0] === \"0\") return null;\n return Number(value);\n}\n\n/** Strict unpadded base64url: right alphabet, right length, and the ONE canonical spelling. */\nfunction b64decode(text: string): Buffer | null {\n if (text.length === 0 || text.length % 4 === 1 || !B64URL.test(text)) return null;\n const raw = Buffer.from(text, \"base64url\");\n if (raw.toString(\"base64url\") !== text) return null;\n return raw;\n}\n\nconst no = (reason: Reason): Verdict => ({ ok: false, reason });\n\nexport class Verifier {\n readonly audience: string;\n readonly issuer: string;\n readonly clockSkew: number;\n readonly maxLifetime: number;\n readonly maxTokenBytes: number;\n readonly requireNonce: boolean;\n readonly replayStore: ReplayStore | null;\n private readonly keys: Map<string, Key>;\n private readonly clock: () => number;\n\n constructor(options: VerifierOptions) {\n const { clockSkew = 10, maxLifetime = 300, maxTokenBytes = 1024, minKeyBytes = 32 } = options;\n for (const [label, value] of [\n [\"clockSkew\", clockSkew],\n [\"maxLifetime\", maxLifetime],\n [\"maxTokenBytes\", maxTokenBytes],\n ] as const) {\n if (!Number.isInteger(value) || value < 0) throw new RangeError(`${label} must be a non-negative integer`);\n }\n if (!options.keys || options.keys.length === 0) throw new Error(\"at least one key is required\");\n if (!only(options.audience, NAME, 1, 128) || !only(options.issuer, NAME, 1, 128)) {\n throw new Error(\"audience and issuer must be 1-128 chars of [A-Za-z0-9._:/-]\");\n }\n this.keys = new Map();\n for (const key of options.keys) {\n if (!only(key.kid, KID, 1, 64)) throw new Error(\"a key id must be 1-64 chars of [A-Za-z0-9._-]\");\n if (this.keys.has(key.kid)) throw new Error(`duplicate key id \"${key.kid}\"`);\n // Names the key, never its value.\n if (!(key.secret instanceof Uint8Array) || key.secret.length < minKeyBytes) {\n throw new Error(`key \"${key.kid}\" is shorter than ${minKeyBytes} bytes`);\n }\n this.keys.set(key.kid, key);\n }\n this.audience = options.audience;\n this.issuer = options.issuer;\n this.clockSkew = clockSkew;\n this.maxLifetime = maxLifetime;\n this.maxTokenBytes = maxTokenBytes;\n this.requireNonce = options.requireNonce ?? true;\n this.replayStore = options.replayStore === undefined ? new MemoryReplayStore() : options.replayStore;\n this.clock = options.clock ?? Date.now;\n }\n\n /** Never throws for any input: an unexpected failure is a `malformed` refusal. */\n verify(token: unknown, now?: number): Verdict {\n try {\n return this.check(token, now ?? Math.floor(this.clock() / 1000));\n } catch {\n return no(\"malformed\");\n }\n }\n\n private check(input: unknown, now: number): Verdict {\n // 1. Missing.\n if (input === null || input === undefined || input === \"\") return no(\"missing\");\n let token: string;\n if (typeof input === \"string\") token = input;\n else if (input instanceof Uint8Array) {\n if (input.length === 0) return no(\"missing\");\n for (const b of input) if (b > 0x7f) return no(\"malformed\");\n token = Buffer.from(input).toString(\"latin1\");\n } else return no(\"malformed\");\n\n // 2. Size, before any parsing.\n if (token.length > this.maxTokenBytes) return no(\"malformed\");\n\n // 3. Structure: exactly prefix . payload . signature, each canonical.\n const parts = token.split(\".\");\n if (parts.length !== 3 || parts[0] !== PREFIX || parts[2]!.length !== SIGNATURE_CHARS) return no(\"malformed\");\n const signature = b64decode(parts[2]!);\n const raw = b64decode(parts[1]!);\n if (!signature || !raw || signature.length !== 32) return no(\"malformed\");\n\n // 4. Payload grammar: seven LF-separated ASCII fields.\n for (const b of raw) if (b > 0x7f) return no(\"malformed\");\n const fields = raw.toString(\"latin1\").split(\"\\n\");\n if (fields.length !== 7) return no(\"malformed\");\n const [kid, iss, aud, iatS, expS, rid, nonce] = fields as [string, string, string, string, string, string, string];\n const iat = time(iatS);\n const exp = time(expS);\n if (\n !only(kid, KID, 1, 64) ||\n !only(iss, NAME, 1, 128) ||\n !only(aud, NAME, 1, 128) ||\n !only(rid, RID, 1, 128) ||\n iat === null ||\n exp === null ||\n exp <= iat ||\n exp - iat > this.maxLifetime\n ) {\n return no(\"malformed\");\n }\n if (nonce !== \"\") {\n if (!only(nonce, NONCE, 16, 128)) return no(\"malformed\");\n } else if (this.requireNonce) return no(\"malformed\");\n\n // 5. Signature. An unknown kid, a retired key past its grace window and\n // another issuer are all \"not signed by a key we hold for this issuer\".\n const key = this.keys.get(kid);\n const expected = createHmac(\"sha256\", key ? key.secret : Buffer.alloc(32))\n .update(PREFIX + \".\" + parts[1]!, \"latin1\")\n .digest();\n if (!timingSafeEqual(expected, signature) || !key) return no(\"bad_signature\");\n if (key.acceptUntil !== undefined && key.acceptUntil !== null && now > key.acceptUntil) return no(\"bad_signature\");\n if (iss !== this.issuer) return no(\"bad_signature\");\n\n // 6. Audience, 7. time window, 8. replay -- last, so only a token that is\n // otherwise acceptable can spend a nonce.\n if (aud !== this.audience) return no(\"wrong_audience\");\n if (now + this.clockSkew < iat) return no(\"not_yet_valid\");\n if (now >= exp + this.clockSkew) return no(\"expired\");\n if (nonce !== \"\" && this.replayStore && !this.replayStore.add(iss + \"\\n\" + nonce, exp + this.clockSkew, now)) {\n return no(\"replayed\");\n }\n\n return { ok: true, claims: { kid, issuer: iss, audience: aud, issuedAt: iat, expiresAt: exp, requestId: rid } };\n }\n}\n","/**\n * A connect-style `(req, res, next)` middleware: Express, Connect, Polka and a\n * bare node:http handler all take it. It decides from `req.headers` alone, so\n * on a refusal nothing ever reads, parses or buffers the request body, and the\n * handler is never called. Mount it BEFORE any body parser.\n */\nimport { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\n\nimport type { Claims, Reason, Verifier } from \"./verifier\";\n\nexport interface LogEvent {\n level: \"debug\" | \"warn\" | \"error\";\n message: string;\n reason?: Reason;\n requestId?: string;\n errorClass?: string;\n}\n\nexport interface MiddlewareOptions {\n verifier: Verifier;\n /** Header carrying the token. Case-insensitive. */\n header?: string;\n /** Exact paths (query string ignored) that skip verification, e.g. a health check. */\n exemptPaths?: Iterable<string>;\n /** Receives structured events. Never given a token, a nonce or a secret. */\n log?: (event: LogEvent) => void;\n}\n\nexport type ServiceTokenRequest = IncomingMessage & { serviceToken?: Claims };\n\nconst storage = new AsyncLocalStorage<string>();\n\n/** The VERIFIED request id of the request being handled, or undefined outside one. */\nexport function currentRequestId(): string | undefined {\n return storage.getStore();\n}\n\nexport function serviceTokenMiddleware(options: MiddlewareOptions) {\n const header = (options.header ?? \"x-fancy-service-token\").toLowerCase();\n const exempt = new Set(options.exemptPaths ?? []);\n const log = options.log ?? (() => undefined);\n\n return function serviceToken(req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void): void {\n const path = (req.url ?? \"\").split(\"?\")[0]!;\n if (exempt.has(path)) {\n next();\n return;\n }\n\n let reason: Reason | undefined;\n let claims: Claims | undefined;\n const distinct = req.headersDistinct?.[header];\n if (distinct && distinct.length > 1) {\n reason = \"malformed\";\n } else {\n try {\n const verdict = options.verifier.verify(distinct ? distinct[0] : req.headers[header]);\n if (verdict.ok) claims = verdict.claims;\n else reason = verdict.reason;\n } catch (err) {\n // Fail closed; record the class, never the message.\n log({ level: \"error\", message: \"service token verifier threw; refusing\", errorClass: (err as Error)?.constructor?.name ?? \"unknown\" });\n reason = \"malformed\";\n }\n }\n\n if (!claims) {\n const refused: Reason = reason ?? \"malformed\";\n log({ level: \"warn\", message: `service token refused: ${refused}`, reason: refused });\n const body = JSON.stringify({ error: \"service_token_refused\", reason: refused });\n res.statusCode = 401;\n res.setHeader(\"content-type\", \"application/json\");\n res.setHeader(\"content-length\", String(Buffer.byteLength(body)));\n res.setHeader(\"cache-control\", \"no-store\");\n res.setHeader(\"www-authenticate\", `FancyServiceToken error=\"${refused}\"`);\n // The unread body must not be parsed as a next request on this socket.\n res.setHeader(\"connection\", \"close\");\n res.end(body);\n return;\n }\n\n (req as ServiceTokenRequest).serviceToken = claims;\n log({ level: \"debug\", message: `service token accepted for request ${claims.requestId}`, requestId: claims.requestId });\n storage.run(claims.requestId, () => next());\n };\n}\n"]}
|
package/dist/index.d.cts
ADDED
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import { IncomingMessage, ServerResponse } from 'node:http';
|
|
2
|
+
|
|
3
|
+
declare const PREFIX = "fst1";
|
|
4
|
+
declare const REASONS: readonly ["missing", "malformed", "bad_signature", "expired", "not_yet_valid", "wrong_audience", "replayed"];
|
|
5
|
+
type Reason = (typeof REASONS)[number];
|
|
6
|
+
interface Key {
|
|
7
|
+
kid: string;
|
|
8
|
+
secret: Uint8Array;
|
|
9
|
+
/** Unix seconds. Marks a PREVIOUS key, accepted until (and including) this second. */
|
|
10
|
+
acceptUntil?: number | null;
|
|
11
|
+
}
|
|
12
|
+
/** The verified contents of a token. Never holds the token, the nonce or a secret. */
|
|
13
|
+
interface Claims {
|
|
14
|
+
kid: string;
|
|
15
|
+
issuer: string;
|
|
16
|
+
audience: string;
|
|
17
|
+
issuedAt: number;
|
|
18
|
+
expiresAt: number;
|
|
19
|
+
requestId: string;
|
|
20
|
+
}
|
|
21
|
+
type Verdict = {
|
|
22
|
+
ok: true;
|
|
23
|
+
claims: Claims;
|
|
24
|
+
} | {
|
|
25
|
+
ok: false;
|
|
26
|
+
reason: Reason;
|
|
27
|
+
};
|
|
28
|
+
interface ReplayStore {
|
|
29
|
+
/** Record `key` until `expiresAt`. True if it was new; false if already held (or refused). */
|
|
30
|
+
add(key: string, expiresAt: number, now: number): boolean;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Per-process nonce memory. Fails CLOSED when full: a nonce it cannot record is
|
|
34
|
+
* refused. Several processes behind one port need a shared store.
|
|
35
|
+
*/
|
|
36
|
+
declare class MemoryReplayStore implements ReplayStore {
|
|
37
|
+
readonly maxEntries: number;
|
|
38
|
+
private seen;
|
|
39
|
+
constructor(maxEntries?: number);
|
|
40
|
+
add(key: string, expiresAt: number, now: number): boolean;
|
|
41
|
+
}
|
|
42
|
+
interface VerifierOptions {
|
|
43
|
+
keys: Key[];
|
|
44
|
+
audience: string;
|
|
45
|
+
issuer: string;
|
|
46
|
+
clockSkew?: number;
|
|
47
|
+
maxLifetime?: number;
|
|
48
|
+
maxTokenBytes?: number;
|
|
49
|
+
requireNonce?: boolean;
|
|
50
|
+
minKeyBytes?: number;
|
|
51
|
+
/** `null` turns replay checks off. Default: a new MemoryReplayStore. */
|
|
52
|
+
replayStore?: ReplayStore | null;
|
|
53
|
+
/** Milliseconds, like Date.now. */
|
|
54
|
+
clock?: () => number;
|
|
55
|
+
}
|
|
56
|
+
declare class Verifier {
|
|
57
|
+
readonly audience: string;
|
|
58
|
+
readonly issuer: string;
|
|
59
|
+
readonly clockSkew: number;
|
|
60
|
+
readonly maxLifetime: number;
|
|
61
|
+
readonly maxTokenBytes: number;
|
|
62
|
+
readonly requireNonce: boolean;
|
|
63
|
+
readonly replayStore: ReplayStore | null;
|
|
64
|
+
private readonly keys;
|
|
65
|
+
private readonly clock;
|
|
66
|
+
constructor(options: VerifierOptions);
|
|
67
|
+
/** Never throws for any input: an unexpected failure is a `malformed` refusal. */
|
|
68
|
+
verify(token: unknown, now?: number): Verdict;
|
|
69
|
+
private check;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
interface LogEvent {
|
|
73
|
+
level: "debug" | "warn" | "error";
|
|
74
|
+
message: string;
|
|
75
|
+
reason?: Reason;
|
|
76
|
+
requestId?: string;
|
|
77
|
+
errorClass?: string;
|
|
78
|
+
}
|
|
79
|
+
interface MiddlewareOptions {
|
|
80
|
+
verifier: Verifier;
|
|
81
|
+
/** Header carrying the token. Case-insensitive. */
|
|
82
|
+
header?: string;
|
|
83
|
+
/** Exact paths (query string ignored) that skip verification, e.g. a health check. */
|
|
84
|
+
exemptPaths?: Iterable<string>;
|
|
85
|
+
/** Receives structured events. Never given a token, a nonce or a secret. */
|
|
86
|
+
log?: (event: LogEvent) => void;
|
|
87
|
+
}
|
|
88
|
+
type ServiceTokenRequest = IncomingMessage & {
|
|
89
|
+
serviceToken?: Claims;
|
|
90
|
+
};
|
|
91
|
+
/** The VERIFIED request id of the request being handled, or undefined outside one. */
|
|
92
|
+
declare function currentRequestId(): string | undefined;
|
|
93
|
+
declare function serviceTokenMiddleware(options: MiddlewareOptions): (req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void) => void;
|
|
94
|
+
|
|
95
|
+
export { type Claims, type Key, type LogEvent, MemoryReplayStore, type MiddlewareOptions, PREFIX, REASONS, type Reason, type ReplayStore, type ServiceTokenRequest, type Verdict, Verifier, type VerifierOptions, currentRequestId, serviceTokenMiddleware };
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import { IncomingMessage, ServerResponse } from 'node:http';
|
|
2
|
+
|
|
3
|
+
declare const PREFIX = "fst1";
|
|
4
|
+
declare const REASONS: readonly ["missing", "malformed", "bad_signature", "expired", "not_yet_valid", "wrong_audience", "replayed"];
|
|
5
|
+
type Reason = (typeof REASONS)[number];
|
|
6
|
+
interface Key {
|
|
7
|
+
kid: string;
|
|
8
|
+
secret: Uint8Array;
|
|
9
|
+
/** Unix seconds. Marks a PREVIOUS key, accepted until (and including) this second. */
|
|
10
|
+
acceptUntil?: number | null;
|
|
11
|
+
}
|
|
12
|
+
/** The verified contents of a token. Never holds the token, the nonce or a secret. */
|
|
13
|
+
interface Claims {
|
|
14
|
+
kid: string;
|
|
15
|
+
issuer: string;
|
|
16
|
+
audience: string;
|
|
17
|
+
issuedAt: number;
|
|
18
|
+
expiresAt: number;
|
|
19
|
+
requestId: string;
|
|
20
|
+
}
|
|
21
|
+
type Verdict = {
|
|
22
|
+
ok: true;
|
|
23
|
+
claims: Claims;
|
|
24
|
+
} | {
|
|
25
|
+
ok: false;
|
|
26
|
+
reason: Reason;
|
|
27
|
+
};
|
|
28
|
+
interface ReplayStore {
|
|
29
|
+
/** Record `key` until `expiresAt`. True if it was new; false if already held (or refused). */
|
|
30
|
+
add(key: string, expiresAt: number, now: number): boolean;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Per-process nonce memory. Fails CLOSED when full: a nonce it cannot record is
|
|
34
|
+
* refused. Several processes behind one port need a shared store.
|
|
35
|
+
*/
|
|
36
|
+
declare class MemoryReplayStore implements ReplayStore {
|
|
37
|
+
readonly maxEntries: number;
|
|
38
|
+
private seen;
|
|
39
|
+
constructor(maxEntries?: number);
|
|
40
|
+
add(key: string, expiresAt: number, now: number): boolean;
|
|
41
|
+
}
|
|
42
|
+
interface VerifierOptions {
|
|
43
|
+
keys: Key[];
|
|
44
|
+
audience: string;
|
|
45
|
+
issuer: string;
|
|
46
|
+
clockSkew?: number;
|
|
47
|
+
maxLifetime?: number;
|
|
48
|
+
maxTokenBytes?: number;
|
|
49
|
+
requireNonce?: boolean;
|
|
50
|
+
minKeyBytes?: number;
|
|
51
|
+
/** `null` turns replay checks off. Default: a new MemoryReplayStore. */
|
|
52
|
+
replayStore?: ReplayStore | null;
|
|
53
|
+
/** Milliseconds, like Date.now. */
|
|
54
|
+
clock?: () => number;
|
|
55
|
+
}
|
|
56
|
+
declare class Verifier {
|
|
57
|
+
readonly audience: string;
|
|
58
|
+
readonly issuer: string;
|
|
59
|
+
readonly clockSkew: number;
|
|
60
|
+
readonly maxLifetime: number;
|
|
61
|
+
readonly maxTokenBytes: number;
|
|
62
|
+
readonly requireNonce: boolean;
|
|
63
|
+
readonly replayStore: ReplayStore | null;
|
|
64
|
+
private readonly keys;
|
|
65
|
+
private readonly clock;
|
|
66
|
+
constructor(options: VerifierOptions);
|
|
67
|
+
/** Never throws for any input: an unexpected failure is a `malformed` refusal. */
|
|
68
|
+
verify(token: unknown, now?: number): Verdict;
|
|
69
|
+
private check;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
interface LogEvent {
|
|
73
|
+
level: "debug" | "warn" | "error";
|
|
74
|
+
message: string;
|
|
75
|
+
reason?: Reason;
|
|
76
|
+
requestId?: string;
|
|
77
|
+
errorClass?: string;
|
|
78
|
+
}
|
|
79
|
+
interface MiddlewareOptions {
|
|
80
|
+
verifier: Verifier;
|
|
81
|
+
/** Header carrying the token. Case-insensitive. */
|
|
82
|
+
header?: string;
|
|
83
|
+
/** Exact paths (query string ignored) that skip verification, e.g. a health check. */
|
|
84
|
+
exemptPaths?: Iterable<string>;
|
|
85
|
+
/** Receives structured events. Never given a token, a nonce or a secret. */
|
|
86
|
+
log?: (event: LogEvent) => void;
|
|
87
|
+
}
|
|
88
|
+
type ServiceTokenRequest = IncomingMessage & {
|
|
89
|
+
serviceToken?: Claims;
|
|
90
|
+
};
|
|
91
|
+
/** The VERIFIED request id of the request being handled, or undefined outside one. */
|
|
92
|
+
declare function currentRequestId(): string | undefined;
|
|
93
|
+
declare function serviceTokenMiddleware(options: MiddlewareOptions): (req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void) => void;
|
|
94
|
+
|
|
95
|
+
export { type Claims, type Key, type LogEvent, MemoryReplayStore, type MiddlewareOptions, PREFIX, REASONS, type Reason, type ReplayStore, type ServiceTokenRequest, type Verdict, Verifier, type VerifierOptions, currentRequestId, serviceTokenMiddleware };
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,187 @@
|
|
|
1
|
+
import { createHmac, timingSafeEqual } from 'crypto';
|
|
2
|
+
import { AsyncLocalStorage } from 'async_hooks';
|
|
3
|
+
|
|
4
|
+
// src/verifier.ts
|
|
5
|
+
var PREFIX = "fst1";
|
|
6
|
+
var SIGNATURE_CHARS = 43;
|
|
7
|
+
var REASONS = [
|
|
8
|
+
"missing",
|
|
9
|
+
"malformed",
|
|
10
|
+
"bad_signature",
|
|
11
|
+
"expired",
|
|
12
|
+
"not_yet_valid",
|
|
13
|
+
"wrong_audience",
|
|
14
|
+
"replayed"
|
|
15
|
+
];
|
|
16
|
+
var MemoryReplayStore = class {
|
|
17
|
+
constructor(maxEntries = 1e5) {
|
|
18
|
+
this.maxEntries = maxEntries;
|
|
19
|
+
this.seen = /* @__PURE__ */ new Map();
|
|
20
|
+
if (!Number.isInteger(maxEntries) || maxEntries < 1) throw new RangeError("maxEntries must be at least 1");
|
|
21
|
+
}
|
|
22
|
+
add(key, expiresAt, now) {
|
|
23
|
+
const held = this.seen.get(key);
|
|
24
|
+
if (held !== void 0 && held > now) return false;
|
|
25
|
+
if (this.seen.size >= this.maxEntries) {
|
|
26
|
+
for (const [k, v] of this.seen) if (v <= now) this.seen.delete(k);
|
|
27
|
+
if (this.seen.size >= this.maxEntries) return false;
|
|
28
|
+
}
|
|
29
|
+
this.seen.set(key, expiresAt);
|
|
30
|
+
return true;
|
|
31
|
+
}
|
|
32
|
+
};
|
|
33
|
+
var B64URL = /^[A-Za-z0-9_-]*$/;
|
|
34
|
+
var charset = (extra) => new Set("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789" + extra);
|
|
35
|
+
var KID = charset("._-");
|
|
36
|
+
var NAME = charset("._:/-");
|
|
37
|
+
var RID = charset("._:-");
|
|
38
|
+
var NONCE = charset("_-");
|
|
39
|
+
var DIGITS = new Set("0123456789");
|
|
40
|
+
function only(value, chars, min, max) {
|
|
41
|
+
if (value.length < min || value.length > max) return false;
|
|
42
|
+
for (const c of value) if (!chars.has(c)) return false;
|
|
43
|
+
return true;
|
|
44
|
+
}
|
|
45
|
+
function time(value) {
|
|
46
|
+
if (!only(value, DIGITS, 1, 12) || value[0] === "0") return null;
|
|
47
|
+
return Number(value);
|
|
48
|
+
}
|
|
49
|
+
function b64decode(text) {
|
|
50
|
+
if (text.length === 0 || text.length % 4 === 1 || !B64URL.test(text)) return null;
|
|
51
|
+
const raw = Buffer.from(text, "base64url");
|
|
52
|
+
if (raw.toString("base64url") !== text) return null;
|
|
53
|
+
return raw;
|
|
54
|
+
}
|
|
55
|
+
var no = (reason) => ({ ok: false, reason });
|
|
56
|
+
var Verifier = class {
|
|
57
|
+
constructor(options) {
|
|
58
|
+
const { clockSkew = 10, maxLifetime = 300, maxTokenBytes = 1024, minKeyBytes = 32 } = options;
|
|
59
|
+
for (const [label, value] of [
|
|
60
|
+
["clockSkew", clockSkew],
|
|
61
|
+
["maxLifetime", maxLifetime],
|
|
62
|
+
["maxTokenBytes", maxTokenBytes]
|
|
63
|
+
]) {
|
|
64
|
+
if (!Number.isInteger(value) || value < 0) throw new RangeError(`${label} must be a non-negative integer`);
|
|
65
|
+
}
|
|
66
|
+
if (!options.keys || options.keys.length === 0) throw new Error("at least one key is required");
|
|
67
|
+
if (!only(options.audience, NAME, 1, 128) || !only(options.issuer, NAME, 1, 128)) {
|
|
68
|
+
throw new Error("audience and issuer must be 1-128 chars of [A-Za-z0-9._:/-]");
|
|
69
|
+
}
|
|
70
|
+
this.keys = /* @__PURE__ */ new Map();
|
|
71
|
+
for (const key of options.keys) {
|
|
72
|
+
if (!only(key.kid, KID, 1, 64)) throw new Error("a key id must be 1-64 chars of [A-Za-z0-9._-]");
|
|
73
|
+
if (this.keys.has(key.kid)) throw new Error(`duplicate key id "${key.kid}"`);
|
|
74
|
+
if (!(key.secret instanceof Uint8Array) || key.secret.length < minKeyBytes) {
|
|
75
|
+
throw new Error(`key "${key.kid}" is shorter than ${minKeyBytes} bytes`);
|
|
76
|
+
}
|
|
77
|
+
this.keys.set(key.kid, key);
|
|
78
|
+
}
|
|
79
|
+
this.audience = options.audience;
|
|
80
|
+
this.issuer = options.issuer;
|
|
81
|
+
this.clockSkew = clockSkew;
|
|
82
|
+
this.maxLifetime = maxLifetime;
|
|
83
|
+
this.maxTokenBytes = maxTokenBytes;
|
|
84
|
+
this.requireNonce = options.requireNonce ?? true;
|
|
85
|
+
this.replayStore = options.replayStore === void 0 ? new MemoryReplayStore() : options.replayStore;
|
|
86
|
+
this.clock = options.clock ?? Date.now;
|
|
87
|
+
}
|
|
88
|
+
/** Never throws for any input: an unexpected failure is a `malformed` refusal. */
|
|
89
|
+
verify(token, now) {
|
|
90
|
+
try {
|
|
91
|
+
return this.check(token, now ?? Math.floor(this.clock() / 1e3));
|
|
92
|
+
} catch {
|
|
93
|
+
return no("malformed");
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
check(input, now) {
|
|
97
|
+
if (input === null || input === void 0 || input === "") return no("missing");
|
|
98
|
+
let token;
|
|
99
|
+
if (typeof input === "string") token = input;
|
|
100
|
+
else if (input instanceof Uint8Array) {
|
|
101
|
+
if (input.length === 0) return no("missing");
|
|
102
|
+
for (const b of input) if (b > 127) return no("malformed");
|
|
103
|
+
token = Buffer.from(input).toString("latin1");
|
|
104
|
+
} else return no("malformed");
|
|
105
|
+
if (token.length > this.maxTokenBytes) return no("malformed");
|
|
106
|
+
const parts = token.split(".");
|
|
107
|
+
if (parts.length !== 3 || parts[0] !== PREFIX || parts[2].length !== SIGNATURE_CHARS) return no("malformed");
|
|
108
|
+
const signature = b64decode(parts[2]);
|
|
109
|
+
const raw = b64decode(parts[1]);
|
|
110
|
+
if (!signature || !raw || signature.length !== 32) return no("malformed");
|
|
111
|
+
for (const b of raw) if (b > 127) return no("malformed");
|
|
112
|
+
const fields = raw.toString("latin1").split("\n");
|
|
113
|
+
if (fields.length !== 7) return no("malformed");
|
|
114
|
+
const [kid, iss, aud, iatS, expS, rid, nonce] = fields;
|
|
115
|
+
const iat = time(iatS);
|
|
116
|
+
const exp = time(expS);
|
|
117
|
+
if (!only(kid, KID, 1, 64) || !only(iss, NAME, 1, 128) || !only(aud, NAME, 1, 128) || !only(rid, RID, 1, 128) || iat === null || exp === null || exp <= iat || exp - iat > this.maxLifetime) {
|
|
118
|
+
return no("malformed");
|
|
119
|
+
}
|
|
120
|
+
if (nonce !== "") {
|
|
121
|
+
if (!only(nonce, NONCE, 16, 128)) return no("malformed");
|
|
122
|
+
} else if (this.requireNonce) return no("malformed");
|
|
123
|
+
const key = this.keys.get(kid);
|
|
124
|
+
const expected = createHmac("sha256", key ? key.secret : Buffer.alloc(32)).update(PREFIX + "." + parts[1], "latin1").digest();
|
|
125
|
+
if (!timingSafeEqual(expected, signature) || !key) return no("bad_signature");
|
|
126
|
+
if (key.acceptUntil !== void 0 && key.acceptUntil !== null && now > key.acceptUntil) return no("bad_signature");
|
|
127
|
+
if (iss !== this.issuer) return no("bad_signature");
|
|
128
|
+
if (aud !== this.audience) return no("wrong_audience");
|
|
129
|
+
if (now + this.clockSkew < iat) return no("not_yet_valid");
|
|
130
|
+
if (now >= exp + this.clockSkew) return no("expired");
|
|
131
|
+
if (nonce !== "" && this.replayStore && !this.replayStore.add(iss + "\n" + nonce, exp + this.clockSkew, now)) {
|
|
132
|
+
return no("replayed");
|
|
133
|
+
}
|
|
134
|
+
return { ok: true, claims: { kid, issuer: iss, audience: aud, issuedAt: iat, expiresAt: exp, requestId: rid } };
|
|
135
|
+
}
|
|
136
|
+
};
|
|
137
|
+
var storage = new AsyncLocalStorage();
|
|
138
|
+
function currentRequestId() {
|
|
139
|
+
return storage.getStore();
|
|
140
|
+
}
|
|
141
|
+
function serviceTokenMiddleware(options) {
|
|
142
|
+
const header = (options.header ?? "x-fancy-service-token").toLowerCase();
|
|
143
|
+
const exempt = new Set(options.exemptPaths ?? []);
|
|
144
|
+
const log = options.log ?? (() => void 0);
|
|
145
|
+
return function serviceToken(req, res, next) {
|
|
146
|
+
const path = (req.url ?? "").split("?")[0];
|
|
147
|
+
if (exempt.has(path)) {
|
|
148
|
+
next();
|
|
149
|
+
return;
|
|
150
|
+
}
|
|
151
|
+
let reason;
|
|
152
|
+
let claims;
|
|
153
|
+
const distinct = req.headersDistinct?.[header];
|
|
154
|
+
if (distinct && distinct.length > 1) {
|
|
155
|
+
reason = "malformed";
|
|
156
|
+
} else {
|
|
157
|
+
try {
|
|
158
|
+
const verdict = options.verifier.verify(distinct ? distinct[0] : req.headers[header]);
|
|
159
|
+
if (verdict.ok) claims = verdict.claims;
|
|
160
|
+
else reason = verdict.reason;
|
|
161
|
+
} catch (err) {
|
|
162
|
+
log({ level: "error", message: "service token verifier threw; refusing", errorClass: err?.constructor?.name ?? "unknown" });
|
|
163
|
+
reason = "malformed";
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
if (!claims) {
|
|
167
|
+
const refused = reason ?? "malformed";
|
|
168
|
+
log({ level: "warn", message: `service token refused: ${refused}`, reason: refused });
|
|
169
|
+
const body = JSON.stringify({ error: "service_token_refused", reason: refused });
|
|
170
|
+
res.statusCode = 401;
|
|
171
|
+
res.setHeader("content-type", "application/json");
|
|
172
|
+
res.setHeader("content-length", String(Buffer.byteLength(body)));
|
|
173
|
+
res.setHeader("cache-control", "no-store");
|
|
174
|
+
res.setHeader("www-authenticate", `FancyServiceToken error="${refused}"`);
|
|
175
|
+
res.setHeader("connection", "close");
|
|
176
|
+
res.end(body);
|
|
177
|
+
return;
|
|
178
|
+
}
|
|
179
|
+
req.serviceToken = claims;
|
|
180
|
+
log({ level: "debug", message: `service token accepted for request ${claims.requestId}`, requestId: claims.requestId });
|
|
181
|
+
storage.run(claims.requestId, () => next());
|
|
182
|
+
};
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
export { MemoryReplayStore, PREFIX, REASONS, Verifier, currentRequestId, serviceTokenMiddleware };
|
|
186
|
+
//# sourceMappingURL=index.js.map
|
|
187
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/verifier.ts","../src/middleware.ts"],"names":[],"mappings":";;;;AAUO,IAAM,MAAA,GAAS;AACtB,IAAM,eAAA,GAAkB,EAAA;AAEjB,IAAM,OAAA,GAAU;AAAA,EACrB,SAAA;AAAA,EACA,WAAA;AAAA,EACA,eAAA;AAAA,EACA,SAAA;AAAA,EACA,eAAA;AAAA,EACA,gBAAA;AAAA,EACA;AACF;AA+BO,IAAM,oBAAN,MAA+C;AAAA,EAGpD,WAAA,CAAqB,aAAa,GAAA,EAAS;AAAtB,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAFrB,IAAA,IAAA,CAAQ,IAAA,uBAAW,GAAA,EAAoB;AAGrC,IAAA,IAAI,CAAC,MAAA,CAAO,SAAA,CAAU,UAAU,CAAA,IAAK,aAAa,CAAA,EAAG,MAAM,IAAI,UAAA,CAAW,+BAA+B,CAAA;AAAA,EAC3G;AAAA,EAEA,GAAA,CAAI,GAAA,EAAa,SAAA,EAAmB,GAAA,EAAsB;AACxD,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,GAAG,CAAA;AAC9B,IAAA,IAAI,IAAA,KAAS,MAAA,IAAa,IAAA,GAAO,GAAA,EAAK,OAAO,KAAA;AAC7C,IAAA,IAAI,IAAA,CAAK,IAAA,CAAK,IAAA,IAAQ,IAAA,CAAK,UAAA,EAAY;AACrC,MAAA,KAAA,MAAW,CAAC,CAAA,EAAG,CAAC,CAAA,IAAK,IAAA,CAAK,IAAA,EAAM,IAAI,CAAA,IAAK,GAAA,EAAK,IAAA,CAAK,IAAA,CAAK,MAAA,CAAO,CAAC,CAAA;AAChE,MAAA,IAAI,IAAA,CAAK,IAAA,CAAK,IAAA,IAAQ,IAAA,CAAK,YAAY,OAAO,KAAA;AAAA,IAChD;AACA,IAAA,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,SAAS,CAAA;AAC5B,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAiBA,IAAM,MAAA,GAAS,kBAAA;AACf,IAAM,UAAU,CAAC,KAAA,KAAkB,IAAI,GAAA,CAAI,mEAAmE,KAAK,CAAA;AACnH,IAAM,GAAA,GAAM,QAAQ,KAAK,CAAA;AACzB,IAAM,IAAA,GAAO,QAAQ,OAAO,CAAA;AAC5B,IAAM,GAAA,GAAM,QAAQ,MAAM,CAAA;AAC1B,IAAM,KAAA,GAAQ,QAAQ,IAAI,CAAA;AAC1B,IAAM,MAAA,GAAS,IAAI,GAAA,CAAI,YAAY,CAAA;AAEnC,SAAS,IAAA,CAAK,KAAA,EAAe,KAAA,EAAoB,GAAA,EAAa,GAAA,EAAsB;AAClF,EAAA,IAAI,MAAM,MAAA,GAAS,GAAA,IAAO,KAAA,CAAM,MAAA,GAAS,KAAK,OAAO,KAAA;AACrD,EAAA,KAAA,MAAW,CAAA,IAAK,OAAO,IAAI,CAAC,MAAM,GAAA,CAAI,CAAC,GAAG,OAAO,KAAA;AACjD,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,KAAK,KAAA,EAA8B;AAC1C,EAAA,IAAI,CAAC,IAAA,CAAK,KAAA,EAAO,MAAA,EAAQ,CAAA,EAAG,EAAE,CAAA,IAAK,KAAA,CAAM,CAAC,CAAA,KAAM,GAAA,EAAK,OAAO,IAAA;AAC5D,EAAA,OAAO,OAAO,KAAK,CAAA;AACrB;AAGA,SAAS,UAAU,IAAA,EAA6B;AAC9C,EAAA,IAAI,IAAA,CAAK,MAAA,KAAW,CAAA,IAAK,IAAA,CAAK,MAAA,GAAS,CAAA,KAAM,CAAA,IAAK,CAAC,MAAA,CAAO,IAAA,CAAK,IAAI,CAAA,EAAG,OAAO,IAAA;AAC7E,EAAA,MAAM,GAAA,GAAM,MAAA,CAAO,IAAA,CAAK,IAAA,EAAM,WAAW,CAAA;AACzC,EAAA,IAAI,GAAA,CAAI,QAAA,CAAS,WAAW,CAAA,KAAM,MAAM,OAAO,IAAA;AAC/C,EAAA,OAAO,GAAA;AACT;AAEA,IAAM,KAAK,CAAC,MAAA,MAA6B,EAAE,EAAA,EAAI,OAAO,MAAA,EAAO,CAAA;AAEtD,IAAM,WAAN,MAAe;AAAA,EAWpB,YAAY,OAAA,EAA0B;AACpC,IAAA,MAAM,EAAE,YAAY,EAAA,EAAI,WAAA,GAAc,KAAK,aAAA,GAAgB,IAAA,EAAM,WAAA,GAAc,EAAA,EAAG,GAAI,OAAA;AACtF,IAAA,KAAA,MAAW,CAAC,KAAA,EAAO,KAAK,CAAA,IAAK;AAAA,MAC3B,CAAC,aAAa,SAAS,CAAA;AAAA,MACvB,CAAC,eAAe,WAAW,CAAA;AAAA,MAC3B,CAAC,iBAAiB,aAAa;AAAA,KACjC,EAAY;AACV,MAAA,IAAI,CAAC,MAAA,CAAO,SAAA,CAAU,KAAK,CAAA,IAAK,KAAA,GAAQ,CAAA,EAAG,MAAM,IAAI,UAAA,CAAW,CAAA,EAAG,KAAK,CAAA,+BAAA,CAAiC,CAAA;AAAA,IAC3G;AACA,IAAA,IAAI,CAAC,OAAA,CAAQ,IAAA,IAAQ,OAAA,CAAQ,IAAA,CAAK,WAAW,CAAA,EAAG,MAAM,IAAI,KAAA,CAAM,8BAA8B,CAAA;AAC9F,IAAA,IAAI,CAAC,IAAA,CAAK,OAAA,CAAQ,QAAA,EAAU,MAAM,CAAA,EAAG,GAAG,CAAA,IAAK,CAAC,KAAK,OAAA,CAAQ,MAAA,EAAQ,IAAA,EAAM,CAAA,EAAG,GAAG,CAAA,EAAG;AAChF,MAAA,MAAM,IAAI,MAAM,6DAA6D,CAAA;AAAA,IAC/E;AACA,IAAA,IAAA,CAAK,IAAA,uBAAW,GAAA,EAAI;AACpB,IAAA,KAAA,MAAW,GAAA,IAAO,QAAQ,IAAA,EAAM;AAC9B,MAAA,IAAI,CAAC,IAAA,CAAK,GAAA,CAAI,GAAA,EAAK,GAAA,EAAK,CAAA,EAAG,EAAE,CAAA,EAAG,MAAM,IAAI,KAAA,CAAM,+CAA+C,CAAA;AAC/F,MAAA,IAAI,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,GAAA,CAAI,GAAG,CAAA,EAAG,MAAM,IAAI,KAAA,CAAM,CAAA,kBAAA,EAAqB,GAAA,CAAI,GAAG,CAAA,CAAA,CAAG,CAAA;AAE3E,MAAA,IAAI,EAAE,GAAA,CAAI,MAAA,YAAkB,eAAe,GAAA,CAAI,MAAA,CAAO,SAAS,WAAA,EAAa;AAC1E,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,KAAA,EAAQ,IAAI,GAAG,CAAA,kBAAA,EAAqB,WAAW,CAAA,MAAA,CAAQ,CAAA;AAAA,MACzE;AACA,MAAA,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,GAAA,CAAI,GAAA,EAAK,GAAG,CAAA;AAAA,IAC5B;AACA,IAAA,IAAA,CAAK,WAAW,OAAA,CAAQ,QAAA;AACxB,IAAA,IAAA,CAAK,SAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,SAAA,GAAY,SAAA;AACjB,IAAA,IAAA,CAAK,WAAA,GAAc,WAAA;AACnB,IAAA,IAAA,CAAK,aAAA,GAAgB,aAAA;AACrB,IAAA,IAAA,CAAK,YAAA,GAAe,QAAQ,YAAA,IAAgB,IAAA;AAC5C,IAAA,IAAA,CAAK,cAAc,OAAA,CAAQ,WAAA,KAAgB,SAAY,IAAI,iBAAA,KAAsB,OAAA,CAAQ,WAAA;AACzF,IAAA,IAAA,CAAK,KAAA,GAAQ,OAAA,CAAQ,KAAA,IAAS,IAAA,CAAK,GAAA;AAAA,EACrC;AAAA;AAAA,EAGA,MAAA,CAAO,OAAgB,GAAA,EAAuB;AAC5C,IAAA,IAAI;AACF,MAAA,OAAO,IAAA,CAAK,KAAA,CAAM,KAAA,EAAO,GAAA,IAAO,IAAA,CAAK,MAAM,IAAA,CAAK,KAAA,EAAM,GAAI,GAAI,CAAC,CAAA;AAAA,IACjE,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,GAAG,WAAW,CAAA;AAAA,IACvB;AAAA,EACF;AAAA,EAEQ,KAAA,CAAM,OAAgB,GAAA,EAAsB;AAElD,IAAA,IAAI,KAAA,KAAU,QAAQ,KAAA,KAAU,MAAA,IAAa,UAAU,EAAA,EAAI,OAAO,GAAG,SAAS,CAAA;AAC9E,IAAA,IAAI,KAAA;AACJ,IAAA,IAAI,OAAO,KAAA,KAAU,QAAA,EAAU,KAAA,GAAQ,KAAA;AAAA,SAAA,IAC9B,iBAAiB,UAAA,EAAY;AACpC,MAAA,IAAI,KAAA,CAAM,MAAA,KAAW,CAAA,EAAG,OAAO,GAAG,SAAS,CAAA;AAC3C,MAAA,KAAA,MAAW,KAAK,KAAA,EAAO,IAAI,IAAI,GAAA,EAAM,OAAO,GAAG,WAAW,CAAA;AAC1D,MAAA,KAAA,GAAQ,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,CAAE,SAAS,QAAQ,CAAA;AAAA,IAC9C,CAAA,MAAO,OAAO,EAAA,CAAG,WAAW,CAAA;AAG5B,IAAA,IAAI,MAAM,MAAA,GAAS,IAAA,CAAK,aAAA,EAAe,OAAO,GAAG,WAAW,CAAA;AAG5D,IAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,KAAA,CAAM,GAAG,CAAA;AAC7B,IAAA,IAAI,KAAA,CAAM,MAAA,KAAW,CAAA,IAAK,KAAA,CAAM,CAAC,CAAA,KAAM,MAAA,IAAU,KAAA,CAAM,CAAC,CAAA,CAAG,MAAA,KAAW,eAAA,EAAiB,OAAO,GAAG,WAAW,CAAA;AAC5G,IAAA,MAAM,SAAA,GAAY,SAAA,CAAU,KAAA,CAAM,CAAC,CAAE,CAAA;AACrC,IAAA,MAAM,GAAA,GAAM,SAAA,CAAU,KAAA,CAAM,CAAC,CAAE,CAAA;AAC/B,IAAA,IAAI,CAAC,aAAa,CAAC,GAAA,IAAO,UAAU,MAAA,KAAW,EAAA,EAAI,OAAO,EAAA,CAAG,WAAW,CAAA;AAGxE,IAAA,KAAA,MAAW,KAAK,GAAA,EAAK,IAAI,IAAI,GAAA,EAAM,OAAO,GAAG,WAAW,CAAA;AACxD,IAAA,MAAM,SAAS,GAAA,CAAI,QAAA,CAAS,QAAQ,CAAA,CAAE,MAAM,IAAI,CAAA;AAChD,IAAA,IAAI,MAAA,CAAO,MAAA,KAAW,CAAA,EAAG,OAAO,GAAG,WAAW,CAAA;AAC9C,IAAA,MAAM,CAAC,KAAK,GAAA,EAAK,GAAA,EAAK,MAAM,IAAA,EAAM,GAAA,EAAK,KAAK,CAAA,GAAI,MAAA;AAChD,IAAA,MAAM,GAAA,GAAM,KAAK,IAAI,CAAA;AACrB,IAAA,MAAM,GAAA,GAAM,KAAK,IAAI,CAAA;AACrB,IAAA,IACE,CAAC,IAAA,CAAK,GAAA,EAAK,GAAA,EAAK,CAAA,EAAG,EAAE,CAAA,IACrB,CAAC,IAAA,CAAK,GAAA,EAAK,MAAM,CAAA,EAAG,GAAG,CAAA,IACvB,CAAC,KAAK,GAAA,EAAK,IAAA,EAAM,CAAA,EAAG,GAAG,KACvB,CAAC,IAAA,CAAK,GAAA,EAAK,GAAA,EAAK,GAAG,GAAG,CAAA,IACtB,GAAA,KAAQ,IAAA,IACR,QAAQ,IAAA,IACR,GAAA,IAAO,OACP,GAAA,GAAM,GAAA,GAAM,KAAK,WAAA,EACjB;AACA,MAAA,OAAO,GAAG,WAAW,CAAA;AAAA,IACvB;AACA,IAAA,IAAI,UAAU,EAAA,EAAI;AAChB,MAAA,IAAI,CAAC,KAAK,KAAA,EAAO,KAAA,EAAO,IAAI,GAAG,CAAA,EAAG,OAAO,EAAA,CAAG,WAAW,CAAA;AAAA,IACzD,CAAA,MAAA,IAAW,IAAA,CAAK,YAAA,EAAc,OAAO,GAAG,WAAW,CAAA;AAInD,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,IAAA,CAAK,GAAA,CAAI,GAAG,CAAA;AAC7B,IAAA,MAAM,WAAW,UAAA,CAAW,QAAA,EAAU,MAAM,GAAA,CAAI,MAAA,GAAS,OAAO,KAAA,CAAM,EAAE,CAAC,CAAA,CACtE,MAAA,CAAO,SAAS,GAAA,GAAM,KAAA,CAAM,CAAC,CAAA,EAAI,QAAQ,EACzC,MAAA,EAAO;AACV,IAAA,IAAI,CAAC,gBAAgB,QAAA,EAAU,SAAS,KAAK,CAAC,GAAA,EAAK,OAAO,EAAA,CAAG,eAAe,CAAA;AAC5E,IAAA,IAAI,GAAA,CAAI,WAAA,KAAgB,MAAA,IAAa,GAAA,CAAI,WAAA,KAAgB,IAAA,IAAQ,GAAA,GAAM,GAAA,CAAI,WAAA,EAAa,OAAO,EAAA,CAAG,eAAe,CAAA;AACjH,IAAA,IAAI,GAAA,KAAQ,IAAA,CAAK,MAAA,EAAQ,OAAO,GAAG,eAAe,CAAA;AAIlD,IAAA,IAAI,GAAA,KAAQ,IAAA,CAAK,QAAA,EAAU,OAAO,GAAG,gBAAgB,CAAA;AACrD,IAAA,IAAI,MAAM,IAAA,CAAK,SAAA,GAAY,GAAA,EAAK,OAAO,GAAG,eAAe,CAAA;AACzD,IAAA,IAAI,OAAO,GAAA,GAAM,IAAA,CAAK,SAAA,EAAW,OAAO,GAAG,SAAS,CAAA;AACpD,IAAA,IAAI,KAAA,KAAU,EAAA,IAAM,IAAA,CAAK,WAAA,IAAe,CAAC,IAAA,CAAK,WAAA,CAAY,GAAA,CAAI,GAAA,GAAM,OAAO,KAAA,EAAO,GAAA,GAAM,IAAA,CAAK,SAAA,EAAW,GAAG,CAAA,EAAG;AAC5G,MAAA,OAAO,GAAG,UAAU,CAAA;AAAA,IACtB;AAEA,IAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,MAAA,EAAQ,EAAE,KAAK,MAAA,EAAQ,GAAA,EAAK,QAAA,EAAU,GAAA,EAAK,UAAU,GAAA,EAAK,SAAA,EAAW,GAAA,EAAK,SAAA,EAAW,KAAI,EAAE;AAAA,EAChH;AACF;AC1MA,IAAM,OAAA,GAAU,IAAI,iBAAA,EAA0B;AAGvC,SAAS,gBAAA,GAAuC;AACrD,EAAA,OAAO,QAAQ,QAAA,EAAS;AAC1B;AAEO,SAAS,uBAAuB,OAAA,EAA4B;AACjE,EAAA,MAAM,MAAA,GAAA,CAAU,OAAA,CAAQ,MAAA,IAAU,uBAAA,EAAyB,WAAA,EAAY;AACvE,EAAA,MAAM,SAAS,IAAI,GAAA,CAAI,OAAA,CAAQ,WAAA,IAAe,EAAE,CAAA;AAChD,EAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,GAAA,KAAQ,MAAM,MAAA,CAAA;AAElC,EAAA,OAAO,SAAS,YAAA,CAAa,GAAA,EAAsB,GAAA,EAAqB,IAAA,EAAqC;AAC3G,IAAA,MAAM,QAAQ,GAAA,CAAI,GAAA,IAAO,IAAI,KAAA,CAAM,GAAG,EAAE,CAAC,CAAA;AACzC,IAAA,IAAI,MAAA,CAAO,GAAA,CAAI,IAAI,CAAA,EAAG;AACpB,MAAA,IAAA,EAAK;AACL,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,MAAA;AACJ,IAAA,IAAI,MAAA;AACJ,IAAA,MAAM,QAAA,GAAW,GAAA,CAAI,eAAA,GAAkB,MAAM,CAAA;AAC7C,IAAA,IAAI,QAAA,IAAY,QAAA,CAAS,MAAA,GAAS,CAAA,EAAG;AACnC,MAAA,MAAA,GAAS,WAAA;AAAA,IACX,CAAA,MAAO;AACL,MAAA,IAAI;AACF,QAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,QAAA,CAAS,MAAA,CAAO,QAAA,GAAW,QAAA,CAAS,CAAC,CAAA,GAAI,GAAA,CAAI,OAAA,CAAQ,MAAM,CAAC,CAAA;AACpF,QAAA,IAAI,OAAA,CAAQ,EAAA,EAAI,MAAA,GAAS,OAAA,CAAQ,MAAA;AAAA,sBACnB,OAAA,CAAQ,MAAA;AAAA,MACxB,SAAS,GAAA,EAAK;AAEZ,QAAA,GAAA,CAAI,EAAE,KAAA,EAAO,OAAA,EAAS,OAAA,EAAS,wCAAA,EAA0C,YAAa,GAAA,EAAe,WAAA,EAAa,IAAA,IAAQ,SAAA,EAAW,CAAA;AACrI,QAAA,MAAA,GAAS,WAAA;AAAA,MACX;AAAA,IACF;AAEA,IAAA,IAAI,CAAC,MAAA,EAAQ;AACX,MAAA,MAAM,UAAkB,MAAA,IAAU,WAAA;AAClC,MAAA,GAAA,CAAI,EAAE,OAAO,MAAA,EAAQ,OAAA,EAAS,0BAA0B,OAAO,CAAA,CAAA,EAAI,MAAA,EAAQ,OAAA,EAAS,CAAA;AACpF,MAAA,MAAM,IAAA,GAAO,KAAK,SAAA,CAAU,EAAE,OAAO,uBAAA,EAAyB,MAAA,EAAQ,SAAS,CAAA;AAC/E,MAAA,GAAA,CAAI,UAAA,GAAa,GAAA;AACjB,MAAA,GAAA,CAAI,SAAA,CAAU,gBAAgB,kBAAkB,CAAA;AAChD,MAAA,GAAA,CAAI,UAAU,gBAAA,EAAkB,MAAA,CAAO,OAAO,UAAA,CAAW,IAAI,CAAC,CAAC,CAAA;AAC/D,MAAA,GAAA,CAAI,SAAA,CAAU,iBAAiB,UAAU,CAAA;AACzC,MAAA,GAAA,CAAI,SAAA,CAAU,kBAAA,EAAoB,CAAA,yBAAA,EAA4B,OAAO,CAAA,CAAA,CAAG,CAAA;AAExE,MAAA,GAAA,CAAI,SAAA,CAAU,cAAc,OAAO,CAAA;AACnC,MAAA,GAAA,CAAI,IAAI,IAAI,CAAA;AACZ,MAAA;AAAA,IACF;AAEA,IAAC,IAA4B,YAAA,GAAe,MAAA;AAC5C,IAAA,GAAA,CAAI,EAAE,KAAA,EAAO,OAAA,EAAS,OAAA,EAAS,CAAA,mCAAA,EAAsC,MAAA,CAAO,SAAS,CAAA,CAAA,EAAI,SAAA,EAAW,MAAA,CAAO,SAAA,EAAW,CAAA;AACtH,IAAA,OAAA,CAAQ,GAAA,CAAI,MAAA,CAAO,SAAA,EAAW,MAAM,MAAM,CAAA;AAAA,EAC5C,CAAA;AACF","file":"index.js","sourcesContent":["/**\n * The verifier for `fst1` service tokens. node:crypto only: createHmac and\n * timingSafeEqual. No JWT library and no cryptography of our own.\n *\n * The format and the ORDER of the checks are defined in the README and pinned\n * by the shared fixtures; the order decides which reason a token that is wrong\n * in two ways is refused with, so the PHP and Python legs follow it exactly.\n */\nimport { createHmac, timingSafeEqual } from \"node:crypto\";\n\nexport const PREFIX = \"fst1\";\nconst SIGNATURE_CHARS = 43;\n\nexport const REASONS = [\n \"missing\",\n \"malformed\",\n \"bad_signature\",\n \"expired\",\n \"not_yet_valid\",\n \"wrong_audience\",\n \"replayed\",\n] as const;\nexport type Reason = (typeof REASONS)[number];\n\nexport interface Key {\n kid: string;\n secret: Uint8Array;\n /** Unix seconds. Marks a PREVIOUS key, accepted until (and including) this second. */\n acceptUntil?: number | null;\n}\n\n/** The verified contents of a token. Never holds the token, the nonce or a secret. */\nexport interface Claims {\n kid: string;\n issuer: string;\n audience: string;\n issuedAt: number;\n expiresAt: number;\n requestId: string;\n}\n\nexport type Verdict = { ok: true; claims: Claims } | { ok: false; reason: Reason };\n\nexport interface ReplayStore {\n /** Record `key` until `expiresAt`. True if it was new; false if already held (or refused). */\n add(key: string, expiresAt: number, now: number): boolean;\n}\n\n/**\n * Per-process nonce memory. Fails CLOSED when full: a nonce it cannot record is\n * refused. Several processes behind one port need a shared store.\n */\nexport class MemoryReplayStore implements ReplayStore {\n private seen = new Map<string, number>();\n\n constructor(readonly maxEntries = 100_000) {\n if (!Number.isInteger(maxEntries) || maxEntries < 1) throw new RangeError(\"maxEntries must be at least 1\");\n }\n\n add(key: string, expiresAt: number, now: number): boolean {\n const held = this.seen.get(key);\n if (held !== undefined && held > now) return false;\n if (this.seen.size >= this.maxEntries) {\n for (const [k, v] of this.seen) if (v <= now) this.seen.delete(k);\n if (this.seen.size >= this.maxEntries) return false;\n }\n this.seen.set(key, expiresAt);\n return true;\n }\n}\n\nexport interface VerifierOptions {\n keys: Key[];\n audience: string;\n issuer: string;\n clockSkew?: number;\n maxLifetime?: number;\n maxTokenBytes?: number;\n requireNonce?: boolean;\n minKeyBytes?: number;\n /** `null` turns replay checks off. Default: a new MemoryReplayStore. */\n replayStore?: ReplayStore | null;\n /** Milliseconds, like Date.now. */\n clock?: () => number;\n}\n\nconst B64URL = /^[A-Za-z0-9_-]*$/;\nconst charset = (extra: string) => new Set(\"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789\" + extra);\nconst KID = charset(\"._-\");\nconst NAME = charset(\"._:/-\");\nconst RID = charset(\"._:-\");\nconst NONCE = charset(\"_-\");\nconst DIGITS = new Set(\"0123456789\");\n\nfunction only(value: string, chars: Set<string>, min: number, max: number): boolean {\n if (value.length < min || value.length > max) return false;\n for (const c of value) if (!chars.has(c)) return false;\n return true;\n}\n\nfunction time(value: string): number | null {\n if (!only(value, DIGITS, 1, 12) || value[0] === \"0\") return null;\n return Number(value);\n}\n\n/** Strict unpadded base64url: right alphabet, right length, and the ONE canonical spelling. */\nfunction b64decode(text: string): Buffer | null {\n if (text.length === 0 || text.length % 4 === 1 || !B64URL.test(text)) return null;\n const raw = Buffer.from(text, \"base64url\");\n if (raw.toString(\"base64url\") !== text) return null;\n return raw;\n}\n\nconst no = (reason: Reason): Verdict => ({ ok: false, reason });\n\nexport class Verifier {\n readonly audience: string;\n readonly issuer: string;\n readonly clockSkew: number;\n readonly maxLifetime: number;\n readonly maxTokenBytes: number;\n readonly requireNonce: boolean;\n readonly replayStore: ReplayStore | null;\n private readonly keys: Map<string, Key>;\n private readonly clock: () => number;\n\n constructor(options: VerifierOptions) {\n const { clockSkew = 10, maxLifetime = 300, maxTokenBytes = 1024, minKeyBytes = 32 } = options;\n for (const [label, value] of [\n [\"clockSkew\", clockSkew],\n [\"maxLifetime\", maxLifetime],\n [\"maxTokenBytes\", maxTokenBytes],\n ] as const) {\n if (!Number.isInteger(value) || value < 0) throw new RangeError(`${label} must be a non-negative integer`);\n }\n if (!options.keys || options.keys.length === 0) throw new Error(\"at least one key is required\");\n if (!only(options.audience, NAME, 1, 128) || !only(options.issuer, NAME, 1, 128)) {\n throw new Error(\"audience and issuer must be 1-128 chars of [A-Za-z0-9._:/-]\");\n }\n this.keys = new Map();\n for (const key of options.keys) {\n if (!only(key.kid, KID, 1, 64)) throw new Error(\"a key id must be 1-64 chars of [A-Za-z0-9._-]\");\n if (this.keys.has(key.kid)) throw new Error(`duplicate key id \"${key.kid}\"`);\n // Names the key, never its value.\n if (!(key.secret instanceof Uint8Array) || key.secret.length < minKeyBytes) {\n throw new Error(`key \"${key.kid}\" is shorter than ${minKeyBytes} bytes`);\n }\n this.keys.set(key.kid, key);\n }\n this.audience = options.audience;\n this.issuer = options.issuer;\n this.clockSkew = clockSkew;\n this.maxLifetime = maxLifetime;\n this.maxTokenBytes = maxTokenBytes;\n this.requireNonce = options.requireNonce ?? true;\n this.replayStore = options.replayStore === undefined ? new MemoryReplayStore() : options.replayStore;\n this.clock = options.clock ?? Date.now;\n }\n\n /** Never throws for any input: an unexpected failure is a `malformed` refusal. */\n verify(token: unknown, now?: number): Verdict {\n try {\n return this.check(token, now ?? Math.floor(this.clock() / 1000));\n } catch {\n return no(\"malformed\");\n }\n }\n\n private check(input: unknown, now: number): Verdict {\n // 1. Missing.\n if (input === null || input === undefined || input === \"\") return no(\"missing\");\n let token: string;\n if (typeof input === \"string\") token = input;\n else if (input instanceof Uint8Array) {\n if (input.length === 0) return no(\"missing\");\n for (const b of input) if (b > 0x7f) return no(\"malformed\");\n token = Buffer.from(input).toString(\"latin1\");\n } else return no(\"malformed\");\n\n // 2. Size, before any parsing.\n if (token.length > this.maxTokenBytes) return no(\"malformed\");\n\n // 3. Structure: exactly prefix . payload . signature, each canonical.\n const parts = token.split(\".\");\n if (parts.length !== 3 || parts[0] !== PREFIX || parts[2]!.length !== SIGNATURE_CHARS) return no(\"malformed\");\n const signature = b64decode(parts[2]!);\n const raw = b64decode(parts[1]!);\n if (!signature || !raw || signature.length !== 32) return no(\"malformed\");\n\n // 4. Payload grammar: seven LF-separated ASCII fields.\n for (const b of raw) if (b > 0x7f) return no(\"malformed\");\n const fields = raw.toString(\"latin1\").split(\"\\n\");\n if (fields.length !== 7) return no(\"malformed\");\n const [kid, iss, aud, iatS, expS, rid, nonce] = fields as [string, string, string, string, string, string, string];\n const iat = time(iatS);\n const exp = time(expS);\n if (\n !only(kid, KID, 1, 64) ||\n !only(iss, NAME, 1, 128) ||\n !only(aud, NAME, 1, 128) ||\n !only(rid, RID, 1, 128) ||\n iat === null ||\n exp === null ||\n exp <= iat ||\n exp - iat > this.maxLifetime\n ) {\n return no(\"malformed\");\n }\n if (nonce !== \"\") {\n if (!only(nonce, NONCE, 16, 128)) return no(\"malformed\");\n } else if (this.requireNonce) return no(\"malformed\");\n\n // 5. Signature. An unknown kid, a retired key past its grace window and\n // another issuer are all \"not signed by a key we hold for this issuer\".\n const key = this.keys.get(kid);\n const expected = createHmac(\"sha256\", key ? key.secret : Buffer.alloc(32))\n .update(PREFIX + \".\" + parts[1]!, \"latin1\")\n .digest();\n if (!timingSafeEqual(expected, signature) || !key) return no(\"bad_signature\");\n if (key.acceptUntil !== undefined && key.acceptUntil !== null && now > key.acceptUntil) return no(\"bad_signature\");\n if (iss !== this.issuer) return no(\"bad_signature\");\n\n // 6. Audience, 7. time window, 8. replay -- last, so only a token that is\n // otherwise acceptable can spend a nonce.\n if (aud !== this.audience) return no(\"wrong_audience\");\n if (now + this.clockSkew < iat) return no(\"not_yet_valid\");\n if (now >= exp + this.clockSkew) return no(\"expired\");\n if (nonce !== \"\" && this.replayStore && !this.replayStore.add(iss + \"\\n\" + nonce, exp + this.clockSkew, now)) {\n return no(\"replayed\");\n }\n\n return { ok: true, claims: { kid, issuer: iss, audience: aud, issuedAt: iat, expiresAt: exp, requestId: rid } };\n }\n}\n","/**\n * A connect-style `(req, res, next)` middleware: Express, Connect, Polka and a\n * bare node:http handler all take it. It decides from `req.headers` alone, so\n * on a refusal nothing ever reads, parses or buffers the request body, and the\n * handler is never called. Mount it BEFORE any body parser.\n */\nimport { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\n\nimport type { Claims, Reason, Verifier } from \"./verifier\";\n\nexport interface LogEvent {\n level: \"debug\" | \"warn\" | \"error\";\n message: string;\n reason?: Reason;\n requestId?: string;\n errorClass?: string;\n}\n\nexport interface MiddlewareOptions {\n verifier: Verifier;\n /** Header carrying the token. Case-insensitive. */\n header?: string;\n /** Exact paths (query string ignored) that skip verification, e.g. a health check. */\n exemptPaths?: Iterable<string>;\n /** Receives structured events. Never given a token, a nonce or a secret. */\n log?: (event: LogEvent) => void;\n}\n\nexport type ServiceTokenRequest = IncomingMessage & { serviceToken?: Claims };\n\nconst storage = new AsyncLocalStorage<string>();\n\n/** The VERIFIED request id of the request being handled, or undefined outside one. */\nexport function currentRequestId(): string | undefined {\n return storage.getStore();\n}\n\nexport function serviceTokenMiddleware(options: MiddlewareOptions) {\n const header = (options.header ?? \"x-fancy-service-token\").toLowerCase();\n const exempt = new Set(options.exemptPaths ?? []);\n const log = options.log ?? (() => undefined);\n\n return function serviceToken(req: IncomingMessage, res: ServerResponse, next: (err?: unknown) => void): void {\n const path = (req.url ?? \"\").split(\"?\")[0]!;\n if (exempt.has(path)) {\n next();\n return;\n }\n\n let reason: Reason | undefined;\n let claims: Claims | undefined;\n const distinct = req.headersDistinct?.[header];\n if (distinct && distinct.length > 1) {\n reason = \"malformed\";\n } else {\n try {\n const verdict = options.verifier.verify(distinct ? distinct[0] : req.headers[header]);\n if (verdict.ok) claims = verdict.claims;\n else reason = verdict.reason;\n } catch (err) {\n // Fail closed; record the class, never the message.\n log({ level: \"error\", message: \"service token verifier threw; refusing\", errorClass: (err as Error)?.constructor?.name ?? \"unknown\" });\n reason = \"malformed\";\n }\n }\n\n if (!claims) {\n const refused: Reason = reason ?? \"malformed\";\n log({ level: \"warn\", message: `service token refused: ${refused}`, reason: refused });\n const body = JSON.stringify({ error: \"service_token_refused\", reason: refused });\n res.statusCode = 401;\n res.setHeader(\"content-type\", \"application/json\");\n res.setHeader(\"content-length\", String(Buffer.byteLength(body)));\n res.setHeader(\"cache-control\", \"no-store\");\n res.setHeader(\"www-authenticate\", `FancyServiceToken error=\"${refused}\"`);\n // The unread body must not be parsed as a next request on this socket.\n res.setHeader(\"connection\", \"close\");\n res.end(body);\n return;\n }\n\n (req as ServiceTokenRequest).serviceToken = claims;\n log({ level: \"debug\", message: `service token accepted for request ${claims.requestId}`, requestId: claims.requestId });\n storage.run(claims.requestId, () => next());\n };\n}\n"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@particle-academy/fancy-service-token",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.1.0",
|
|
4
4
|
"description": "Verify Fancy service tokens in a Node sidecar: the verifier mirror of the PHP signer plus a connect-style middleware that refuses before the body is read, with a named reason. node:crypto only, zero runtime dependencies.",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|