@kya-os/checkpoint-shared 1.4.0 → 1.5.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/CHANGELOG.md +41 -0
- package/dist/beacon-types/index.d.mts +448 -432
- package/dist/beacon-types/index.d.mts.map +1 -0
- package/dist/beacon-types/index.d.ts +448 -432
- package/dist/beacon-types/index.d.ts.map +1 -0
- package/dist/beacon-types/index.js +286 -182
- package/dist/beacon-types/index.mjs +284 -180
- package/dist/beacon-types/index.mjs.map +1 -0
- package/dist/browser-posture-cookie-Dmq9Brf_.d.mts +5 -0
- package/dist/browser-posture-cookie-Dmq9Brf_.d.mts.map +1 -0
- package/dist/browser-posture-cookie-Dmq9Brf_.d.ts +5 -0
- package/dist/browser-posture-cookie-Dmq9Brf_.d.ts.map +1 -0
- package/dist/browser-posture-cookie.d.mts +2 -0
- package/dist/browser-posture-cookie.d.ts +2 -0
- package/dist/browser-posture-cookie.js +1 -0
- package/dist/browser-posture-cookie.mjs +2 -0
- package/dist/browser-posture-cookie.mjs.map +1 -0
- package/dist/browser-posture-report.d.mts +48 -44
- package/dist/browser-posture-report.d.mts.map +1 -0
- package/dist/browser-posture-report.d.ts +48 -44
- package/dist/browser-posture-report.d.ts.map +1 -0
- package/dist/browser-posture-report.js +1 -1
- package/dist/browser-posture-report.mjs +2 -1
- package/dist/browser-posture-report.mjs.map +1 -0
- package/dist/browser-posture.d.mts +82 -75
- package/dist/browser-posture.d.mts.map +1 -0
- package/dist/browser-posture.d.ts +82 -75
- package/dist/browser-posture.d.ts.map +1 -0
- package/dist/browser-posture.js +167 -18993
- package/dist/browser-posture.mjs +166 -18990
- package/dist/browser-posture.mjs.map +1 -0
- package/dist/browser.d.mts +323 -316
- package/dist/browser.d.mts.map +1 -0
- package/dist/browser.d.ts +323 -316
- package/dist/browser.d.ts.map +1 -0
- package/dist/browser.js +1 -1
- package/dist/browser.mjs +2 -1
- package/dist/browser.mjs.map +1 -0
- package/dist/canonical-signer/index.d.mts +38 -33
- package/dist/canonical-signer/index.d.mts.map +1 -0
- package/dist/canonical-signer/index.d.ts +38 -33
- package/dist/canonical-signer/index.d.ts.map +1 -0
- package/dist/canonical-signer/index.js +411 -181
- package/dist/canonical-signer/index.mjs +383 -175
- package/dist/canonical-signer/index.mjs.map +1 -0
- package/dist/clearance.d.mts +30 -0
- package/dist/clearance.d.mts.map +1 -0
- package/dist/clearance.d.ts +30 -0
- package/dist/clearance.d.ts.map +1 -0
- package/dist/clearance.js +120 -0
- package/dist/clearance.mjs +112 -0
- package/dist/clearance.mjs.map +1 -0
- package/dist/client-ip-1y2iXAYW.js +237 -0
- package/dist/client-ip-HOfe6ucV.mjs +215 -0
- package/dist/client-ip-HOfe6ucV.mjs.map +1 -0
- package/dist/deploy/index.d.mts +339 -339
- package/dist/deploy/index.d.mts.map +1 -0
- package/dist/deploy/index.d.ts +339 -339
- package/dist/deploy/index.d.ts.map +1 -0
- package/dist/deploy/index.js +505 -413
- package/dist/deploy/index.mjs +504 -410
- package/dist/deploy/index.mjs.map +1 -0
- package/dist/errors/index.d.mts +101 -101
- package/dist/errors/index.d.mts.map +1 -0
- package/dist/errors/index.d.ts +101 -101
- package/dist/errors/index.d.ts.map +1 -0
- package/dist/errors/index.js +341 -314
- package/dist/errors/index.mjs +340 -311
- package/dist/errors/index.mjs.map +1 -0
- package/dist/external-jr_S4iSS.d.mts +4187 -0
- package/dist/external-jr_S4iSS.d.mts.map +1 -0
- package/dist/external-jr_S4iSS.d.ts +4187 -0
- package/dist/external-jr_S4iSS.d.ts.map +1 -0
- package/dist/gateway/index.d.mts +138 -132
- package/dist/gateway/index.d.mts.map +1 -0
- package/dist/gateway/index.d.ts +138 -132
- package/dist/gateway/index.d.ts.map +1 -0
- package/dist/gateway/index.js +117 -81
- package/dist/gateway/index.mjs +116 -78
- package/dist/gateway/index.mjs.map +1 -0
- package/dist/gateway-client-ip.d.mts +59 -0
- package/dist/gateway-client-ip.d.mts.map +1 -0
- package/dist/gateway-client-ip.d.ts +59 -0
- package/dist/gateway-client-ip.d.ts.map +1 -0
- package/dist/gateway-client-ip.js +149 -0
- package/dist/gateway-client-ip.mjs +139 -0
- package/dist/gateway-client-ip.mjs.map +1 -0
- package/dist/index.d.mts +14901 -14246
- package/dist/index.d.mts.map +1 -0
- package/dist/index.d.ts +14901 -14246
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +15180 -31025
- package/dist/index.mjs +15065 -30942
- package/dist/index.mjs.map +1 -0
- package/dist/mcpi/agentshield-api/index.d.mts +45 -44
- package/dist/mcpi/agentshield-api/index.d.mts.map +1 -0
- package/dist/mcpi/agentshield-api/index.d.ts +45 -44
- package/dist/mcpi/agentshield-api/index.d.ts.map +1 -0
- package/dist/mcpi/agentshield-api/index.js +0 -2
- package/dist/mcpi/agentshield-api/index.mjs +1 -1
- package/dist/mcpi/approval-grant/index.d.mts +63 -61
- package/dist/mcpi/approval-grant/index.d.mts.map +1 -0
- package/dist/mcpi/approval-grant/index.d.ts +63 -61
- package/dist/mcpi/approval-grant/index.d.ts.map +1 -0
- package/dist/mcpi/approval-grant/index.js +220 -140
- package/dist/mcpi/approval-grant/index.mjs +219 -137
- package/dist/mcpi/approval-grant/index.mjs.map +1 -0
- package/dist/mcpi/dashboard-config/index.d.mts +2323 -2318
- package/dist/mcpi/dashboard-config/index.d.mts.map +1 -0
- package/dist/mcpi/dashboard-config/index.d.ts +2323 -2318
- package/dist/mcpi/dashboard-config/index.d.ts.map +1 -0
- package/dist/mcpi/dashboard-config/index.js +605 -458
- package/dist/mcpi/dashboard-config/index.mjs +604 -455
- package/dist/mcpi/dashboard-config/index.mjs.map +1 -0
- package/dist/mcpi/multibase-ed25519.d.mts +10 -8
- package/dist/mcpi/multibase-ed25519.d.mts.map +1 -0
- package/dist/mcpi/multibase-ed25519.d.ts +10 -8
- package/dist/mcpi/multibase-ed25519.d.ts.map +1 -0
- package/dist/mcpi/multibase-ed25519.js +182 -106
- package/dist/mcpi/multibase-ed25519.mjs +181 -103
- package/dist/mcpi/multibase-ed25519.mjs.map +1 -0
- package/dist/patterns-CkRVOdtV.js +243 -0
- package/dist/patterns-DzkGy_qk.mjs +173 -0
- package/dist/patterns-DzkGy_qk.mjs.map +1 -0
- package/dist/project-verification-key-C3L5rd8a.js +41 -0
- package/dist/project-verification-key-CgSVX9_m.mjs +37 -0
- package/dist/project-verification-key-CgSVX9_m.mjs.map +1 -0
- package/dist/rolldown-runtime-iY2fYEqi.mjs +19 -0
- package/dist/schemas-BmjNLAE7.js +5677 -0
- package/dist/schemas-DxY-dk9y.mjs +5511 -0
- package/dist/schemas-DxY-dk9y.mjs.map +1 -0
- package/dist/signals/index.d.mts +125 -115
- package/dist/signals/index.d.mts.map +1 -0
- package/dist/signals/index.d.ts +125 -115
- package/dist/signals/index.d.ts.map +1 -0
- package/dist/signals/index.js +1693 -1536
- package/dist/signals/index.mjs +1692 -1533
- package/dist/signals/index.mjs.map +1 -0
- package/dist/test-fixtures/index.d.mts +124 -119
- package/dist/test-fixtures/index.d.mts.map +1 -0
- package/dist/test-fixtures/index.d.ts +124 -119
- package/dist/test-fixtures/index.d.ts.map +1 -0
- package/dist/test-fixtures/index.js +460 -228
- package/dist/test-fixtures/index.mjs +459 -225
- package/dist/test-fixtures/index.mjs.map +1 -0
- package/dist/tool-protection/index.d.mts +343 -343
- package/dist/tool-protection/index.d.mts.map +1 -0
- package/dist/tool-protection/index.d.ts +343 -343
- package/dist/tool-protection/index.d.ts.map +1 -0
- package/dist/tool-protection/index.js +366 -285
- package/dist/tool-protection/index.mjs +365 -282
- package/dist/tool-protection/index.mjs.map +1 -0
- package/fixtures/bot-signal-resolution.json +142 -0
- package/fixtures/browser-posture-claims.json +421 -0
- package/fixtures/browser-posture-headers.json +46 -0
- package/fixtures/detection/reason-codes.json +10 -1
- package/fixtures/kya-http/challenge.delegation.fetcher-200.json +9 -3
- package/fixtures/kya-http/challenge.delegation.full.json +9 -3
- package/fixtures/kya-http/challenge.delegation.minimal.json +9 -3
- package/fixtures/kya-http/error-codes.json +7 -2
- package/package.json +20 -6
package/dist/gateway/index.mjs
CHANGED
|
@@ -1,91 +1,129 @@
|
|
|
1
|
-
import { z } from
|
|
1
|
+
import { z } from "zod";
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
3
|
+
//#region src/gateway/skills.ts
|
|
4
|
+
const skillRequirementsSchema = z.object({
|
|
5
|
+
bins: z.array(z.string()).optional(),
|
|
6
|
+
envs: z.array(z.string()).optional(),
|
|
7
|
+
configs: z.array(z.string()).optional(),
|
|
8
|
+
os: z.array(z.string()).optional()
|
|
9
9
|
});
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
10
|
+
const skillConfigCheckSchema = z.object({
|
|
11
|
+
path: z.string(),
|
|
12
|
+
label: z.string().optional(),
|
|
13
|
+
satisfied: z.boolean()
|
|
14
14
|
});
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
15
|
+
const skillInstallOptionSchema = z.object({
|
|
16
|
+
id: z.string(),
|
|
17
|
+
kind: z.enum([
|
|
18
|
+
"brew",
|
|
19
|
+
"node",
|
|
20
|
+
"go",
|
|
21
|
+
"uv",
|
|
22
|
+
"download"
|
|
23
|
+
]),
|
|
24
|
+
label: z.string(),
|
|
25
|
+
bins: z.array(z.string())
|
|
20
26
|
});
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
27
|
+
const skillStatusEntrySchema = z.object({
|
|
28
|
+
name: z.string(),
|
|
29
|
+
description: z.string(),
|
|
30
|
+
source: z.string(),
|
|
31
|
+
bundled: z.boolean(),
|
|
32
|
+
filePath: z.string(),
|
|
33
|
+
baseDir: z.string(),
|
|
34
|
+
skillKey: z.string(),
|
|
35
|
+
primaryEnv: z.string().optional(),
|
|
36
|
+
emoji: z.string().optional(),
|
|
37
|
+
homepage: z.string().optional(),
|
|
38
|
+
always: z.boolean(),
|
|
39
|
+
disabled: z.boolean(),
|
|
40
|
+
blockedByAllowlist: z.boolean(),
|
|
41
|
+
eligible: z.boolean(),
|
|
42
|
+
requirements: skillRequirementsSchema,
|
|
43
|
+
missing: skillRequirementsSchema,
|
|
44
|
+
configChecks: z.array(skillConfigCheckSchema),
|
|
45
|
+
install: z.array(skillInstallOptionSchema)
|
|
40
46
|
});
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
47
|
+
const skillStatusReportSchema = z.object({
|
|
48
|
+
workspaceDir: z.string(),
|
|
49
|
+
managedSkillsDir: z.string(),
|
|
50
|
+
skills: z.array(skillStatusEntrySchema)
|
|
45
51
|
});
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
52
|
+
|
|
53
|
+
//#endregion
|
|
54
|
+
//#region src/gateway/sessions.ts
|
|
55
|
+
const sessionEntrySchema = z.object({
|
|
56
|
+
key: z.string(),
|
|
57
|
+
agentId: z.string().optional(),
|
|
58
|
+
label: z.string().optional(),
|
|
59
|
+
channel: z.string().optional(),
|
|
60
|
+
kind: z.string().optional(),
|
|
61
|
+
createdAt: z.number().optional(),
|
|
62
|
+
updatedAt: z.number().optional(),
|
|
63
|
+
messageCount: z.number().optional()
|
|
55
64
|
});
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
65
|
+
|
|
66
|
+
//#endregion
|
|
67
|
+
//#region src/gateway/cron.ts
|
|
68
|
+
const cronJobSchema = z.object({
|
|
69
|
+
name: z.string(),
|
|
70
|
+
schedule: z.string().optional(),
|
|
71
|
+
enabled: z.boolean(),
|
|
72
|
+
lastRunAt: z.number().optional().nullable(),
|
|
73
|
+
nextRunAt: z.number().optional().nullable(),
|
|
74
|
+
lastStatus: z.string().optional().nullable(),
|
|
75
|
+
agentId: z.string().optional(),
|
|
76
|
+
model: z.string().optional().nullable(),
|
|
77
|
+
task: z.string().optional()
|
|
66
78
|
});
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
79
|
+
|
|
80
|
+
//#endregion
|
|
81
|
+
//#region src/gateway/agents.ts
|
|
82
|
+
const agentEntrySchema = z.object({
|
|
83
|
+
id: z.string(),
|
|
84
|
+
name: z.string().optional(),
|
|
85
|
+
model: z.string().optional(),
|
|
86
|
+
defaultModel: z.string().optional(),
|
|
87
|
+
persona: z.string().optional()
|
|
73
88
|
});
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
89
|
+
|
|
90
|
+
//#endregion
|
|
91
|
+
//#region src/gateway/usage.ts
|
|
92
|
+
const usageCostSchema = z.object({
|
|
93
|
+
totalCostUsd: z.number().optional(),
|
|
94
|
+
periodStart: z.string().optional(),
|
|
95
|
+
periodEnd: z.string().optional(),
|
|
96
|
+
byModel: z.array(z.object({
|
|
97
|
+
model: z.string(),
|
|
98
|
+
inputTokens: z.number(),
|
|
99
|
+
outputTokens: z.number(),
|
|
100
|
+
costUsd: z.number()
|
|
101
|
+
})).optional()
|
|
86
102
|
});
|
|
87
103
|
|
|
88
|
-
|
|
89
|
-
|
|
104
|
+
//#endregion
|
|
105
|
+
//#region src/gateway/protocol.ts
|
|
106
|
+
/**
|
|
107
|
+
* OpenClaw gateway WebSocket protocol range advertised in the `connect` frame.
|
|
108
|
+
*
|
|
109
|
+
* OpenClaw 2026.7.x gateways (the current kya-openclaw image) accept a
|
|
110
|
+
* non-probe client only when `maxProtocol >= 4 && minProtocol <= 4` and
|
|
111
|
+
* otherwise close the socket with `protocol mismatch ... expected=4`.
|
|
112
|
+
* OpenClaw 2026.5.x gateways negotiate 3. Advertising 3..4 keeps both
|
|
113
|
+
* generations reachable: a v4 gateway answers `hello-ok protocol=4`, a v3
|
|
114
|
+
* gateway answers `hello-ok protocol=3`.
|
|
115
|
+
*
|
|
116
|
+
* Every Checkpoint client that opens a gateway socket (the dashboard admin WS
|
|
117
|
+
* in the browser, the Scout dispatcher on the server) must spread this into
|
|
118
|
+
* its connect params rather than pinning its own literals.
|
|
119
|
+
*
|
|
120
|
+
* @module @kya-os/checkpoint-shared/gateway/protocol
|
|
121
|
+
*/
|
|
122
|
+
const OPENCLAW_PROTOCOL_RANGE = {
|
|
123
|
+
minProtocol: 3,
|
|
124
|
+
maxProtocol: 4
|
|
125
|
+
};
|
|
90
126
|
|
|
127
|
+
//#endregion
|
|
91
128
|
export { OPENCLAW_PROTOCOL_RANGE, agentEntrySchema, cronJobSchema, sessionEntrySchema, skillConfigCheckSchema, skillInstallOptionSchema, skillRequirementsSchema, skillStatusEntrySchema, skillStatusReportSchema, usageCostSchema };
|
|
129
|
+
//# sourceMappingURL=index.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.mjs","names":[],"sources":["../../src/gateway/skills.ts","../../src/gateway/sessions.ts","../../src/gateway/cron.ts","../../src/gateway/agents.ts","../../src/gateway/usage.ts","../../src/gateway/protocol.ts"],"sourcesContent":["import { z } from 'zod';\n\n// ── skills.status ──\n\nexport const skillRequirementsSchema = z.object({\n bins: z.array(z.string()).optional(),\n envs: z.array(z.string()).optional(),\n configs: z.array(z.string()).optional(),\n os: z.array(z.string()).optional(),\n});\n\nexport type SkillRequirements = z.infer<typeof skillRequirementsSchema>;\n\nexport const skillConfigCheckSchema = z.object({\n path: z.string(),\n label: z.string().optional(),\n satisfied: z.boolean(),\n});\n\nexport type SkillConfigCheck = z.infer<typeof skillConfigCheckSchema>;\n\nexport const skillInstallOptionSchema = z.object({\n id: z.string(),\n kind: z.enum(['brew', 'node', 'go', 'uv', 'download']),\n label: z.string(),\n bins: z.array(z.string()),\n});\n\nexport type SkillInstallOption = z.infer<typeof skillInstallOptionSchema>;\n\nexport const skillStatusEntrySchema = z.object({\n name: z.string(),\n description: z.string(),\n source: z.string(),\n bundled: z.boolean(),\n filePath: z.string(),\n baseDir: z.string(),\n skillKey: z.string(),\n primaryEnv: z.string().optional(),\n emoji: z.string().optional(),\n homepage: z.string().optional(),\n always: z.boolean(),\n disabled: z.boolean(),\n blockedByAllowlist: z.boolean(),\n eligible: z.boolean(),\n requirements: skillRequirementsSchema,\n missing: skillRequirementsSchema,\n configChecks: z.array(skillConfigCheckSchema),\n install: z.array(skillInstallOptionSchema),\n});\n\nexport type SkillStatusEntry = z.infer<typeof skillStatusEntrySchema>;\n\nexport const skillStatusReportSchema = z.object({\n workspaceDir: z.string(),\n managedSkillsDir: z.string(),\n skills: z.array(skillStatusEntrySchema),\n});\n\nexport type SkillStatusReport = z.infer<typeof skillStatusReportSchema>;\n","import { z } from 'zod';\n\n// ── sessions.list ──\n\nexport const sessionEntrySchema = z.object({\n key: z.string(),\n agentId: z.string().optional(),\n label: z.string().optional(),\n channel: z.string().optional(),\n kind: z.string().optional(),\n createdAt: z.number().optional(),\n updatedAt: z.number().optional(),\n messageCount: z.number().optional(),\n});\n\nexport type SessionEntry = z.infer<typeof sessionEntrySchema>;\n","import { z } from 'zod';\n\n// ── cron.list ──\n\nexport const cronJobSchema = z.object({\n name: z.string(),\n schedule: z.string().optional(),\n enabled: z.boolean(),\n lastRunAt: z.number().optional().nullable(),\n nextRunAt: z.number().optional().nullable(),\n lastStatus: z.string().optional().nullable(),\n agentId: z.string().optional(),\n model: z.string().optional().nullable(),\n task: z.string().optional(),\n});\n\nexport type CronJob = z.infer<typeof cronJobSchema>;\n","import { z } from 'zod';\n\n// ── agents.list ──\n\nexport const agentEntrySchema = z.object({\n id: z.string(),\n name: z.string().optional(),\n model: z.string().optional(),\n defaultModel: z.string().optional(),\n persona: z.string().optional(),\n});\n\nexport type AgentEntry = z.infer<typeof agentEntrySchema>;\n","import { z } from 'zod';\n\n// ── usage.cost ──\n\nexport const usageCostSchema = z.object({\n totalCostUsd: z.number().optional(),\n periodStart: z.string().optional(),\n periodEnd: z.string().optional(),\n byModel: z\n .array(\n z.object({\n model: z.string(),\n inputTokens: z.number(),\n outputTokens: z.number(),\n costUsd: z.number(),\n })\n )\n .optional(),\n});\n\nexport type UsageCost = z.infer<typeof usageCostSchema>;\n","/**\n * OpenClaw gateway WebSocket protocol range advertised in the `connect` frame.\n *\n * OpenClaw 2026.7.x gateways (the current kya-openclaw image) accept a\n * non-probe client only when `maxProtocol >= 4 && minProtocol <= 4` and\n * otherwise close the socket with `protocol mismatch ... expected=4`.\n * OpenClaw 2026.5.x gateways negotiate 3. Advertising 3..4 keeps both\n * generations reachable: a v4 gateway answers `hello-ok protocol=4`, a v3\n * gateway answers `hello-ok protocol=3`.\n *\n * Every Checkpoint client that opens a gateway socket (the dashboard admin WS\n * in the browser, the Scout dispatcher on the server) must spread this into\n * its connect params rather than pinning its own literals.\n *\n * @module @kya-os/checkpoint-shared/gateway/protocol\n */\nexport const OPENCLAW_PROTOCOL_RANGE = { minProtocol: 3, maxProtocol: 4 } as const;\n"],"mappings":"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"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { C as ZodObject, O as ZodString, P as output, R as $strip, S as ZodNumber, b as ZodLiteral, t as external_d_exports } from "./external-jr_S4iSS.mjs";
|
|
2
|
+
import { JWK, JWK as JWK$1, KeyLike, KeyLike as KeyLike$1 } from "jose";
|
|
3
|
+
//#region src/gateway-client-ip.d.ts
|
|
4
|
+
export declare const GATEWAY_CLIENT_IP_TOKEN_HEADER = "KYA-Client-IP-Token";
|
|
5
|
+
export declare const GATEWAY_CLIENT_IP_ISSUER = "checkpoint:gateway-client-ip:v1";
|
|
6
|
+
export declare const GATEWAY_CLIENT_IP_TYPE = "checkpoint-client-ip+jwt";
|
|
7
|
+
export declare const GATEWAY_CLIENT_IP_TTL_SECONDS = 60;
|
|
8
|
+
export declare function isIpLiteral(value: string): boolean;
|
|
9
|
+
export declare const GatewayClientIpClaimsSchema: ZodObject<{
|
|
10
|
+
iss: ZodLiteral<"checkpoint:gateway-client-ip:v1">;
|
|
11
|
+
aud: ZodString;
|
|
12
|
+
ip: ZodString;
|
|
13
|
+
cid: ZodString;
|
|
14
|
+
host: ZodString;
|
|
15
|
+
iat: ZodNumber;
|
|
16
|
+
exp: ZodNumber;
|
|
17
|
+
}, $strip>;
|
|
18
|
+
export type GatewayClientIpClaims = output<typeof GatewayClientIpClaimsSchema>;
|
|
19
|
+
export interface GatewayClientIpInput {
|
|
20
|
+
aud: string;
|
|
21
|
+
ip: string;
|
|
22
|
+
cid: string;
|
|
23
|
+
host: string;
|
|
24
|
+
}
|
|
25
|
+
export declare const GatewayClientIpPublicJwkSchema: ZodObject<{
|
|
26
|
+
kty: ZodLiteral<"EC">;
|
|
27
|
+
crv: ZodLiteral<"P-256">;
|
|
28
|
+
alg: ZodLiteral<"ES256">;
|
|
29
|
+
use: ZodLiteral<"sig">;
|
|
30
|
+
kid: ZodString;
|
|
31
|
+
x: ZodString;
|
|
32
|
+
y: ZodString;
|
|
33
|
+
}, $strip>;
|
|
34
|
+
export type GatewayClientIpPublicJwk = output<typeof GatewayClientIpPublicJwkSchema>;
|
|
35
|
+
export declare const GatewayClientIpPrivateJwkSchema: ZodObject<{
|
|
36
|
+
kty: ZodLiteral<"EC">;
|
|
37
|
+
crv: ZodLiteral<"P-256">;
|
|
38
|
+
alg: ZodLiteral<"ES256">;
|
|
39
|
+
use: ZodLiteral<"sig">;
|
|
40
|
+
kid: ZodString;
|
|
41
|
+
x: ZodString;
|
|
42
|
+
y: ZodString;
|
|
43
|
+
d: ZodString;
|
|
44
|
+
}, $strip>;
|
|
45
|
+
export type GatewayClientIpPrivateJwk = output<typeof GatewayClientIpPrivateJwkSchema>;
|
|
46
|
+
export declare function importGatewayClientIpSigningKey(jwk: JWK$1): Promise<KeyLike$1 | Uint8Array>;
|
|
47
|
+
export declare function signGatewayClientIp(privateKey: KeyLike$1 | Uint8Array, kid: string, input: GatewayClientIpInput, now?: number): Promise<string>;
|
|
48
|
+
export interface VerifyGatewayClientIpOptions {
|
|
49
|
+
projectId: string;
|
|
50
|
+
expectedCid: string;
|
|
51
|
+
expectedHost: string;
|
|
52
|
+
now?: number;
|
|
53
|
+
}
|
|
54
|
+
export declare function verifyGatewayClientIp(token: string | undefined | null, jwks: {
|
|
55
|
+
keys: JWK$1[];
|
|
56
|
+
}, options: VerifyGatewayClientIpOptions): Promise<GatewayClientIpClaims | null>;
|
|
57
|
+
//#endregion
|
|
58
|
+
export type { JWK, KeyLike };
|
|
59
|
+
//# sourceMappingURL=gateway-client-ip.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gateway-client-ip.d.mts","names":[],"sources":["../src/gateway-client-ip.ts"],"mappings":";;;qBA2Ba;qBACA;qBACA;qBAYA;wBAaG,YAAY;qBAOf,6BAA2B;;;;;;;;GAQtC;YACU,wBAAwB,cAAe;iBAElC;EACf;EACA;EACA;EACA;;qBAIW,gCAA8B;;;;;;;;GAQzC;YACU,2BAA2B,cAAe;qBAGzC,iCAA+B;;;;;;;;;GAE1C;YACU,4BAA4B,cAAe;wBAQjC,gCAAgC,KAAK,QAAM,QAAQ,YAAU;wBAU7D,oBACpB,YAAY,YAAU,YACtB,aACA,OAAO,sBACP,eACC;iBAkBc;EAEf;EAQA;EAYA;EACA;;wBAWoB,sBACpB,kCACA;EAAQ,MAAM;GACd,SAAS,+BACR,QAAQ"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { C as ZodObject, O as ZodString, P as output, R as $strip, S as ZodNumber, b as ZodLiteral, t as external_d_exports } from "./external-jr_S4iSS.js";
|
|
2
|
+
import { JWK, JWK as JWK$1, KeyLike, KeyLike as KeyLike$1 } from "jose";
|
|
3
|
+
//#region src/gateway-client-ip.d.ts
|
|
4
|
+
export declare const GATEWAY_CLIENT_IP_TOKEN_HEADER = "KYA-Client-IP-Token";
|
|
5
|
+
export declare const GATEWAY_CLIENT_IP_ISSUER = "checkpoint:gateway-client-ip:v1";
|
|
6
|
+
export declare const GATEWAY_CLIENT_IP_TYPE = "checkpoint-client-ip+jwt";
|
|
7
|
+
export declare const GATEWAY_CLIENT_IP_TTL_SECONDS = 60;
|
|
8
|
+
export declare function isIpLiteral(value: string): boolean;
|
|
9
|
+
export declare const GatewayClientIpClaimsSchema: ZodObject<{
|
|
10
|
+
iss: ZodLiteral<"checkpoint:gateway-client-ip:v1">;
|
|
11
|
+
aud: ZodString;
|
|
12
|
+
ip: ZodString;
|
|
13
|
+
cid: ZodString;
|
|
14
|
+
host: ZodString;
|
|
15
|
+
iat: ZodNumber;
|
|
16
|
+
exp: ZodNumber;
|
|
17
|
+
}, $strip>;
|
|
18
|
+
export type GatewayClientIpClaims = output<typeof GatewayClientIpClaimsSchema>;
|
|
19
|
+
export interface GatewayClientIpInput {
|
|
20
|
+
aud: string;
|
|
21
|
+
ip: string;
|
|
22
|
+
cid: string;
|
|
23
|
+
host: string;
|
|
24
|
+
}
|
|
25
|
+
export declare const GatewayClientIpPublicJwkSchema: ZodObject<{
|
|
26
|
+
kty: ZodLiteral<"EC">;
|
|
27
|
+
crv: ZodLiteral<"P-256">;
|
|
28
|
+
alg: ZodLiteral<"ES256">;
|
|
29
|
+
use: ZodLiteral<"sig">;
|
|
30
|
+
kid: ZodString;
|
|
31
|
+
x: ZodString;
|
|
32
|
+
y: ZodString;
|
|
33
|
+
}, $strip>;
|
|
34
|
+
export type GatewayClientIpPublicJwk = output<typeof GatewayClientIpPublicJwkSchema>;
|
|
35
|
+
export declare const GatewayClientIpPrivateJwkSchema: ZodObject<{
|
|
36
|
+
kty: ZodLiteral<"EC">;
|
|
37
|
+
crv: ZodLiteral<"P-256">;
|
|
38
|
+
alg: ZodLiteral<"ES256">;
|
|
39
|
+
use: ZodLiteral<"sig">;
|
|
40
|
+
kid: ZodString;
|
|
41
|
+
x: ZodString;
|
|
42
|
+
y: ZodString;
|
|
43
|
+
d: ZodString;
|
|
44
|
+
}, $strip>;
|
|
45
|
+
export type GatewayClientIpPrivateJwk = output<typeof GatewayClientIpPrivateJwkSchema>;
|
|
46
|
+
export declare function importGatewayClientIpSigningKey(jwk: JWK$1): Promise<KeyLike$1 | Uint8Array>;
|
|
47
|
+
export declare function signGatewayClientIp(privateKey: KeyLike$1 | Uint8Array, kid: string, input: GatewayClientIpInput, now?: number): Promise<string>;
|
|
48
|
+
export interface VerifyGatewayClientIpOptions {
|
|
49
|
+
projectId: string;
|
|
50
|
+
expectedCid: string;
|
|
51
|
+
expectedHost: string;
|
|
52
|
+
now?: number;
|
|
53
|
+
}
|
|
54
|
+
export declare function verifyGatewayClientIp(token: string | undefined | null, jwks: {
|
|
55
|
+
keys: JWK$1[];
|
|
56
|
+
}, options: VerifyGatewayClientIpOptions): Promise<GatewayClientIpClaims | null>;
|
|
57
|
+
//#endregion
|
|
58
|
+
export type { JWK, KeyLike };
|
|
59
|
+
//# sourceMappingURL=gateway-client-ip.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gateway-client-ip.d.ts","names":[],"sources":["../src/gateway-client-ip.ts"],"mappings":";;;qBA2Ba;qBACA;qBACA;qBAYA;wBAaG,YAAY;qBAOf,6BAA2B;;;;;;;;GAQtC;YACU,wBAAwB,cAAe;iBAElC;EACf;EACA;EACA;EACA;;qBAIW,gCAA8B;;;;;;;;GAQzC;YACU,2BAA2B,cAAe;qBAGzC,iCAA+B;;;;;;;;;GAE1C;YACU,4BAA4B,cAAe;wBAQjC,gCAAgC,KAAK,QAAM,QAAQ,YAAU;wBAU7D,oBACpB,YAAY,YAAU,YACtB,aACA,OAAO,sBACP,eACC;iBAkBc;EAEf;EAQA;EAYA;EACA;;wBAWoB,sBACpB,kCACA;EAAQ,MAAM;GACd,SAAS,+BACR,QAAQ"}
|
|
@@ -0,0 +1,149 @@
|
|
|
1
|
+
Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
|
|
2
|
+
const require_schemas = require('./schemas-BmjNLAE7.js');
|
|
3
|
+
const require_client_ip = require('./client-ip-1y2iXAYW.js');
|
|
4
|
+
let jose = require("jose");
|
|
5
|
+
|
|
6
|
+
//#region src/gateway-client-ip.ts
|
|
7
|
+
/**
|
|
8
|
+
* Signed client-identity token minted by the Checkpoint Cloudflare gateway
|
|
9
|
+
* worker and verified by an origin-side Checkpoint SDK (KYA-1121 follow-up).
|
|
10
|
+
*
|
|
11
|
+
* The gateway already forwards the connecting IP as the plain `KYA-Client-IP`
|
|
12
|
+
* / `X-Forwarded-For` headers (see `proxy.ts`), which every adapter behind a
|
|
13
|
+
* KNOWN, trusted peer (Cloudflare's own published edge ranges) can trust.
|
|
14
|
+
* Behind an additional untrusted hop - e.g. a PaaS's own reverse proxy
|
|
15
|
+
* (Railway, Render, Fly) sitting between Cloudflare and the origin - the
|
|
16
|
+
* origin's TCP peer is that PaaS's proxy, not Cloudflare, so the plain
|
|
17
|
+
* header can never be trusted there: any caller reaching the PaaS's edge
|
|
18
|
+
* directly could set it too. This ES256-signed JWS carries the SAME claim
|
|
19
|
+
* with a signature only the gateway's private key can produce, so an origin
|
|
20
|
+
* can trust it regardless of what sits between it and the gateway.
|
|
21
|
+
*
|
|
22
|
+
* One gateway-wide asymmetric key (not a per-project secret): the worker
|
|
23
|
+
* holds the private JWK (`GATEWAY_CLIENT_IP_SIGNING_JWK`), the platform
|
|
24
|
+
* publishes the public JWK at `/.well-known/jwks.json`
|
|
25
|
+
* (`GATEWAY_CLIENT_IP_PUBLIC_JWK`). Rotation is by `kid`.
|
|
26
|
+
*/
|
|
27
|
+
const GATEWAY_CLIENT_IP_TOKEN_HEADER = "KYA-Client-IP-Token";
|
|
28
|
+
const GATEWAY_CLIENT_IP_ISSUER = "checkpoint:gateway-client-ip:v1";
|
|
29
|
+
const GATEWAY_CLIENT_IP_TYPE = "checkpoint-client-ip+jwt";
|
|
30
|
+
/**
|
|
31
|
+
* Token lifetime, seconds. A verifier MUST additionally bind `cid`/`host` to
|
|
32
|
+
* the request it's verifying (see {@link VerifyGatewayClientIpOptions}) -
|
|
33
|
+
* without that binding, a token captured on an untrusted hop within this
|
|
34
|
+
* window is replayable onto a DIFFERENT request the gateway never actually
|
|
35
|
+
* saw, and the `ip` it carries is not inert: it feeds the same IP-reputation
|
|
36
|
+
* and vendor-cross-match signals as any other resolved client IP, which do
|
|
37
|
+
* influence the engine's enforcement decision. Binding `cid` (unique per
|
|
38
|
+
* request) is what keeps a captured token scoped to the one request the
|
|
39
|
+
* gateway minted it for.
|
|
40
|
+
*/
|
|
41
|
+
const GATEWAY_CLIENT_IP_TTL_SECONDS = 60;
|
|
42
|
+
/** Clock-skew allowance applied to `exp` (via jose's `clockTolerance`) and independently to `iat` below. */
|
|
43
|
+
const CLOCK_SKEW_SECONDS = 30;
|
|
44
|
+
function isIpv4Literal(value) {
|
|
45
|
+
const parts = value.split(".");
|
|
46
|
+
return parts.length === 4 && parts.every((part) => /^(0|[1-9]\d{0,2})$/.test(part) && Number(part) <= 255);
|
|
47
|
+
}
|
|
48
|
+
/** True when `value` is a literal IPv4 or IPv6 address - never resolves a hostname. */
|
|
49
|
+
function isIpLiteral(value) {
|
|
50
|
+
return isIpv4Literal(value) || require_client_ip.parseIpv6(value) !== null;
|
|
51
|
+
}
|
|
52
|
+
const GatewayClientIpClaimsSchema = require_schemas.object({
|
|
53
|
+
iss: require_schemas.literal(GATEWAY_CLIENT_IP_ISSUER),
|
|
54
|
+
aud: require_schemas.string().min(1),
|
|
55
|
+
ip: require_schemas.string().refine(isIpLiteral, "ip must be a literal IPv4 or IPv6 address"),
|
|
56
|
+
cid: require_schemas.string().min(1),
|
|
57
|
+
host: require_schemas.string().min(1),
|
|
58
|
+
iat: require_schemas.number().int().nonnegative(),
|
|
59
|
+
exp: require_schemas.number().int().positive()
|
|
60
|
+
});
|
|
61
|
+
/** The gateway's own EC P-256 public key, as published in `/.well-known/jwks.json`. */
|
|
62
|
+
const GatewayClientIpPublicJwkSchema = require_schemas.object({
|
|
63
|
+
kty: require_schemas.literal("EC"),
|
|
64
|
+
crv: require_schemas.literal("P-256"),
|
|
65
|
+
alg: require_schemas.literal("ES256"),
|
|
66
|
+
use: require_schemas.literal("sig"),
|
|
67
|
+
kid: require_schemas.string().min(1),
|
|
68
|
+
x: require_schemas.string().min(1),
|
|
69
|
+
y: require_schemas.string().min(1)
|
|
70
|
+
});
|
|
71
|
+
/** The private half the gateway worker holds (`GATEWAY_CLIENT_IP_SIGNING_JWK`). */
|
|
72
|
+
const GatewayClientIpPrivateJwkSchema = GatewayClientIpPublicJwkSchema.extend({ d: require_schemas.string().min(1) });
|
|
73
|
+
/**
|
|
74
|
+
* Import a gateway client-ip JWK (private or public half) into a usable jose
|
|
75
|
+
* key. Callers on a hot path - the gateway worker signs on every proxied
|
|
76
|
+
* request - should import once per isolate and reuse the resulting key
|
|
77
|
+
* rather than calling this per request.
|
|
78
|
+
*/
|
|
79
|
+
async function importGatewayClientIpSigningKey(jwk) {
|
|
80
|
+
return (0, jose.importJWK)(jwk, "ES256");
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* Mint a compact JWS carrying the gateway's client-identity claim.
|
|
84
|
+
* `privateKey` must already be imported (see {@link importGatewayClientIpSigningKey}) -
|
|
85
|
+
* this function never imports a key itself, so a cached key can be reused
|
|
86
|
+
* across every signed request.
|
|
87
|
+
*/
|
|
88
|
+
async function signGatewayClientIp(privateKey, kid, input, now = Math.floor(Date.now() / 1e3)) {
|
|
89
|
+
if (!kid || !input.aud || !input.cid || !input.host || !isIpLiteral(input.ip)) throw new Error("Invalid gateway client-ip signing input");
|
|
90
|
+
const claims = {
|
|
91
|
+
iss: GATEWAY_CLIENT_IP_ISSUER,
|
|
92
|
+
aud: input.aud,
|
|
93
|
+
ip: input.ip,
|
|
94
|
+
cid: input.cid,
|
|
95
|
+
host: input.host,
|
|
96
|
+
iat: now,
|
|
97
|
+
exp: now + 60
|
|
98
|
+
};
|
|
99
|
+
return new jose.SignJWT(claims).setProtectedHeader({
|
|
100
|
+
alg: "ES256",
|
|
101
|
+
typ: GATEWAY_CLIENT_IP_TYPE,
|
|
102
|
+
kid
|
|
103
|
+
}).sign(privateKey);
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Verify a gateway client-ip token against a JWKS document (as served by
|
|
107
|
+
* `/.well-known/jwks.json`) and return its claims, or `null` on ANY failure
|
|
108
|
+
* - malformed token, unknown `kid`, wrong `alg`, a tampered/expired/
|
|
109
|
+
* mismatched claim, or a `cid`/`host` that doesn't match the request being
|
|
110
|
+
* verified. Never throws: a missing or invalid token must change nothing
|
|
111
|
+
* about the caller's IP resolution.
|
|
112
|
+
*/
|
|
113
|
+
async function verifyGatewayClientIp(token, jwks, options) {
|
|
114
|
+
if (!token || !options.projectId || !options.expectedCid || !options.expectedHost) return null;
|
|
115
|
+
const now = options.now ?? Math.floor(Date.now() / 1e3);
|
|
116
|
+
try {
|
|
117
|
+
const ecKeys = jwks.keys.filter((key) => key.kty === "EC" && key.crv === "P-256");
|
|
118
|
+
if (ecKeys.length === 0) return null;
|
|
119
|
+
const getKey = (0, jose.createLocalJWKSet)({ keys: ecKeys });
|
|
120
|
+
const { payload } = await (0, jose.jwtVerify)(token, getKey, {
|
|
121
|
+
algorithms: ["ES256"],
|
|
122
|
+
issuer: GATEWAY_CLIENT_IP_ISSUER,
|
|
123
|
+
audience: options.projectId,
|
|
124
|
+
typ: GATEWAY_CLIENT_IP_TYPE,
|
|
125
|
+
currentDate: /* @__PURE__ */ new Date(now * 1e3),
|
|
126
|
+
clockTolerance: CLOCK_SKEW_SECONDS
|
|
127
|
+
});
|
|
128
|
+
const parsed = GatewayClientIpClaimsSchema.safeParse(payload);
|
|
129
|
+
if (!parsed.success) return null;
|
|
130
|
+
const claims = parsed.data;
|
|
131
|
+
if (claims.iat > now + CLOCK_SKEW_SECONDS || claims.exp > claims.iat + 60 || claims.cid !== options.expectedCid || claims.host !== options.expectedHost) return null;
|
|
132
|
+
return claims;
|
|
133
|
+
} catch {
|
|
134
|
+
return null;
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
//#endregion
|
|
139
|
+
exports.GATEWAY_CLIENT_IP_ISSUER = GATEWAY_CLIENT_IP_ISSUER;
|
|
140
|
+
exports.GATEWAY_CLIENT_IP_TOKEN_HEADER = GATEWAY_CLIENT_IP_TOKEN_HEADER;
|
|
141
|
+
exports.GATEWAY_CLIENT_IP_TTL_SECONDS = GATEWAY_CLIENT_IP_TTL_SECONDS;
|
|
142
|
+
exports.GATEWAY_CLIENT_IP_TYPE = GATEWAY_CLIENT_IP_TYPE;
|
|
143
|
+
exports.GatewayClientIpClaimsSchema = GatewayClientIpClaimsSchema;
|
|
144
|
+
exports.GatewayClientIpPrivateJwkSchema = GatewayClientIpPrivateJwkSchema;
|
|
145
|
+
exports.GatewayClientIpPublicJwkSchema = GatewayClientIpPublicJwkSchema;
|
|
146
|
+
exports.importGatewayClientIpSigningKey = importGatewayClientIpSigningKey;
|
|
147
|
+
exports.isIpLiteral = isIpLiteral;
|
|
148
|
+
exports.signGatewayClientIp = signGatewayClientIp;
|
|
149
|
+
exports.verifyGatewayClientIp = verifyGatewayClientIp;
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
import { _ as number, h as literal, v as object, x as string } from "./schemas-DxY-dk9y.mjs";
|
|
2
|
+
import { r as parseIpv6 } from "./client-ip-HOfe6ucV.mjs";
|
|
3
|
+
import { SignJWT, createLocalJWKSet, importJWK, jwtVerify } from "jose";
|
|
4
|
+
|
|
5
|
+
//#region src/gateway-client-ip.ts
|
|
6
|
+
/**
|
|
7
|
+
* Signed client-identity token minted by the Checkpoint Cloudflare gateway
|
|
8
|
+
* worker and verified by an origin-side Checkpoint SDK (KYA-1121 follow-up).
|
|
9
|
+
*
|
|
10
|
+
* The gateway already forwards the connecting IP as the plain `KYA-Client-IP`
|
|
11
|
+
* / `X-Forwarded-For` headers (see `proxy.ts`), which every adapter behind a
|
|
12
|
+
* KNOWN, trusted peer (Cloudflare's own published edge ranges) can trust.
|
|
13
|
+
* Behind an additional untrusted hop - e.g. a PaaS's own reverse proxy
|
|
14
|
+
* (Railway, Render, Fly) sitting between Cloudflare and the origin - the
|
|
15
|
+
* origin's TCP peer is that PaaS's proxy, not Cloudflare, so the plain
|
|
16
|
+
* header can never be trusted there: any caller reaching the PaaS's edge
|
|
17
|
+
* directly could set it too. This ES256-signed JWS carries the SAME claim
|
|
18
|
+
* with a signature only the gateway's private key can produce, so an origin
|
|
19
|
+
* can trust it regardless of what sits between it and the gateway.
|
|
20
|
+
*
|
|
21
|
+
* One gateway-wide asymmetric key (not a per-project secret): the worker
|
|
22
|
+
* holds the private JWK (`GATEWAY_CLIENT_IP_SIGNING_JWK`), the platform
|
|
23
|
+
* publishes the public JWK at `/.well-known/jwks.json`
|
|
24
|
+
* (`GATEWAY_CLIENT_IP_PUBLIC_JWK`). Rotation is by `kid`.
|
|
25
|
+
*/
|
|
26
|
+
const GATEWAY_CLIENT_IP_TOKEN_HEADER = "KYA-Client-IP-Token";
|
|
27
|
+
const GATEWAY_CLIENT_IP_ISSUER = "checkpoint:gateway-client-ip:v1";
|
|
28
|
+
const GATEWAY_CLIENT_IP_TYPE = "checkpoint-client-ip+jwt";
|
|
29
|
+
/**
|
|
30
|
+
* Token lifetime, seconds. A verifier MUST additionally bind `cid`/`host` to
|
|
31
|
+
* the request it's verifying (see {@link VerifyGatewayClientIpOptions}) -
|
|
32
|
+
* without that binding, a token captured on an untrusted hop within this
|
|
33
|
+
* window is replayable onto a DIFFERENT request the gateway never actually
|
|
34
|
+
* saw, and the `ip` it carries is not inert: it feeds the same IP-reputation
|
|
35
|
+
* and vendor-cross-match signals as any other resolved client IP, which do
|
|
36
|
+
* influence the engine's enforcement decision. Binding `cid` (unique per
|
|
37
|
+
* request) is what keeps a captured token scoped to the one request the
|
|
38
|
+
* gateway minted it for.
|
|
39
|
+
*/
|
|
40
|
+
const GATEWAY_CLIENT_IP_TTL_SECONDS = 60;
|
|
41
|
+
/** Clock-skew allowance applied to `exp` (via jose's `clockTolerance`) and independently to `iat` below. */
|
|
42
|
+
const CLOCK_SKEW_SECONDS = 30;
|
|
43
|
+
function isIpv4Literal(value) {
|
|
44
|
+
const parts = value.split(".");
|
|
45
|
+
return parts.length === 4 && parts.every((part) => /^(0|[1-9]\d{0,2})$/.test(part) && Number(part) <= 255);
|
|
46
|
+
}
|
|
47
|
+
/** True when `value` is a literal IPv4 or IPv6 address - never resolves a hostname. */
|
|
48
|
+
function isIpLiteral(value) {
|
|
49
|
+
return isIpv4Literal(value) || parseIpv6(value) !== null;
|
|
50
|
+
}
|
|
51
|
+
const GatewayClientIpClaimsSchema = object({
|
|
52
|
+
iss: literal(GATEWAY_CLIENT_IP_ISSUER),
|
|
53
|
+
aud: string().min(1),
|
|
54
|
+
ip: string().refine(isIpLiteral, "ip must be a literal IPv4 or IPv6 address"),
|
|
55
|
+
cid: string().min(1),
|
|
56
|
+
host: string().min(1),
|
|
57
|
+
iat: number().int().nonnegative(),
|
|
58
|
+
exp: number().int().positive()
|
|
59
|
+
});
|
|
60
|
+
/** The gateway's own EC P-256 public key, as published in `/.well-known/jwks.json`. */
|
|
61
|
+
const GatewayClientIpPublicJwkSchema = object({
|
|
62
|
+
kty: literal("EC"),
|
|
63
|
+
crv: literal("P-256"),
|
|
64
|
+
alg: literal("ES256"),
|
|
65
|
+
use: literal("sig"),
|
|
66
|
+
kid: string().min(1),
|
|
67
|
+
x: string().min(1),
|
|
68
|
+
y: string().min(1)
|
|
69
|
+
});
|
|
70
|
+
/** The private half the gateway worker holds (`GATEWAY_CLIENT_IP_SIGNING_JWK`). */
|
|
71
|
+
const GatewayClientIpPrivateJwkSchema = GatewayClientIpPublicJwkSchema.extend({ d: string().min(1) });
|
|
72
|
+
/**
|
|
73
|
+
* Import a gateway client-ip JWK (private or public half) into a usable jose
|
|
74
|
+
* key. Callers on a hot path - the gateway worker signs on every proxied
|
|
75
|
+
* request - should import once per isolate and reuse the resulting key
|
|
76
|
+
* rather than calling this per request.
|
|
77
|
+
*/
|
|
78
|
+
async function importGatewayClientIpSigningKey(jwk) {
|
|
79
|
+
return importJWK(jwk, "ES256");
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Mint a compact JWS carrying the gateway's client-identity claim.
|
|
83
|
+
* `privateKey` must already be imported (see {@link importGatewayClientIpSigningKey}) -
|
|
84
|
+
* this function never imports a key itself, so a cached key can be reused
|
|
85
|
+
* across every signed request.
|
|
86
|
+
*/
|
|
87
|
+
async function signGatewayClientIp(privateKey, kid, input, now = Math.floor(Date.now() / 1e3)) {
|
|
88
|
+
if (!kid || !input.aud || !input.cid || !input.host || !isIpLiteral(input.ip)) throw new Error("Invalid gateway client-ip signing input");
|
|
89
|
+
const claims = {
|
|
90
|
+
iss: GATEWAY_CLIENT_IP_ISSUER,
|
|
91
|
+
aud: input.aud,
|
|
92
|
+
ip: input.ip,
|
|
93
|
+
cid: input.cid,
|
|
94
|
+
host: input.host,
|
|
95
|
+
iat: now,
|
|
96
|
+
exp: now + 60
|
|
97
|
+
};
|
|
98
|
+
return new SignJWT(claims).setProtectedHeader({
|
|
99
|
+
alg: "ES256",
|
|
100
|
+
typ: GATEWAY_CLIENT_IP_TYPE,
|
|
101
|
+
kid
|
|
102
|
+
}).sign(privateKey);
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
* Verify a gateway client-ip token against a JWKS document (as served by
|
|
106
|
+
* `/.well-known/jwks.json`) and return its claims, or `null` on ANY failure
|
|
107
|
+
* - malformed token, unknown `kid`, wrong `alg`, a tampered/expired/
|
|
108
|
+
* mismatched claim, or a `cid`/`host` that doesn't match the request being
|
|
109
|
+
* verified. Never throws: a missing or invalid token must change nothing
|
|
110
|
+
* about the caller's IP resolution.
|
|
111
|
+
*/
|
|
112
|
+
async function verifyGatewayClientIp(token, jwks, options) {
|
|
113
|
+
if (!token || !options.projectId || !options.expectedCid || !options.expectedHost) return null;
|
|
114
|
+
const now = options.now ?? Math.floor(Date.now() / 1e3);
|
|
115
|
+
try {
|
|
116
|
+
const ecKeys = jwks.keys.filter((key) => key.kty === "EC" && key.crv === "P-256");
|
|
117
|
+
if (ecKeys.length === 0) return null;
|
|
118
|
+
const getKey = createLocalJWKSet({ keys: ecKeys });
|
|
119
|
+
const { payload } = await jwtVerify(token, getKey, {
|
|
120
|
+
algorithms: ["ES256"],
|
|
121
|
+
issuer: GATEWAY_CLIENT_IP_ISSUER,
|
|
122
|
+
audience: options.projectId,
|
|
123
|
+
typ: GATEWAY_CLIENT_IP_TYPE,
|
|
124
|
+
currentDate: /* @__PURE__ */ new Date(now * 1e3),
|
|
125
|
+
clockTolerance: CLOCK_SKEW_SECONDS
|
|
126
|
+
});
|
|
127
|
+
const parsed = GatewayClientIpClaimsSchema.safeParse(payload);
|
|
128
|
+
if (!parsed.success) return null;
|
|
129
|
+
const claims = parsed.data;
|
|
130
|
+
if (claims.iat > now + CLOCK_SKEW_SECONDS || claims.exp > claims.iat + 60 || claims.cid !== options.expectedCid || claims.host !== options.expectedHost) return null;
|
|
131
|
+
return claims;
|
|
132
|
+
} catch {
|
|
133
|
+
return null;
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
//#endregion
|
|
138
|
+
export { GATEWAY_CLIENT_IP_ISSUER, GATEWAY_CLIENT_IP_TOKEN_HEADER, GATEWAY_CLIENT_IP_TTL_SECONDS, GATEWAY_CLIENT_IP_TYPE, GatewayClientIpClaimsSchema, GatewayClientIpPrivateJwkSchema, GatewayClientIpPublicJwkSchema, importGatewayClientIpSigningKey, isIpLiteral, signGatewayClientIp, verifyGatewayClientIp };
|
|
139
|
+
//# sourceMappingURL=gateway-client-ip.mjs.map
|