dbsc-toolkit 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +132 -0
- package/README.md +205 -0
- package/dist/client/detect.d.ts +3 -0
- package/dist/client/detect.d.ts.map +1 -0
- package/dist/client/detect.js +20 -0
- package/dist/client/detect.js.map +1 -0
- package/dist/client/index.d.ts +4 -0
- package/dist/client/index.d.ts.map +1 -0
- package/dist/client/index.js +4 -0
- package/dist/client/index.js.map +1 -0
- package/dist/client/signals.d.ts +9 -0
- package/dist/client/signals.d.ts.map +1 -0
- package/dist/client/signals.js +13 -0
- package/dist/client/signals.js.map +1 -0
- package/dist/client/webauthn.d.ts +3 -0
- package/dist/client/webauthn.d.ts.map +1 -0
- package/dist/client/webauthn.js +8 -0
- package/dist/client/webauthn.js.map +1 -0
- package/dist/core/crypto/jwk.d.ts +3 -0
- package/dist/core/crypto/jwk.d.ts.map +1 -0
- package/dist/core/crypto/jwk.js +36 -0
- package/dist/core/crypto/jwk.js.map +1 -0
- package/dist/core/crypto/jws.d.ts +15 -0
- package/dist/core/crypto/jws.d.ts.map +1 -0
- package/dist/core/crypto/jws.js +89 -0
- package/dist/core/crypto/jws.js.map +1 -0
- package/dist/core/errors.d.ts +27 -0
- package/dist/core/errors.d.ts.map +1 -0
- package/dist/core/errors.js +39 -0
- package/dist/core/errors.js.map +1 -0
- package/dist/core/fallback/hmac.d.ts +9 -0
- package/dist/core/fallback/hmac.d.ts.map +1 -0
- package/dist/core/fallback/hmac.js +37 -0
- package/dist/core/fallback/hmac.js.map +1 -0
- package/dist/core/fallback/negotiate.d.ts +9 -0
- package/dist/core/fallback/negotiate.d.ts.map +1 -0
- package/dist/core/fallback/negotiate.js +22 -0
- package/dist/core/fallback/negotiate.js.map +1 -0
- package/dist/core/fallback/webauthn.d.ts +10 -0
- package/dist/core/fallback/webauthn.d.ts.map +1 -0
- package/dist/core/fallback/webauthn.js +41 -0
- package/dist/core/fallback/webauthn.js.map +1 -0
- package/dist/core/index.d.ts +14 -0
- package/dist/core/index.d.ts.map +1 -0
- package/dist/core/index.js +13 -0
- package/dist/core/index.js.map +1 -0
- package/dist/core/protocol/challenge.d.ts +4 -0
- package/dist/core/protocol/challenge.d.ts.map +1 -0
- package/dist/core/protocol/challenge.js +18 -0
- package/dist/core/protocol/challenge.js.map +1 -0
- package/dist/core/protocol/headers.d.ts +21 -0
- package/dist/core/protocol/headers.d.ts.map +1 -0
- package/dist/core/protocol/headers.js +33 -0
- package/dist/core/protocol/headers.js.map +1 -0
- package/dist/core/protocol/refresh.d.ts +8 -0
- package/dist/core/protocol/refresh.d.ts.map +1 -0
- package/dist/core/protocol/refresh.js +37 -0
- package/dist/core/protocol/refresh.js.map +1 -0
- package/dist/core/protocol/registration.d.ts +11 -0
- package/dist/core/protocol/registration.d.ts.map +1 -0
- package/dist/core/protocol/registration.js +40 -0
- package/dist/core/protocol/registration.js.map +1 -0
- package/dist/core/ratelimit/interface.d.ts +7 -0
- package/dist/core/ratelimit/interface.d.ts.map +1 -0
- package/dist/core/ratelimit/interface.js +11 -0
- package/dist/core/ratelimit/interface.js.map +1 -0
- package/dist/core/telemetry/hooks.d.ts +4 -0
- package/dist/core/telemetry/hooks.d.ts.map +1 -0
- package/dist/core/telemetry/hooks.js +11 -0
- package/dist/core/telemetry/hooks.js.map +1 -0
- package/dist/core/testing/memory-storage-stub.d.ts +18 -0
- package/dist/core/testing/memory-storage-stub.d.ts.map +1 -0
- package/dist/core/testing/memory-storage-stub.js +50 -0
- package/dist/core/testing/memory-storage-stub.js.map +1 -0
- package/dist/core/types.d.ts +92 -0
- package/dist/core/types.d.ts.map +1 -0
- package/dist/core/types.js +2 -0
- package/dist/core/types.js.map +1 -0
- package/dist/express/index.d.ts +20 -0
- package/dist/express/index.d.ts.map +1 -0
- package/dist/express/index.js +217 -0
- package/dist/express/index.js.map +1 -0
- package/dist/fastify/index.d.ts +17 -0
- package/dist/fastify/index.d.ts.map +1 -0
- package/dist/fastify/index.js +115 -0
- package/dist/fastify/index.js.map +1 -0
- package/dist/hono/index.d.ts +13 -0
- package/dist/hono/index.d.ts.map +1 -0
- package/dist/hono/index.js +107 -0
- package/dist/hono/index.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -0
- package/dist/nextjs/index.d.ts +13 -0
- package/dist/nextjs/index.d.ts.map +1 -0
- package/dist/nextjs/index.js +126 -0
- package/dist/nextjs/index.js.map +1 -0
- package/dist/storage/memory/index.d.ts +20 -0
- package/dist/storage/memory/index.d.ts.map +1 -0
- package/dist/storage/memory/index.js +79 -0
- package/dist/storage/memory/index.js.map +1 -0
- package/dist/storage/postgres/index.d.ts +19 -0
- package/dist/storage/postgres/index.d.ts.map +1 -0
- package/dist/storage/postgres/index.js +89 -0
- package/dist/storage/postgres/index.js.map +1 -0
- package/dist/storage/redis/index.d.ts +18 -0
- package/dist/storage/redis/index.d.ts.map +1 -0
- package/dist/storage/redis/index.js +88 -0
- package/dist/storage/redis/index.js.map +1 -0
- package/migrations/001_initial.sql +41 -0
- package/package.json +124 -0
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
export type ProtectionTier = "dbsc" | "webauthn" | "hmac" | "none";
|
|
2
|
+
export interface BoundKey {
|
|
3
|
+
sessionId: string;
|
|
4
|
+
jwk: JsonWebKey;
|
|
5
|
+
createdAt: number;
|
|
6
|
+
algorithm: "ES256" | "RS256";
|
|
7
|
+
}
|
|
8
|
+
export interface Session {
|
|
9
|
+
id: string;
|
|
10
|
+
userId: string;
|
|
11
|
+
tier: ProtectionTier;
|
|
12
|
+
createdAt: number;
|
|
13
|
+
expiresAt: number;
|
|
14
|
+
lastRefreshAt: number;
|
|
15
|
+
}
|
|
16
|
+
export interface Challenge {
|
|
17
|
+
jti: string;
|
|
18
|
+
sessionId: string;
|
|
19
|
+
createdAt: number;
|
|
20
|
+
expiresAt: number;
|
|
21
|
+
consumed: boolean;
|
|
22
|
+
}
|
|
23
|
+
export interface RegistrationProof {
|
|
24
|
+
sessionId: string;
|
|
25
|
+
jwk: JsonWebKey;
|
|
26
|
+
algorithm: "ES256" | "RS256";
|
|
27
|
+
jti: string;
|
|
28
|
+
}
|
|
29
|
+
export interface RefreshProof {
|
|
30
|
+
sessionId: string;
|
|
31
|
+
jti: string;
|
|
32
|
+
verified: boolean;
|
|
33
|
+
}
|
|
34
|
+
export interface StorageAdapter {
|
|
35
|
+
getSession(id: string): Promise<Session | null>;
|
|
36
|
+
setSession(session: Session): Promise<void>;
|
|
37
|
+
deleteSession(id: string): Promise<void>;
|
|
38
|
+
getBoundKey(sessionId: string): Promise<BoundKey | null>;
|
|
39
|
+
setBoundKey(key: BoundKey): Promise<void>;
|
|
40
|
+
deleteBoundKey(sessionId: string): Promise<void>;
|
|
41
|
+
getChallenge(jti: string): Promise<Challenge | null>;
|
|
42
|
+
setChallenge(challenge: Challenge): Promise<void>;
|
|
43
|
+
consumeChallenge(jti: string): Promise<boolean>;
|
|
44
|
+
revokeSession(sessionId: string): Promise<void>;
|
|
45
|
+
revokeAllForUser(userId: string): Promise<void>;
|
|
46
|
+
}
|
|
47
|
+
export interface RateLimiter {
|
|
48
|
+
checkRegistration(ip: string): Promise<boolean>;
|
|
49
|
+
checkRefresh(ip: string, sessionId: string): Promise<boolean>;
|
|
50
|
+
recordFailure(ip: string, sessionId?: string): Promise<void>;
|
|
51
|
+
}
|
|
52
|
+
export interface TelemetryEvent {
|
|
53
|
+
sessionId: string;
|
|
54
|
+
tier: ProtectionTier;
|
|
55
|
+
timestamp: number;
|
|
56
|
+
}
|
|
57
|
+
export interface RegistrationEvent extends TelemetryEvent {
|
|
58
|
+
type: "registration";
|
|
59
|
+
algorithm: string;
|
|
60
|
+
ip: string;
|
|
61
|
+
}
|
|
62
|
+
export interface RefreshEvent extends TelemetryEvent {
|
|
63
|
+
type: "refresh";
|
|
64
|
+
ip: string;
|
|
65
|
+
}
|
|
66
|
+
export interface VerificationFailureEvent extends TelemetryEvent {
|
|
67
|
+
type: "verification_failure";
|
|
68
|
+
reason: string;
|
|
69
|
+
ip: string;
|
|
70
|
+
}
|
|
71
|
+
export interface SessionStolenEvent extends TelemetryEvent {
|
|
72
|
+
type: "session_stolen";
|
|
73
|
+
ip: string;
|
|
74
|
+
}
|
|
75
|
+
export interface FallbackTierEvent extends TelemetryEvent {
|
|
76
|
+
type: "fallback_tier";
|
|
77
|
+
from: ProtectionTier;
|
|
78
|
+
to: ProtectionTier;
|
|
79
|
+
reason: string;
|
|
80
|
+
}
|
|
81
|
+
export type AnyTelemetryEvent = RegistrationEvent | RefreshEvent | VerificationFailureEvent | SessionStolenEvent | FallbackTierEvent;
|
|
82
|
+
export interface DbscOptions {
|
|
83
|
+
storage: StorageAdapter;
|
|
84
|
+
fallback?: "webauthn" | "hmac" | "none";
|
|
85
|
+
registrationPath?: string;
|
|
86
|
+
refreshPath?: string;
|
|
87
|
+
boundCookieTtl?: number;
|
|
88
|
+
registrationCookieTtl?: number;
|
|
89
|
+
rateLimiter?: RateLimiter;
|
|
90
|
+
onEvent?: (event: AnyTelemetryEvent) => void;
|
|
91
|
+
}
|
|
92
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { RequestHandler } from "express";
|
|
2
|
+
import { type DbscOptions, type ProtectionTier } from "../core/index.js";
|
|
3
|
+
export interface DbscExpressOptions extends DbscOptions {
|
|
4
|
+
secure?: boolean;
|
|
5
|
+
}
|
|
6
|
+
export interface DbscLocals {
|
|
7
|
+
sessionId: string | null;
|
|
8
|
+
tier: ProtectionTier;
|
|
9
|
+
revoke: () => Promise<void>;
|
|
10
|
+
requireBound: () => void;
|
|
11
|
+
}
|
|
12
|
+
declare global {
|
|
13
|
+
namespace Express {
|
|
14
|
+
interface Locals {
|
|
15
|
+
dbsc: DbscLocals;
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
export declare function dbsc(opts: DbscExpressOptions): RequestHandler;
|
|
20
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/express/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmC,cAAc,EAAE,MAAM,SAAS,CAAC;AAE/E,OAAO,EAgBL,KAAK,WAAW,EAEhB,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAW1B,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,OAAO,CAAC;QAChB,UAAU,MAAM;YACd,IAAI,EAAE,UAAU,CAAC;SAClB;KACF;CACF;AAsBD,wBAAgB,IAAI,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CAoO7D"}
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
import { randomBytes as nodeRandomBytes } from "node:crypto";
|
|
2
|
+
import { handleRegistration, handleRefresh, issueChallenge, buildChallengeHeader, readSessionResponseHeader, CHALLENGE_HEADER, LEGACY_CHALLENGE_HEADER, NoopRateLimiter, emit, DbscProtocolError, DbscVerificationError, } from "../core/index.js";
|
|
3
|
+
const cookieNames = (secure) => ({
|
|
4
|
+
bound: secure ? "__Host-dbsc-session" : "dbsc-session",
|
|
5
|
+
reg: secure ? "__Host-dbsc-reg" : "dbsc-reg",
|
|
6
|
+
challenge: secure ? "__Host-dbsc-challenge" : "dbsc-challenge",
|
|
7
|
+
});
|
|
8
|
+
const DEFAULT_BOUND_TTL = 10 * 60 * 1000;
|
|
9
|
+
const DEFAULT_REG_TTL = 24 * 60 * 60 * 1000;
|
|
10
|
+
function cookieOpts(ttlMs, secure) {
|
|
11
|
+
return {
|
|
12
|
+
httpOnly: true,
|
|
13
|
+
secure,
|
|
14
|
+
sameSite: "lax",
|
|
15
|
+
maxAge: ttlMs / 1000,
|
|
16
|
+
path: "/",
|
|
17
|
+
};
|
|
18
|
+
}
|
|
19
|
+
function serializeCookie(name, value, opts) {
|
|
20
|
+
const parts = [`${name}=${value}`];
|
|
21
|
+
parts.push("HttpOnly");
|
|
22
|
+
if (opts.secure)
|
|
23
|
+
parts.push("Secure");
|
|
24
|
+
parts.push(`SameSite=${opts.sameSite}`);
|
|
25
|
+
parts.push(`Max-Age=${opts.maxAge}`);
|
|
26
|
+
parts.push(`Path=${opts.path}`);
|
|
27
|
+
return parts.join("; ");
|
|
28
|
+
}
|
|
29
|
+
export function dbsc(opts) {
|
|
30
|
+
const { storage, fallback = "webauthn", registrationPath = "/dbsc/registration", refreshPath = "/dbsc/refresh", boundCookieTtl = DEFAULT_BOUND_TTL, registrationCookieTtl = DEFAULT_REG_TTL, rateLimiter = new NoopRateLimiter(), onEvent, secure = true, } = opts;
|
|
31
|
+
const hmacSecret = nodeRandomBytes(32);
|
|
32
|
+
const COOKIES = cookieNames(secure);
|
|
33
|
+
async function handleRegistrationRoute(req, res) {
|
|
34
|
+
const ip = req.ip ?? "unknown";
|
|
35
|
+
const allowed = await rateLimiter.checkRegistration(ip);
|
|
36
|
+
if (!allowed) {
|
|
37
|
+
res.status(429).json({ error: "rate limited" });
|
|
38
|
+
return;
|
|
39
|
+
}
|
|
40
|
+
const sessionId = req.cookies?.[COOKIES.reg];
|
|
41
|
+
const expectedJti = req.cookies?.[COOKIES.challenge];
|
|
42
|
+
if (!sessionId || !expectedJti) {
|
|
43
|
+
res.status(400).json({ error: "missing session or challenge cookie" });
|
|
44
|
+
return;
|
|
45
|
+
}
|
|
46
|
+
try {
|
|
47
|
+
await handleRegistration({
|
|
48
|
+
sessionId,
|
|
49
|
+
secSessionResponseHeader: readSessionResponseHeader(req.headers),
|
|
50
|
+
expectedJti,
|
|
51
|
+
}, storage);
|
|
52
|
+
emit(onEvent, {
|
|
53
|
+
type: "registration",
|
|
54
|
+
sessionId,
|
|
55
|
+
tier: "dbsc",
|
|
56
|
+
timestamp: Date.now(),
|
|
57
|
+
algorithm: "ES256",
|
|
58
|
+
ip,
|
|
59
|
+
});
|
|
60
|
+
res.setHeader("Set-Cookie", [
|
|
61
|
+
serializeCookie(COOKIES.bound, sessionId, cookieOpts(boundCookieTtl, secure)),
|
|
62
|
+
serializeCookie(COOKIES.challenge, "", { ...cookieOpts(0, secure), maxAge: 0 }),
|
|
63
|
+
]);
|
|
64
|
+
res.setHeader("Content-Type", "application/json");
|
|
65
|
+
res.status(200).json({
|
|
66
|
+
session_identifier: sessionId,
|
|
67
|
+
refresh_url: refreshPath,
|
|
68
|
+
scope: { include_site: true },
|
|
69
|
+
credentials: [
|
|
70
|
+
{
|
|
71
|
+
type: "cookie",
|
|
72
|
+
name: COOKIES.bound,
|
|
73
|
+
attributes: `Path=/; Secure; HttpOnly; SameSite=Lax; Max-Age=${Math.floor(boundCookieTtl / 1000)}`,
|
|
74
|
+
},
|
|
75
|
+
],
|
|
76
|
+
});
|
|
77
|
+
}
|
|
78
|
+
catch (err) {
|
|
79
|
+
await rateLimiter.recordFailure(ip, sessionId);
|
|
80
|
+
if (err instanceof DbscVerificationError || err instanceof DbscProtocolError) {
|
|
81
|
+
emit(onEvent, {
|
|
82
|
+
type: "verification_failure",
|
|
83
|
+
sessionId,
|
|
84
|
+
tier: "dbsc",
|
|
85
|
+
timestamp: Date.now(),
|
|
86
|
+
reason: err.code,
|
|
87
|
+
ip,
|
|
88
|
+
});
|
|
89
|
+
res.status(400).json({ error: err.message });
|
|
90
|
+
return;
|
|
91
|
+
}
|
|
92
|
+
throw err;
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
async function handleRefreshRoute(req, res) {
|
|
96
|
+
const ip = req.ip ?? "unknown";
|
|
97
|
+
const sessionIdHeader = req.headers["sec-secure-session-id"];
|
|
98
|
+
const sessionId = (Array.isArray(sessionIdHeader) ? sessionIdHeader[0] : sessionIdHeader)
|
|
99
|
+
?? req.cookies?.[COOKIES.bound];
|
|
100
|
+
if (!sessionId) {
|
|
101
|
+
res.status(403).end();
|
|
102
|
+
return;
|
|
103
|
+
}
|
|
104
|
+
const allowed = await rateLimiter.checkRefresh(ip, sessionId);
|
|
105
|
+
if (!allowed) {
|
|
106
|
+
res.status(429).json({ error: "rate limited" });
|
|
107
|
+
return;
|
|
108
|
+
}
|
|
109
|
+
const responseHeader = readSessionResponseHeader(req.headers);
|
|
110
|
+
if (!responseHeader) {
|
|
111
|
+
const challenge = await issueChallenge(sessionId, storage);
|
|
112
|
+
res.setHeader(CHALLENGE_HEADER, buildChallengeHeader(challenge.jti));
|
|
113
|
+
res.setHeader(LEGACY_CHALLENGE_HEADER, buildChallengeHeader(challenge.jti));
|
|
114
|
+
res.setHeader("Set-Cookie", serializeCookie(COOKIES.challenge, challenge.jti, cookieOpts(5 * 60 * 1000, secure)));
|
|
115
|
+
res.status(403).end();
|
|
116
|
+
return;
|
|
117
|
+
}
|
|
118
|
+
const expectedJti = req.cookies?.[COOKIES.challenge];
|
|
119
|
+
if (!expectedJti) {
|
|
120
|
+
const challenge = await issueChallenge(sessionId, storage);
|
|
121
|
+
res.setHeader(CHALLENGE_HEADER, buildChallengeHeader(challenge.jti));
|
|
122
|
+
res.setHeader(LEGACY_CHALLENGE_HEADER, buildChallengeHeader(challenge.jti));
|
|
123
|
+
res.setHeader("Set-Cookie", serializeCookie(COOKIES.challenge, challenge.jti, cookieOpts(5 * 60 * 1000, secure)));
|
|
124
|
+
res.status(403).end();
|
|
125
|
+
return;
|
|
126
|
+
}
|
|
127
|
+
try {
|
|
128
|
+
await handleRefresh({ sessionId, secSessionResponseHeader: responseHeader, expectedJti }, storage);
|
|
129
|
+
emit(onEvent, {
|
|
130
|
+
type: "refresh",
|
|
131
|
+
sessionId,
|
|
132
|
+
tier: "dbsc",
|
|
133
|
+
timestamp: Date.now(),
|
|
134
|
+
ip,
|
|
135
|
+
});
|
|
136
|
+
res.setHeader("Set-Cookie", [
|
|
137
|
+
serializeCookie(COOKIES.bound, sessionId, cookieOpts(boundCookieTtl, secure)),
|
|
138
|
+
serializeCookie(COOKIES.challenge, "", { ...cookieOpts(0, secure), maxAge: 0 }),
|
|
139
|
+
]);
|
|
140
|
+
res.setHeader("Content-Type", "application/json");
|
|
141
|
+
res.status(200).json({
|
|
142
|
+
session_identifier: sessionId,
|
|
143
|
+
refresh_url: refreshPath,
|
|
144
|
+
scope: { include_site: true },
|
|
145
|
+
credentials: [
|
|
146
|
+
{
|
|
147
|
+
type: "cookie",
|
|
148
|
+
name: COOKIES.bound,
|
|
149
|
+
attributes: `Path=/; Secure; HttpOnly; SameSite=Lax; Max-Age=${Math.floor(boundCookieTtl / 1000)}`,
|
|
150
|
+
},
|
|
151
|
+
],
|
|
152
|
+
});
|
|
153
|
+
}
|
|
154
|
+
catch (err) {
|
|
155
|
+
await rateLimiter.recordFailure(ip, sessionId);
|
|
156
|
+
const stolenCheck = await storage.getBoundKey(sessionId);
|
|
157
|
+
if (stolenCheck) {
|
|
158
|
+
emit(onEvent, {
|
|
159
|
+
type: "session_stolen",
|
|
160
|
+
sessionId,
|
|
161
|
+
tier: "dbsc",
|
|
162
|
+
timestamp: Date.now(),
|
|
163
|
+
ip,
|
|
164
|
+
});
|
|
165
|
+
}
|
|
166
|
+
if (err instanceof DbscVerificationError || err instanceof DbscProtocolError) {
|
|
167
|
+
emit(onEvent, {
|
|
168
|
+
type: "verification_failure",
|
|
169
|
+
sessionId,
|
|
170
|
+
tier: "dbsc",
|
|
171
|
+
timestamp: Date.now(),
|
|
172
|
+
reason: err.code,
|
|
173
|
+
ip,
|
|
174
|
+
});
|
|
175
|
+
res.status(401).json({ error: err.message });
|
|
176
|
+
return;
|
|
177
|
+
}
|
|
178
|
+
throw err;
|
|
179
|
+
}
|
|
180
|
+
}
|
|
181
|
+
return async (req, res, next) => {
|
|
182
|
+
if (req.method === "POST" && req.path === registrationPath) {
|
|
183
|
+
await handleRegistrationRoute(req, res);
|
|
184
|
+
return;
|
|
185
|
+
}
|
|
186
|
+
if (req.method === "POST" && req.path === refreshPath) {
|
|
187
|
+
await handleRefreshRoute(req, res);
|
|
188
|
+
return;
|
|
189
|
+
}
|
|
190
|
+
const sessionId = req.cookies?.[COOKIES.bound];
|
|
191
|
+
res.locals.dbsc = {
|
|
192
|
+
sessionId: sessionId ?? null,
|
|
193
|
+
tier: "none",
|
|
194
|
+
revoke: async () => {
|
|
195
|
+
if (sessionId)
|
|
196
|
+
await storage.revokeSession(sessionId);
|
|
197
|
+
res.setHeader("Set-Cookie", [
|
|
198
|
+
serializeCookie(COOKIES.bound, "", { ...cookieOpts(0, secure), maxAge: 0 }),
|
|
199
|
+
]);
|
|
200
|
+
},
|
|
201
|
+
requireBound: () => {
|
|
202
|
+
if (!sessionId) {
|
|
203
|
+
res.status(401).json({ error: "authentication required" });
|
|
204
|
+
throw new Error("unauthenticated");
|
|
205
|
+
}
|
|
206
|
+
},
|
|
207
|
+
};
|
|
208
|
+
if (sessionId) {
|
|
209
|
+
const session = await storage.getSession(sessionId);
|
|
210
|
+
if (session) {
|
|
211
|
+
res.locals.dbsc.tier = session.tier;
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
next();
|
|
215
|
+
};
|
|
216
|
+
}
|
|
217
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/express/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import type { FastifyPluginAsync } from "fastify";
|
|
2
|
+
import "@fastify/cookie";
|
|
3
|
+
import { type DbscOptions, type ProtectionTier } from "../core/index.js";
|
|
4
|
+
declare module "fastify" {
|
|
5
|
+
interface FastifyRequest {
|
|
6
|
+
dbsc: {
|
|
7
|
+
sessionId: string | null;
|
|
8
|
+
tier: ProtectionTier;
|
|
9
|
+
revoke(): Promise<void>;
|
|
10
|
+
};
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
export interface DbscFastifyOptions extends DbscOptions {
|
|
14
|
+
secure?: boolean;
|
|
15
|
+
}
|
|
16
|
+
export declare const dbsc: FastifyPluginAsync<DbscFastifyOptions>;
|
|
17
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fastify/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAgC,MAAM,SAAS,CAAC;AAEhF,OAAO,iBAAiB,CAAC;AACzB,OAAO,EAYL,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,cAAc;QACtB,IAAI,EAAE;YACJ,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;YACzB,IAAI,EAAE,cAAc,CAAC;YACrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;SACzB,CAAC;KACH;CACF;AAQD,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAoID,eAAO,MAAM,IAAI,wCAA2D,CAAC"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
import fp from "fastify-plugin";
|
|
2
|
+
import "@fastify/cookie";
|
|
3
|
+
import { handleRegistration, handleRefresh, issueChallenge, buildChallengeHeader, readSessionResponseHeader, CHALLENGE_HEADER, LEGACY_CHALLENGE_HEADER, NoopRateLimiter, emit, DbscProtocolError, DbscVerificationError, } from "../core/index.js";
|
|
4
|
+
const BOUND_COOKIE = "__Host-dbsc-session";
|
|
5
|
+
const REGISTRATION_COOKIE = "__Host-dbsc-reg";
|
|
6
|
+
const CHALLENGE_COOKIE = "__Host-dbsc-challenge";
|
|
7
|
+
const DEFAULT_BOUND_TTL = 10 * 60;
|
|
8
|
+
const dbscPlugin = async (fastify, opts) => {
|
|
9
|
+
const { storage, registrationPath = "/dbsc/registration", refreshPath = "/dbsc/refresh", boundCookieTtl = DEFAULT_BOUND_TTL * 1000, rateLimiter = new NoopRateLimiter(), onEvent, secure = true, } = opts;
|
|
10
|
+
const cookieOpts = {
|
|
11
|
+
httpOnly: true,
|
|
12
|
+
secure,
|
|
13
|
+
sameSite: "lax",
|
|
14
|
+
path: "/",
|
|
15
|
+
};
|
|
16
|
+
fastify.decorateRequest("dbsc", null);
|
|
17
|
+
fastify.addHook("onRequest", async (req, reply) => {
|
|
18
|
+
const sessionId = req.cookies?.[BOUND_COOKIE] ?? null;
|
|
19
|
+
req.dbsc = {
|
|
20
|
+
sessionId,
|
|
21
|
+
tier: "none",
|
|
22
|
+
revoke: async () => {
|
|
23
|
+
if (sessionId)
|
|
24
|
+
await storage.revokeSession(sessionId);
|
|
25
|
+
reply.clearCookie(BOUND_COOKIE, cookieOpts);
|
|
26
|
+
},
|
|
27
|
+
};
|
|
28
|
+
if (sessionId) {
|
|
29
|
+
const session = await storage.getSession(sessionId);
|
|
30
|
+
if (session)
|
|
31
|
+
req.dbsc.tier = session.tier;
|
|
32
|
+
}
|
|
33
|
+
});
|
|
34
|
+
fastify.post(registrationPath, async (req, reply) => {
|
|
35
|
+
const ip = req.ip;
|
|
36
|
+
const sessionId = req.cookies?.[REGISTRATION_COOKIE];
|
|
37
|
+
const expectedJti = req.cookies?.[CHALLENGE_COOKIE];
|
|
38
|
+
if (!sessionId || !expectedJti) {
|
|
39
|
+
return reply.status(400).send({ error: "missing session or challenge cookie" });
|
|
40
|
+
}
|
|
41
|
+
const allowed = await rateLimiter.checkRegistration(ip);
|
|
42
|
+
if (!allowed)
|
|
43
|
+
return reply.status(429).send({ error: "rate limited" });
|
|
44
|
+
try {
|
|
45
|
+
await handleRegistration({
|
|
46
|
+
sessionId,
|
|
47
|
+
secSessionResponseHeader: readSessionResponseHeader(req.headers),
|
|
48
|
+
expectedJti,
|
|
49
|
+
}, storage);
|
|
50
|
+
emit(onEvent, {
|
|
51
|
+
type: "registration",
|
|
52
|
+
sessionId,
|
|
53
|
+
tier: "dbsc",
|
|
54
|
+
timestamp: Date.now(),
|
|
55
|
+
algorithm: "ES256",
|
|
56
|
+
ip,
|
|
57
|
+
});
|
|
58
|
+
reply.setCookie(BOUND_COOKIE, sessionId, {
|
|
59
|
+
...cookieOpts,
|
|
60
|
+
maxAge: boundCookieTtl / 1000,
|
|
61
|
+
});
|
|
62
|
+
reply.clearCookie(CHALLENGE_COOKIE, cookieOpts);
|
|
63
|
+
return reply.status(204).send();
|
|
64
|
+
}
|
|
65
|
+
catch (err) {
|
|
66
|
+
await rateLimiter.recordFailure(ip, sessionId);
|
|
67
|
+
if (err instanceof DbscVerificationError || err instanceof DbscProtocolError) {
|
|
68
|
+
return reply.status(400).send({ error: err.message });
|
|
69
|
+
}
|
|
70
|
+
throw err;
|
|
71
|
+
}
|
|
72
|
+
});
|
|
73
|
+
fastify.post(refreshPath, async (req, reply) => {
|
|
74
|
+
const ip = req.ip;
|
|
75
|
+
const sessionId = req.cookies?.[BOUND_COOKIE];
|
|
76
|
+
if (!sessionId)
|
|
77
|
+
return reply.status(401).send({ error: "no session" });
|
|
78
|
+
const allowed = await rateLimiter.checkRefresh(ip, sessionId);
|
|
79
|
+
if (!allowed)
|
|
80
|
+
return reply.status(429).send({ error: "rate limited" });
|
|
81
|
+
const responseHeader = readSessionResponseHeader(req.headers);
|
|
82
|
+
if (!responseHeader) {
|
|
83
|
+
const challenge = await issueChallenge(sessionId, storage);
|
|
84
|
+
reply.header(CHALLENGE_HEADER, buildChallengeHeader(challenge.jti));
|
|
85
|
+
reply.header(LEGACY_CHALLENGE_HEADER, buildChallengeHeader(challenge.jti));
|
|
86
|
+
reply.setCookie(CHALLENGE_COOKIE, challenge.jti, { ...cookieOpts, maxAge: 5 * 60 });
|
|
87
|
+
return reply.status(403).send();
|
|
88
|
+
}
|
|
89
|
+
const expectedJti = req.cookies?.[CHALLENGE_COOKIE];
|
|
90
|
+
if (!expectedJti)
|
|
91
|
+
return reply.status(400).send({ error: "missing challenge cookie" });
|
|
92
|
+
try {
|
|
93
|
+
await handleRefresh({ sessionId, secSessionResponseHeader: responseHeader, expectedJti }, storage);
|
|
94
|
+
emit(onEvent, {
|
|
95
|
+
type: "refresh",
|
|
96
|
+
sessionId,
|
|
97
|
+
tier: "dbsc",
|
|
98
|
+
timestamp: Date.now(),
|
|
99
|
+
ip,
|
|
100
|
+
});
|
|
101
|
+
reply.setCookie(BOUND_COOKIE, sessionId, { ...cookieOpts, maxAge: boundCookieTtl / 1000 });
|
|
102
|
+
reply.clearCookie(CHALLENGE_COOKIE, cookieOpts);
|
|
103
|
+
return reply.status(204).send();
|
|
104
|
+
}
|
|
105
|
+
catch (err) {
|
|
106
|
+
await rateLimiter.recordFailure(ip, sessionId);
|
|
107
|
+
if (err instanceof DbscVerificationError || err instanceof DbscProtocolError) {
|
|
108
|
+
return reply.status(401).send({ error: err.message });
|
|
109
|
+
}
|
|
110
|
+
throw err;
|
|
111
|
+
}
|
|
112
|
+
});
|
|
113
|
+
};
|
|
114
|
+
export const dbsc = fp(dbscPlugin, { name: "@dbsc-toolkit/server-fastify" });
|
|
115
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fastify/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { MiddlewareHandler } from "hono";
|
|
2
|
+
import { type DbscOptions, type ProtectionTier } from "../core/index.js";
|
|
3
|
+
export interface DbscHonoOptions extends DbscOptions {
|
|
4
|
+
secure?: boolean;
|
|
5
|
+
}
|
|
6
|
+
declare module "hono" {
|
|
7
|
+
interface ContextVariableMap {
|
|
8
|
+
dbscSessionId: string | null;
|
|
9
|
+
dbscTier: ProtectionTier;
|
|
10
|
+
}
|
|
11
|
+
}
|
|
12
|
+
export declare function dbsc(opts: DbscHonoOptions): MiddlewareHandler;
|
|
13
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hono/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAEvD,OAAO,EAYL,KAAK,WAAW,EAChB,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAQ1B,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,kBAAkB;QAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,QAAQ,EAAE,cAAc,CAAC;KAC1B;CACF;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,CA2H7D"}
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
import { getCookie, setCookie, deleteCookie } from "hono/cookie";
|
|
2
|
+
import { handleRegistration, handleRefresh, issueChallenge, buildChallengeHeader, CHALLENGE_HEADER, LEGACY_CHALLENGE_HEADER, NoopRateLimiter, emit, DbscProtocolError, DbscVerificationError, } from "../core/index.js";
|
|
3
|
+
const BOUND_COOKIE = "__Host-dbsc-session";
|
|
4
|
+
const REGISTRATION_COOKIE = "__Host-dbsc-reg";
|
|
5
|
+
const CHALLENGE_COOKIE = "__Host-dbsc-challenge";
|
|
6
|
+
const DEFAULT_BOUND_TTL = 10 * 60;
|
|
7
|
+
export function dbsc(opts) {
|
|
8
|
+
const { storage, registrationPath = "/dbsc/registration", refreshPath = "/dbsc/refresh", boundCookieTtl = DEFAULT_BOUND_TTL * 1000, rateLimiter = new NoopRateLimiter(), onEvent, secure = true, } = opts;
|
|
9
|
+
const cookieOpts = {
|
|
10
|
+
httpOnly: true,
|
|
11
|
+
secure,
|
|
12
|
+
sameSite: "lax",
|
|
13
|
+
path: "/",
|
|
14
|
+
};
|
|
15
|
+
return async (c, next) => {
|
|
16
|
+
const url = new URL(c.req.url);
|
|
17
|
+
const ip = c.req.header("x-forwarded-for") ?? "unknown";
|
|
18
|
+
if (c.req.method === "POST" && url.pathname === registrationPath) {
|
|
19
|
+
const sessionId = getCookie(c, REGISTRATION_COOKIE);
|
|
20
|
+
const expectedJti = getCookie(c, CHALLENGE_COOKIE);
|
|
21
|
+
if (!sessionId || !expectedJti) {
|
|
22
|
+
return c.json({ error: "missing session or challenge cookie" }, 400);
|
|
23
|
+
}
|
|
24
|
+
const allowed = await rateLimiter.checkRegistration(ip);
|
|
25
|
+
if (!allowed)
|
|
26
|
+
return c.json({ error: "rate limited" }, 429);
|
|
27
|
+
try {
|
|
28
|
+
const respHdr = c.req.header("secure-session-response") ?? c.req.header("sec-session-response");
|
|
29
|
+
await handleRegistration({
|
|
30
|
+
sessionId,
|
|
31
|
+
secSessionResponseHeader: respHdr,
|
|
32
|
+
expectedJti,
|
|
33
|
+
}, storage);
|
|
34
|
+
emit(onEvent, {
|
|
35
|
+
type: "registration",
|
|
36
|
+
sessionId,
|
|
37
|
+
tier: "dbsc",
|
|
38
|
+
timestamp: Date.now(),
|
|
39
|
+
algorithm: "ES256",
|
|
40
|
+
ip,
|
|
41
|
+
});
|
|
42
|
+
setCookie(c, BOUND_COOKIE, sessionId, {
|
|
43
|
+
...cookieOpts,
|
|
44
|
+
maxAge: boundCookieTtl / 1000,
|
|
45
|
+
});
|
|
46
|
+
deleteCookie(c, CHALLENGE_COOKIE);
|
|
47
|
+
return c.body(null, 204);
|
|
48
|
+
}
|
|
49
|
+
catch (err) {
|
|
50
|
+
await rateLimiter.recordFailure(ip, sessionId);
|
|
51
|
+
if (err instanceof DbscVerificationError || err instanceof DbscProtocolError) {
|
|
52
|
+
return c.json({ error: err.message }, 400);
|
|
53
|
+
}
|
|
54
|
+
throw err;
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
if (c.req.method === "POST" && url.pathname === refreshPath) {
|
|
58
|
+
const sessionId = getCookie(c, BOUND_COOKIE);
|
|
59
|
+
if (!sessionId)
|
|
60
|
+
return c.json({ error: "no session" }, 401);
|
|
61
|
+
const allowed = await rateLimiter.checkRefresh(ip, sessionId);
|
|
62
|
+
if (!allowed)
|
|
63
|
+
return c.json({ error: "rate limited" }, 429);
|
|
64
|
+
const responseHeader = c.req.header("secure-session-response") ?? c.req.header("sec-session-response");
|
|
65
|
+
if (!responseHeader) {
|
|
66
|
+
const challenge = await issueChallenge(sessionId, storage);
|
|
67
|
+
c.header(CHALLENGE_HEADER, buildChallengeHeader(challenge.jti));
|
|
68
|
+
c.header(LEGACY_CHALLENGE_HEADER, buildChallengeHeader(challenge.jti));
|
|
69
|
+
setCookie(c, CHALLENGE_COOKIE, challenge.jti, { ...cookieOpts, maxAge: 5 * 60 });
|
|
70
|
+
return c.body(null, 403);
|
|
71
|
+
}
|
|
72
|
+
const expectedJti = getCookie(c, CHALLENGE_COOKIE);
|
|
73
|
+
if (!expectedJti)
|
|
74
|
+
return c.json({ error: "missing challenge cookie" }, 400);
|
|
75
|
+
try {
|
|
76
|
+
await handleRefresh({ sessionId, secSessionResponseHeader: responseHeader, expectedJti }, storage);
|
|
77
|
+
emit(onEvent, {
|
|
78
|
+
type: "refresh",
|
|
79
|
+
sessionId,
|
|
80
|
+
tier: "dbsc",
|
|
81
|
+
timestamp: Date.now(),
|
|
82
|
+
ip,
|
|
83
|
+
});
|
|
84
|
+
setCookie(c, BOUND_COOKIE, sessionId, { ...cookieOpts, maxAge: boundCookieTtl / 1000 });
|
|
85
|
+
deleteCookie(c, CHALLENGE_COOKIE);
|
|
86
|
+
return c.body(null, 204);
|
|
87
|
+
}
|
|
88
|
+
catch (err) {
|
|
89
|
+
await rateLimiter.recordFailure(ip, sessionId);
|
|
90
|
+
if (err instanceof DbscVerificationError || err instanceof DbscProtocolError) {
|
|
91
|
+
return c.json({ error: err.message }, 401);
|
|
92
|
+
}
|
|
93
|
+
throw err;
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
const sessionId = getCookie(c, BOUND_COOKIE) ?? null;
|
|
97
|
+
c.set("dbscSessionId", sessionId);
|
|
98
|
+
c.set("dbscTier", "none");
|
|
99
|
+
if (sessionId) {
|
|
100
|
+
const session = await storage.getSession(sessionId);
|
|
101
|
+
if (session)
|
|
102
|
+
c.set("dbscTier", session.tier);
|
|
103
|
+
}
|
|
104
|
+
await next();
|
|
105
|
+
};
|
|
106
|
+
}
|
|
107
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hono/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
ADDED