@decionis/agentsafe 0.2.5 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +135 -20
- package/dist/Cli.js +19 -0
- package/dist/Cli.js.map +1 -1
- package/dist/Index.d.ts +10 -4
- package/dist/Index.d.ts.map +1 -1
- package/dist/Index.js +8 -2
- package/dist/Index.js.map +1 -1
- package/dist/TrustedExecutor.d.ts.map +1 -1
- package/dist/TrustedExecutor.js +1 -0
- package/dist/TrustedExecutor.js.map +1 -1
- package/dist/adapters/AdapterActionHandler.d.ts.map +1 -1
- package/dist/adapters/AdapterActionHandler.js +8 -4
- package/dist/adapters/AdapterActionHandler.js.map +1 -1
- package/dist/adapters/EffectAdapter.d.ts +6 -1
- package/dist/adapters/EffectAdapter.d.ts.map +1 -1
- package/dist/adapters/EffectAdapter.js +7 -1
- package/dist/adapters/EffectAdapter.js.map +1 -1
- package/dist/adapters/banking/CoreBankingHttpAdapter.d.ts.map +1 -1
- package/dist/adapters/banking/CoreBankingHttpAdapter.js +4 -4
- package/dist/adapters/banking/CoreBankingHttpAdapter.js.map +1 -1
- package/dist/adapters/cards/CardAuthorizationMatcher.d.ts +44 -0
- package/dist/adapters/cards/CardAuthorizationMatcher.d.ts.map +1 -0
- package/dist/adapters/cards/CardAuthorizationMatcher.js +39 -0
- package/dist/adapters/cards/CardAuthorizationMatcher.js.map +1 -0
- package/dist/adapters/cards/CardEffect.d.ts +52 -0
- package/dist/adapters/cards/CardEffect.d.ts.map +1 -0
- package/dist/adapters/cards/CardEffect.js +117 -0
- package/dist/adapters/cards/CardEffect.js.map +1 -0
- package/dist/adapters/cards/CardHandlers.d.ts +15 -0
- package/dist/adapters/cards/CardHandlers.d.ts.map +1 -0
- package/dist/adapters/cards/CardHandlers.js +26 -0
- package/dist/adapters/cards/CardHandlers.js.map +1 -0
- package/dist/adapters/cards/CardPurchase.d.ts +61 -0
- package/dist/adapters/cards/CardPurchase.d.ts.map +1 -0
- package/dist/adapters/cards/CardPurchase.js +116 -0
- package/dist/adapters/cards/CardPurchase.js.map +1 -0
- package/dist/adapters/cards/HeldCardGrants.d.ts +70 -0
- package/dist/adapters/cards/HeldCardGrants.d.ts.map +1 -0
- package/dist/adapters/cards/HeldCardGrants.js +79 -0
- package/dist/adapters/cards/HeldCardGrants.js.map +1 -0
- package/dist/adapters/cards/Pan.d.ts +17 -0
- package/dist/adapters/cards/Pan.d.ts.map +1 -0
- package/dist/adapters/cards/Pan.js +52 -0
- package/dist/adapters/cards/Pan.js.map +1 -0
- package/dist/adapters/mcp/McpGuard.d.ts.map +1 -1
- package/dist/adapters/mcp/McpGuard.js +9 -4
- package/dist/adapters/mcp/McpGuard.js.map +1 -1
- package/dist/audit/HashChain.d.ts +8 -2
- package/dist/audit/HashChain.d.ts.map +1 -1
- package/dist/audit/HashChain.js +14 -2
- package/dist/audit/HashChain.js.map +1 -1
- package/dist/cli/Commands.d.ts +1 -1
- package/dist/cli/Commands.d.ts.map +1 -1
- package/dist/cli/Commands.js +5 -0
- package/dist/cli/Commands.js.map +1 -1
- package/dist/cli/Edge.d.ts +4 -0
- package/dist/cli/Edge.d.ts.map +1 -0
- package/dist/cli/Edge.js +250 -0
- package/dist/cli/Edge.js.map +1 -0
- package/dist/cli/Help.d.ts.map +1 -1
- package/dist/cli/Help.js +8 -0
- package/dist/cli/Help.js.map +1 -1
- package/dist/cli/Host.d.ts +36 -0
- package/dist/cli/Host.d.ts.map +1 -0
- package/dist/cli/Host.js +247 -0
- package/dist/cli/Host.js.map +1 -0
- package/dist/cli/TcpBrokerCli.d.ts +4 -0
- package/dist/cli/TcpBrokerCli.d.ts.map +1 -0
- package/dist/cli/TcpBrokerCli.js +93 -0
- package/dist/cli/TcpBrokerCli.js.map +1 -0
- package/dist/cli/TcpClientCli.d.ts +16 -0
- package/dist/cli/TcpClientCli.d.ts.map +1 -0
- package/dist/cli/TcpClientCli.js +175 -0
- package/dist/cli/TcpClientCli.js.map +1 -0
- package/dist/config/ConfigKeys.d.ts +2 -2
- package/dist/config/ConfigKeys.d.ts.map +1 -1
- package/dist/config/ConfigKeys.js +19 -0
- package/dist/config/ConfigKeys.js.map +1 -1
- package/dist/config/ExecutorConfig.d.ts +62 -0
- package/dist/config/ExecutorConfig.d.ts.map +1 -1
- package/dist/config/ExecutorConfig.js +124 -0
- package/dist/config/ExecutorConfig.js.map +1 -1
- package/dist/edge/EdgeLicence.d.ts +25 -0
- package/dist/edge/EdgeLicence.d.ts.map +1 -0
- package/dist/edge/EdgeLicence.js +42 -0
- package/dist/edge/EdgeLicence.js.map +1 -0
- package/dist/edge/EdgeReplay.d.ts +45 -0
- package/dist/edge/EdgeReplay.d.ts.map +1 -0
- package/dist/edge/EdgeReplay.js +69 -0
- package/dist/edge/EdgeReplay.js.map +1 -0
- package/dist/edge/Entitlement.d.ts +57 -0
- package/dist/edge/Entitlement.d.ts.map +1 -0
- package/dist/edge/Entitlement.js +139 -0
- package/dist/edge/Entitlement.js.map +1 -0
- package/dist/edge/EntitlementEvaluation.d.ts +66 -0
- package/dist/edge/EntitlementEvaluation.d.ts.map +1 -0
- package/dist/edge/EntitlementEvaluation.js +74 -0
- package/dist/edge/EntitlementEvaluation.js.map +1 -0
- package/dist/edge/UsageCount.d.ts +40 -0
- package/dist/edge/UsageCount.d.ts.map +1 -0
- package/dist/edge/UsageCount.js +140 -0
- package/dist/edge/UsageCount.js.map +1 -0
- package/dist/edge/UsageKeyRegistration.d.ts +34 -0
- package/dist/edge/UsageKeyRegistration.d.ts.map +1 -0
- package/dist/edge/UsageKeyRegistration.js +74 -0
- package/dist/edge/UsageKeyRegistration.js.map +1 -0
- package/dist/edge/UsageMeter.d.ts +89 -0
- package/dist/edge/UsageMeter.d.ts.map +1 -0
- package/dist/edge/UsageMeter.js +275 -0
- package/dist/edge/UsageMeter.js.map +1 -0
- package/dist/edge/UsagePeriod.d.ts +23 -0
- package/dist/edge/UsagePeriod.d.ts.map +1 -0
- package/dist/edge/UsagePeriod.js +31 -0
- package/dist/edge/UsagePeriod.js.map +1 -0
- package/dist/edge/UsageReport.d.ts +92 -0
- package/dist/edge/UsageReport.d.ts.map +1 -0
- package/dist/edge/UsageReport.js +153 -0
- package/dist/edge/UsageReport.js.map +1 -0
- package/dist/edge/UsageTally.d.ts +63 -0
- package/dist/edge/UsageTally.d.ts.map +1 -0
- package/dist/edge/UsageTally.js +89 -0
- package/dist/edge/UsageTally.js.map +1 -0
- package/dist/egress/EgressError.d.ts +7 -1
- package/dist/egress/EgressError.d.ts.map +1 -1
- package/dist/egress/EgressError.js.map +1 -1
- package/dist/egress/EgressPolicy.d.ts +16 -3
- package/dist/egress/EgressPolicy.d.ts.map +1 -1
- package/dist/egress/EgressPolicy.js +33 -3
- package/dist/egress/EgressPolicy.js.map +1 -1
- package/dist/egress/GuardedFetch.d.ts +38 -1
- package/dist/egress/GuardedFetch.d.ts.map +1 -1
- package/dist/egress/GuardedFetch.js +52 -7
- package/dist/egress/GuardedFetch.js.map +1 -1
- package/dist/egress/TcpClient.d.ts +103 -0
- package/dist/egress/TcpClient.d.ts.map +1 -0
- package/dist/egress/TcpClient.js +490 -0
- package/dist/egress/TcpClient.js.map +1 -0
- package/dist/egress/TcpControlClient.d.ts +49 -0
- package/dist/egress/TcpControlClient.d.ts.map +1 -0
- package/dist/egress/TcpControlClient.js +186 -0
- package/dist/egress/TcpControlClient.js.map +1 -0
- package/dist/gateway/ForwardHandler.d.ts.map +1 -1
- package/dist/gateway/ForwardHandler.js +7 -4
- package/dist/gateway/ForwardHandler.js.map +1 -1
- package/dist/gateway/Gateway.d.ts +190 -10
- package/dist/gateway/Gateway.d.ts.map +1 -1
- package/dist/gateway/Gateway.js +465 -62
- package/dist/gateway/Gateway.js.map +1 -1
- package/dist/gateway/GatewayConfig.d.ts +67 -0
- package/dist/gateway/GatewayConfig.d.ts.map +1 -1
- package/dist/gateway/GatewayConfig.js +149 -2
- package/dist/gateway/GatewayConfig.js.map +1 -1
- package/dist/gateway/InterceptedRequest.d.ts +9 -2
- package/dist/gateway/InterceptedRequest.d.ts.map +1 -1
- package/dist/gateway/InterceptedRequest.js +41 -9
- package/dist/gateway/InterceptedRequest.js.map +1 -1
- package/dist/gateway/RateLimit.d.ts +29 -0
- package/dist/gateway/RateLimit.d.ts.map +1 -0
- package/dist/gateway/RateLimit.js +33 -0
- package/dist/gateway/RateLimit.js.map +1 -0
- package/dist/gateway/RefusalSampler.d.ts +28 -0
- package/dist/gateway/RefusalSampler.d.ts.map +1 -0
- package/dist/gateway/RefusalSampler.js +52 -0
- package/dist/gateway/RefusalSampler.js.map +1 -0
- package/dist/gateway/RouteTable.d.ts +3 -0
- package/dist/gateway/RouteTable.d.ts.map +1 -1
- package/dist/gateway/RouteTable.js +44 -7
- package/dist/gateway/RouteTable.js.map +1 -1
- package/dist/gateway/Upstream.d.ts +26 -0
- package/dist/gateway/Upstream.d.ts.map +1 -1
- package/dist/gateway/Upstream.js +41 -2
- package/dist/gateway/Upstream.js.map +1 -1
- package/dist/gateway/UpstreamProof.d.ts +235 -0
- package/dist/gateway/UpstreamProof.d.ts.map +1 -0
- package/dist/gateway/UpstreamProof.js +375 -0
- package/dist/gateway/UpstreamProof.js.map +1 -0
- package/dist/handlers/ForwardRequestHandler.d.ts +5 -1
- package/dist/handlers/ForwardRequestHandler.d.ts.map +1 -1
- package/dist/handlers/ForwardRequestHandler.js +12 -2
- package/dist/handlers/ForwardRequestHandler.js.map +1 -1
- package/dist/hosted/TenantHost.d.ts +180 -0
- package/dist/hosted/TenantHost.d.ts.map +1 -0
- package/dist/hosted/TenantHost.js +432 -0
- package/dist/hosted/TenantHost.js.map +1 -0
- package/dist/hosted/TenantRegistry.d.ts +73 -0
- package/dist/hosted/TenantRegistry.d.ts.map +1 -0
- package/dist/hosted/TenantRegistry.js +123 -0
- package/dist/hosted/TenantRegistry.js.map +1 -0
- package/dist/http/ExecutorHttpServer.d.ts +7 -0
- package/dist/http/ExecutorHttpServer.d.ts.map +1 -1
- package/dist/http/ExecutorHttpServer.js +30 -5
- package/dist/http/ExecutorHttpServer.js.map +1 -1
- package/dist/http/GatewayHttpServer.d.ts +55 -3
- package/dist/http/GatewayHttpServer.d.ts.map +1 -1
- package/dist/http/GatewayHttpServer.js +157 -17
- package/dist/http/GatewayHttpServer.js.map +1 -1
- package/dist/http/RedirectServer.d.ts +26 -0
- package/dist/http/RedirectServer.d.ts.map +1 -0
- package/dist/http/RedirectServer.js +62 -0
- package/dist/http/RedirectServer.js.map +1 -0
- package/dist/http/Routes.d.ts +17 -0
- package/dist/http/Routes.d.ts.map +1 -1
- package/dist/http/Routes.js +21 -0
- package/dist/http/Routes.js.map +1 -1
- package/dist/http/TcpBroker.d.ts +57 -0
- package/dist/http/TcpBroker.d.ts.map +1 -0
- package/dist/http/TcpBroker.js +299 -0
- package/dist/http/TcpBroker.js.map +1 -0
- package/dist/http/TcpHostRelay.d.ts +24 -0
- package/dist/http/TcpHostRelay.d.ts.map +1 -0
- package/dist/http/TcpHostRelay.js +194 -0
- package/dist/http/TcpHostRelay.js.map +1 -0
- package/dist/http/TcpRelayStreams.d.ts +24 -0
- package/dist/http/TcpRelayStreams.d.ts.map +1 -0
- package/dist/http/TcpRelayStreams.js +128 -0
- package/dist/http/TcpRelayStreams.js.map +1 -0
- package/dist/http/TlsListener.d.ts +3 -1
- package/dist/http/TlsListener.d.ts.map +1 -1
- package/dist/http/TlsListener.js +7 -2
- package/dist/http/TlsListener.js.map +1 -1
- package/dist/identity/PrincipalsFile.d.ts +3 -1
- package/dist/identity/PrincipalsFile.d.ts.map +1 -1
- package/dist/identity/PrincipalsFile.js +1 -0
- package/dist/identity/PrincipalsFile.js.map +1 -1
- package/dist/incident/Metrics.d.ts +2 -0
- package/dist/incident/Metrics.d.ts.map +1 -1
- package/dist/incident/Metrics.js +10 -0
- package/dist/incident/Metrics.js.map +1 -1
- package/dist/incident/SecurityEvents.d.ts +89 -0
- package/dist/incident/SecurityEvents.d.ts.map +1 -1
- package/dist/incident/SecurityEvents.js +93 -2
- package/dist/incident/SecurityEvents.js.map +1 -1
- package/dist/journal/ExecutionJournal.d.ts +27 -0
- package/dist/journal/ExecutionJournal.d.ts.map +1 -1
- package/dist/journal/ExecutionJournal.js +28 -0
- package/dist/journal/ExecutionJournal.js.map +1 -1
- package/dist/journal/FileExecutionJournal.d.ts +2 -1
- package/dist/journal/FileExecutionJournal.d.ts.map +1 -1
- package/dist/journal/FileExecutionJournal.js +4 -1
- package/dist/journal/FileExecutionJournal.js.map +1 -1
- package/dist/journal/InMemoryExecutionJournal.d.ts +2 -1
- package/dist/journal/InMemoryExecutionJournal.d.ts.map +1 -1
- package/dist/journal/InMemoryExecutionJournal.js +4 -1
- package/dist/journal/InMemoryExecutionJournal.js.map +1 -1
- package/dist/service/AuthorityClients.d.ts +8 -1
- package/dist/service/AuthorityClients.d.ts.map +1 -1
- package/dist/service/AuthorityClients.js +33 -5
- package/dist/service/AuthorityClients.js.map +1 -1
- package/dist/service/EdgeRuntime.d.ts +73 -0
- package/dist/service/EdgeRuntime.d.ts.map +1 -0
- package/dist/service/EdgeRuntime.js +209 -0
- package/dist/service/EdgeRuntime.js.map +1 -0
- package/dist/service/EscalationResolver.d.ts +82 -2
- package/dist/service/EscalationResolver.d.ts.map +1 -1
- package/dist/service/EscalationResolver.js +39 -3
- package/dist/service/EscalationResolver.js.map +1 -1
- package/dist/service/Requests.d.ts +28 -2
- package/dist/service/Requests.d.ts.map +1 -1
- package/dist/service/TrustedExecutorService.d.ts +71 -1
- package/dist/service/TrustedExecutorService.d.ts.map +1 -1
- package/dist/service/TrustedExecutorService.js +461 -27
- package/dist/service/TrustedExecutorService.js.map +1 -1
- package/dist/tcp/TcpWire.d.ts +18 -0
- package/dist/tcp/TcpWire.d.ts.map +1 -0
- package/dist/tcp/TcpWire.js +114 -0
- package/dist/tcp/TcpWire.js.map +1 -0
- package/dist/verify/VerifyAuditChain.d.ts +5 -0
- package/dist/verify/VerifyAuditChain.d.ts.map +1 -1
- package/dist/verify/VerifyAuditChain.js +20 -4
- package/dist/verify/VerifyAuditChain.js.map +1 -1
- package/package.json +7 -3
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
import { createHash, createPrivateKey, createPublicKey, randomUUID, } from "node:crypto";
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
import { usagePeriod } from "./UsagePeriod.js";
|
|
4
|
+
/** The JWS `typ` of a usage report, as Decionis ingestion checks it. */
|
|
5
|
+
export const USAGE_REPORT_TYPE = "decionis-edge-usage+jwt";
|
|
6
|
+
const identifier = z.string().min(1).max(200);
|
|
7
|
+
const count = z.number().int().nonnegative();
|
|
8
|
+
const sha256 = z.string().regex(/^sha256:[0-9a-f]{64}$/);
|
|
9
|
+
/** The claims of a usage report (Edge evaluator phase 4, section 3). */
|
|
10
|
+
export const UsageReportClaimsSchema = z.strictObject({
|
|
11
|
+
/** The installation: one executor's evidence chain. */
|
|
12
|
+
iss: identifier,
|
|
13
|
+
/** The Decionis organisation. */
|
|
14
|
+
aud: identifier,
|
|
15
|
+
iat: count,
|
|
16
|
+
jti: identifier,
|
|
17
|
+
period: z.string().regex(/^2\d{3}-(?:0[1-9]|1[0-2])$/),
|
|
18
|
+
period_start: z.string().datetime(),
|
|
19
|
+
period_end: z.string().datetime(),
|
|
20
|
+
counts: z.strictObject({
|
|
21
|
+
by_mode: z.strictObject({ ENFORCEMENT: count, SHADOW: count }),
|
|
22
|
+
by_verdict: z.strictObject({ ALLOW: count, ESCALATE: count, BLOCK: count }),
|
|
23
|
+
total: count,
|
|
24
|
+
}),
|
|
25
|
+
delegated: count,
|
|
26
|
+
chain: z.strictObject({
|
|
27
|
+
stream: identifier,
|
|
28
|
+
first_seq: count.nullable(),
|
|
29
|
+
last_seq: count.nullable(),
|
|
30
|
+
first_hash: sha256.nullable(),
|
|
31
|
+
last_hash: sha256.nullable(),
|
|
32
|
+
}),
|
|
33
|
+
bundles: z.array(identifier).max(10_000),
|
|
34
|
+
});
|
|
35
|
+
/** The usage report's claims for one period, as this installation counted it. */
|
|
36
|
+
export function usageReportClaims(input) {
|
|
37
|
+
const { usage } = input;
|
|
38
|
+
return {
|
|
39
|
+
iss: input.installationId,
|
|
40
|
+
aud: input.orgId,
|
|
41
|
+
iat: Math.floor(input.now / 1000),
|
|
42
|
+
jti: input.jti ?? randomUUID(),
|
|
43
|
+
period: input.period.period,
|
|
44
|
+
period_start: new Date(input.period.start).toISOString(),
|
|
45
|
+
period_end: new Date(input.period.end).toISOString(),
|
|
46
|
+
counts: usage.counts,
|
|
47
|
+
delegated: usage.delegated,
|
|
48
|
+
chain: {
|
|
49
|
+
stream: input.stream,
|
|
50
|
+
first_seq: usage.first_seq,
|
|
51
|
+
last_seq: usage.last_seq,
|
|
52
|
+
first_hash: usage.first_hash,
|
|
53
|
+
last_hash: usage.last_hash,
|
|
54
|
+
},
|
|
55
|
+
bundles: [...usage.bundles],
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
/** The usage the claims state, in the tally's shape, for a recount to compare with. */
|
|
59
|
+
export function claimedUsage(claims) {
|
|
60
|
+
return {
|
|
61
|
+
counts: claims.counts,
|
|
62
|
+
delegated: claims.delegated,
|
|
63
|
+
first_seq: claims.chain.first_seq,
|
|
64
|
+
first_hash: claims.chain.first_hash,
|
|
65
|
+
last_seq: claims.chain.last_seq,
|
|
66
|
+
last_hash: claims.chain.last_hash,
|
|
67
|
+
bundles: claims.bundles,
|
|
68
|
+
stream: claims.chain.stream,
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Whether the claims agree with themselves: the period's bounds are the
|
|
73
|
+
* period's, each breakdown sums to the total, no more were delegated than
|
|
74
|
+
* decided, and the range is named exactly when something was counted.
|
|
75
|
+
*/
|
|
76
|
+
export function consistentClaims(claims) {
|
|
77
|
+
const period = usagePeriod(claims.period);
|
|
78
|
+
const { by_mode, by_verdict, total } = claims.counts;
|
|
79
|
+
const range = [
|
|
80
|
+
claims.chain.first_seq,
|
|
81
|
+
claims.chain.last_seq,
|
|
82
|
+
claims.chain.first_hash,
|
|
83
|
+
claims.chain.last_hash,
|
|
84
|
+
];
|
|
85
|
+
return (Date.parse(claims.period_start) === period.start &&
|
|
86
|
+
Date.parse(claims.period_end) === period.end &&
|
|
87
|
+
by_mode.ENFORCEMENT + by_mode.SHADOW === total &&
|
|
88
|
+
by_verdict.ALLOW + by_verdict.ESCALATE + by_verdict.BLOCK === total &&
|
|
89
|
+
claims.delegated <= total &&
|
|
90
|
+
range.every((value) => (value === null) === (total === 0)));
|
|
91
|
+
}
|
|
92
|
+
/**
|
|
93
|
+
* Reads a PKCS#8 PEM Ed25519 key. The `kid` is the one configured, or the
|
|
94
|
+
* key's RFC 7638 thumbprint, so the same key always has the same id.
|
|
95
|
+
*/
|
|
96
|
+
export function usageSigningKey(pem, kid) {
|
|
97
|
+
const privateKey = createPrivateKey(pem);
|
|
98
|
+
if (privateKey.asymmetricKeyType !== "ed25519")
|
|
99
|
+
throw new Error("USAGE_KEY_NOT_ED25519");
|
|
100
|
+
const jwk = createPublicKey(privateKey).export({ format: "jwk" });
|
|
101
|
+
const publicJwk = { kty: "OKP", crv: "Ed25519", x: String(jwk.x) };
|
|
102
|
+
const thumbprint = createHash("sha256")
|
|
103
|
+
.update(JSON.stringify({ crv: publicJwk.crv, kty: publicJwk.kty, x: publicJwk.x }))
|
|
104
|
+
.digest("base64url");
|
|
105
|
+
return { kid: kid ?? thumbprint, privateKey, publicJwk };
|
|
106
|
+
}
|
|
107
|
+
/** The compact JWS Decionis ingests: `alg` EdDSA, `typ` the usage report's, `kid` the key's. */
|
|
108
|
+
export async function signUsageReport(claims, key) {
|
|
109
|
+
const { CompactSign } = await import("jose");
|
|
110
|
+
return await new CompactSign(new TextEncoder().encode(JSON.stringify(claims)))
|
|
111
|
+
.setProtectedHeader({ alg: "EdDSA", typ: USAGE_REPORT_TYPE, kid: key.kid })
|
|
112
|
+
.sign(key.privateKey);
|
|
113
|
+
}
|
|
114
|
+
/**
|
|
115
|
+
* Checks a usage report's signature against a public key and its claims
|
|
116
|
+
* against the schema and themselves. It does not recount: `verifyUsage`
|
|
117
|
+
* does that against the chain.
|
|
118
|
+
*/
|
|
119
|
+
export async function readUsageReport(token, publicJwk) {
|
|
120
|
+
const { compactVerify, decodeProtectedHeader, importJWK } = await import("jose");
|
|
121
|
+
let header;
|
|
122
|
+
try {
|
|
123
|
+
header = decodeProtectedHeader(token);
|
|
124
|
+
}
|
|
125
|
+
catch {
|
|
126
|
+
return { ok: false, code: "USAGE_REPORT_MALFORMED" };
|
|
127
|
+
}
|
|
128
|
+
if (header.alg !== "EdDSA" ||
|
|
129
|
+
header.typ !== USAGE_REPORT_TYPE ||
|
|
130
|
+
typeof header.kid !== "string") {
|
|
131
|
+
return { ok: false, code: "USAGE_REPORT_MALFORMED" };
|
|
132
|
+
}
|
|
133
|
+
let payload;
|
|
134
|
+
try {
|
|
135
|
+
const key = await importJWK({ ...publicJwk, alg: "EdDSA" }, "EdDSA");
|
|
136
|
+
payload = (await compactVerify(token, key, { algorithms: ["EdDSA"] })).payload;
|
|
137
|
+
}
|
|
138
|
+
catch {
|
|
139
|
+
return { ok: false, code: "USAGE_REPORT_SIGNATURE_INVALID" };
|
|
140
|
+
}
|
|
141
|
+
let parsed;
|
|
142
|
+
try {
|
|
143
|
+
parsed = UsageReportClaimsSchema.safeParse(JSON.parse(new TextDecoder().decode(payload)));
|
|
144
|
+
}
|
|
145
|
+
catch {
|
|
146
|
+
return { ok: false, code: "USAGE_REPORT_MALFORMED" };
|
|
147
|
+
}
|
|
148
|
+
if (!parsed.success || !consistentClaims(parsed.data)) {
|
|
149
|
+
return { ok: false, code: "USAGE_REPORT_INCONSISTENT" };
|
|
150
|
+
}
|
|
151
|
+
return { ok: true, kid: header.kid, claims: parsed.data };
|
|
152
|
+
}
|
|
153
|
+
//# sourceMappingURL=UsageReport.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"UsageReport.js","sourceRoot":"","sources":["../../src/edge/UsageReport.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import { type UsagePeriod } from "./UsagePeriod.js";
|
|
2
|
+
export declare const USAGE_MODES: readonly ["ENFORCEMENT", "SHADOW"];
|
|
3
|
+
export declare const USAGE_VERDICTS: readonly ["ALLOW", "ESCALATE", "BLOCK"];
|
|
4
|
+
export type UsageMode = (typeof USAGE_MODES)[number];
|
|
5
|
+
export type UsageVerdict = (typeof USAGE_VERDICTS)[number];
|
|
6
|
+
/** One `EDGE_DECISION` line, as linked on the evidence chain. */
|
|
7
|
+
export interface UsageLine {
|
|
8
|
+
readonly at: string;
|
|
9
|
+
readonly mode: unknown;
|
|
10
|
+
readonly verdict: unknown;
|
|
11
|
+
readonly delegated: unknown;
|
|
12
|
+
readonly jti: unknown;
|
|
13
|
+
readonly seq: number;
|
|
14
|
+
readonly hash: string;
|
|
15
|
+
}
|
|
16
|
+
/** The chain range a period's counts were taken from; all null when nothing was counted. */
|
|
17
|
+
export interface UsageRange {
|
|
18
|
+
readonly first_seq: number | null;
|
|
19
|
+
readonly first_hash: string | null;
|
|
20
|
+
readonly last_seq: number | null;
|
|
21
|
+
readonly last_hash: string | null;
|
|
22
|
+
}
|
|
23
|
+
/** What one period counted: the usage report's `counts`, `delegated`, range and `bundles`. */
|
|
24
|
+
export interface PeriodUsage extends UsageRange {
|
|
25
|
+
readonly counts: {
|
|
26
|
+
readonly by_mode: Readonly<Record<UsageMode, number>>;
|
|
27
|
+
readonly by_verdict: Readonly<Record<UsageVerdict, number>>;
|
|
28
|
+
readonly total: number;
|
|
29
|
+
};
|
|
30
|
+
/** Decisions handed to Decionis (an enforcement `ESCALATE`), which Decionis meters itself. */
|
|
31
|
+
readonly delegated: number;
|
|
32
|
+
/** The bundle `jti`s decided on, sorted, each once. */
|
|
33
|
+
readonly bundles: readonly string[];
|
|
34
|
+
}
|
|
35
|
+
/** A period with nothing counted. */
|
|
36
|
+
export declare function emptyUsage(): PeriodUsage;
|
|
37
|
+
/**
|
|
38
|
+
* The count of `EDGE_DECISION` lines per UTC month, the same count whether
|
|
39
|
+
* it is kept as lines are written or recounted later from the chain. A line
|
|
40
|
+
* is counted in the period its `at` falls in; lines arrive in chain order,
|
|
41
|
+
* so the first and last counted lines are the period's range. Every edge
|
|
42
|
+
* decision is counted once in `total`; the delegated ones are also counted
|
|
43
|
+
* in `delegated`, which Decionis subtracts because it meters those itself.
|
|
44
|
+
*/
|
|
45
|
+
export declare class UsageTally {
|
|
46
|
+
private readonly periods;
|
|
47
|
+
constructor(initial?: Readonly<Record<string, PeriodUsage>>);
|
|
48
|
+
/**
|
|
49
|
+
* Counts `line` in its period and returns that period, or null for a line
|
|
50
|
+
* that is not a countable decision: an unknown mode or verdict, a
|
|
51
|
+
* `delegated` that is not a boolean, a `jti` that is not a string, an `at`
|
|
52
|
+
* that is not a time. A line outside `only`, when given, is not counted.
|
|
53
|
+
*/
|
|
54
|
+
add(line: UsageLine, only?: UsagePeriod): string | null;
|
|
55
|
+
/** What `period` counted; the empty usage when it counted nothing. */
|
|
56
|
+
usage(period: string): PeriodUsage;
|
|
57
|
+
/** The periods that counted anything, oldest first. */
|
|
58
|
+
counted(): readonly string[];
|
|
59
|
+
/** Forgets `period`, once its report is delivered and it is old enough to need no recount. */
|
|
60
|
+
forget(period: string): void;
|
|
61
|
+
snapshot(): Readonly<Record<string, PeriodUsage>>;
|
|
62
|
+
}
|
|
63
|
+
//# sourceMappingURL=UsageTally.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"UsageTally.d.ts","sourceRoot":"","sources":["../../src/edge/UsageTally.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAExE,eAAO,MAAM,WAAW,oCAAqC,CAAC;AAC9D,eAAO,MAAM,cAAc,yCAA0C,CAAC;AAEtE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AACrD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,4FAA4F;AAC5F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,8FAA8F;AAC9F,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QACtD,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,qCAAqC;AACrC,wBAAgB,UAAU,IAAI,WAAW,CAcxC;AAMD;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;gBAEvC,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAM;IAItE;;;;;OAKG;IACI,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAiC9D,sEAAsE;IAC/D,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW;IAIzC,uDAAuD;IAChD,OAAO,IAAI,SAAS,MAAM,EAAE;IAInC,8FAA8F;IACvF,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5B,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAGzD"}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import { inPeriod, periodOf } from "./UsagePeriod.js";
|
|
2
|
+
export const USAGE_MODES = ["ENFORCEMENT", "SHADOW"];
|
|
3
|
+
export const USAGE_VERDICTS = ["ALLOW", "ESCALATE", "BLOCK"];
|
|
4
|
+
/** A period with nothing counted. */
|
|
5
|
+
export function emptyUsage() {
|
|
6
|
+
return {
|
|
7
|
+
counts: {
|
|
8
|
+
by_mode: { ENFORCEMENT: 0, SHADOW: 0 },
|
|
9
|
+
by_verdict: { ALLOW: 0, ESCALATE: 0, BLOCK: 0 },
|
|
10
|
+
total: 0,
|
|
11
|
+
},
|
|
12
|
+
delegated: 0,
|
|
13
|
+
first_seq: null,
|
|
14
|
+
first_hash: null,
|
|
15
|
+
last_seq: null,
|
|
16
|
+
last_hash: null,
|
|
17
|
+
bundles: [],
|
|
18
|
+
};
|
|
19
|
+
}
|
|
20
|
+
function isMember(values, value) {
|
|
21
|
+
return values.includes(value);
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* The count of `EDGE_DECISION` lines per UTC month, the same count whether
|
|
25
|
+
* it is kept as lines are written or recounted later from the chain. A line
|
|
26
|
+
* is counted in the period its `at` falls in; lines arrive in chain order,
|
|
27
|
+
* so the first and last counted lines are the period's range. Every edge
|
|
28
|
+
* decision is counted once in `total`; the delegated ones are also counted
|
|
29
|
+
* in `delegated`, which Decionis subtracts because it meters those itself.
|
|
30
|
+
*/
|
|
31
|
+
export class UsageTally {
|
|
32
|
+
periods = new Map();
|
|
33
|
+
constructor(initial = {}) {
|
|
34
|
+
for (const [period, usage] of Object.entries(initial))
|
|
35
|
+
this.periods.set(period, usage);
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Counts `line` in its period and returns that period, or null for a line
|
|
39
|
+
* that is not a countable decision: an unknown mode or verdict, a
|
|
40
|
+
* `delegated` that is not a boolean, a `jti` that is not a string, an `at`
|
|
41
|
+
* that is not a time. A line outside `only`, when given, is not counted.
|
|
42
|
+
*/
|
|
43
|
+
add(line, only) {
|
|
44
|
+
const at = Date.parse(line.at);
|
|
45
|
+
if (Number.isNaN(at) ||
|
|
46
|
+
!isMember(USAGE_MODES, line.mode) ||
|
|
47
|
+
!isMember(USAGE_VERDICTS, line.verdict) ||
|
|
48
|
+
typeof line.delegated !== "boolean" ||
|
|
49
|
+
typeof line.jti !== "string" ||
|
|
50
|
+
(only !== undefined && !inPeriod(only, at))) {
|
|
51
|
+
return null;
|
|
52
|
+
}
|
|
53
|
+
const period = periodOf(at).period;
|
|
54
|
+
const usage = this.usage(period);
|
|
55
|
+
this.periods.set(period, {
|
|
56
|
+
counts: {
|
|
57
|
+
by_mode: { ...usage.counts.by_mode, [line.mode]: usage.counts.by_mode[line.mode] + 1 },
|
|
58
|
+
by_verdict: {
|
|
59
|
+
...usage.counts.by_verdict,
|
|
60
|
+
[line.verdict]: usage.counts.by_verdict[line.verdict] + 1,
|
|
61
|
+
},
|
|
62
|
+
total: usage.counts.total + 1,
|
|
63
|
+
},
|
|
64
|
+
delegated: usage.delegated + (line.delegated ? 1 : 0),
|
|
65
|
+
first_seq: usage.first_seq ?? line.seq,
|
|
66
|
+
first_hash: usage.first_hash ?? line.hash,
|
|
67
|
+
last_seq: line.seq,
|
|
68
|
+
last_hash: line.hash,
|
|
69
|
+
bundles: [...new Set([...usage.bundles, line.jti])].sort(),
|
|
70
|
+
});
|
|
71
|
+
return period;
|
|
72
|
+
}
|
|
73
|
+
/** What `period` counted; the empty usage when it counted nothing. */
|
|
74
|
+
usage(period) {
|
|
75
|
+
return this.periods.get(period) ?? emptyUsage();
|
|
76
|
+
}
|
|
77
|
+
/** The periods that counted anything, oldest first. */
|
|
78
|
+
counted() {
|
|
79
|
+
return [...this.periods.keys()].sort();
|
|
80
|
+
}
|
|
81
|
+
/** Forgets `period`, once its report is delivered and it is old enough to need no recount. */
|
|
82
|
+
forget(period) {
|
|
83
|
+
this.periods.delete(period);
|
|
84
|
+
}
|
|
85
|
+
snapshot() {
|
|
86
|
+
return Object.fromEntries(this.periods);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
//# sourceMappingURL=UsageTally.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"UsageTally.js","sourceRoot":"","sources":["../../src/edge/UsageTally.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
/** Every way the sealed egress refuses a request, as a stable code. */
|
|
2
|
-
export type EgressCode = "EGRESS_SCHEME_NOT_ALLOWED" | "EGRESS_ORIGIN_NOT_ALLOWED" | "EGRESS_PATH_NOT_ALLOWED" | "EGRESS_ADDRESS_REFUSED" | "EGRESS_TLS_REJECTED" | "
|
|
2
|
+
export type EgressCode = "EGRESS_SCHEME_NOT_ALLOWED" | "EGRESS_ORIGIN_NOT_ALLOWED" | "EGRESS_PATH_NOT_ALLOWED" | "EGRESS_ADDRESS_REFUSED" | "EGRESS_TLS_REJECTED" | "EGRESS_TLS_CLIENT_CERT_REFUSED"
|
|
3
|
+
/**
|
|
4
|
+
* TLS failed once the peer was verified: reported on the security stream,
|
|
5
|
+
* never thrown, since the connection may have carried the request and its
|
|
6
|
+
* own error is what the caller gets.
|
|
7
|
+
*/
|
|
8
|
+
| "EGRESS_TLS_BROKEN" | "EGRESS_TLS_PIN_MISMATCH" | "EGRESS_BODY_TOO_LARGE" | "EGRESS_TIMEOUT" | "EGRESS_REDIRECT_REFUSED" | "EGRESS_RESPONSE_INVALID" | "EGRESS_INIT_UNSUPPORTED" | "EGRESS_GLOBAL_FETCH_LOCKED";
|
|
3
9
|
/**
|
|
4
10
|
* A refusal by the executor's own egress policy: the code, and the origin it
|
|
5
11
|
* concerned. Never the path, the headers, or anything from the request or
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"EgressError.d.ts","sourceRoot":"","sources":["../../src/egress/EgressError.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,MAAM,UAAU,GAClB,2BAA2B,GAC3B,2BAA2B,GAC3B,yBAAyB,GACzB,wBAAwB,GACxB,qBAAqB,GACrB,yBAAyB,GACzB,uBAAuB,GACvB,gBAAgB,GAChB,yBAAyB,GACzB,yBAAyB,GACzB,yBAAyB,GACzB,4BAA4B,CAAC;AAEjC;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAElB,IAAI,EAAE,UAAU;aAChB,MAAM,EAAE,MAAM,GAAG,IAAI;gBADrB,IAAI,EAAE,UAAU,EAChB,MAAM,GAAE,MAAM,GAAG,IAAW;CAK/C"}
|
|
1
|
+
{"version":3,"file":"EgressError.d.ts","sourceRoot":"","sources":["../../src/egress/EgressError.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,MAAM,UAAU,GAClB,2BAA2B,GAC3B,2BAA2B,GAC3B,yBAAyB,GACzB,wBAAwB,GACxB,qBAAqB,GACrB,gCAAgC;AAClC;;;;GAIG;GACD,mBAAmB,GACnB,yBAAyB,GACzB,uBAAuB,GACvB,gBAAgB,GAChB,yBAAyB,GACzB,yBAAyB,GACzB,yBAAyB,GACzB,4BAA4B,CAAC;AAEjC;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAElB,IAAI,EAAE,UAAU;aAChB,MAAM,EAAE,MAAM,GAAG,IAAI;gBADrB,IAAI,EAAE,UAAU,EAChB,MAAM,GAAE,MAAM,GAAG,IAAW;CAK/C"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"EgressError.js","sourceRoot":"","sources":["../../src/egress/EgressError.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"EgressError.js","sourceRoot":"","sources":["../../src/egress/EgressError.ts"],"names":[],"mappings":"AAsBA;;;;GAIG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAElB;IACA;IAFlB,YACkB,IAAgB,EAChB,SAAwB,IAAI;QAE5C,KAAK,CAAC,IAAI,CAAC,CAAC;QAHI,SAAI,GAAJ,IAAI,CAAY;QAChB,WAAM,GAAN,MAAM,CAAsB;QAG5C,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}
|
|
@@ -38,10 +38,23 @@ export declare class EgressPolicy {
|
|
|
38
38
|
/**
|
|
39
39
|
* Whether a resolved address may be connected to for an origin. A loopback
|
|
40
40
|
* origin must stay on this host; any other must never resolve to this
|
|
41
|
-
* host, the link, multicast, or nowhere.
|
|
42
|
-
*
|
|
41
|
+
* host, the link, multicast, or nowhere. `publicOnly` is for a destination
|
|
42
|
+
* someone other than the operator chose, as a hosted gateway's tenant
|
|
43
|
+
* chooses its upstream: it also refuses every private and shared range,
|
|
44
|
+
* the Azure platform address, and NAT64, so a name cannot reach inward.
|
|
45
|
+
* IPv4-mapped IPv6 addresses match the IPv4 ranges. The lists are built per
|
|
46
|
+
* call so that nothing about them is decided at module load.
|
|
43
47
|
*/
|
|
44
|
-
static addressRefused(address: string, loopbackOrigin: boolean): boolean;
|
|
48
|
+
static addressRefused(address: string, loopbackOrigin: boolean, publicOnly?: boolean): boolean;
|
|
49
|
+
/**
|
|
50
|
+
* Whether a URL's hostname is an address, written as the host, that the
|
|
51
|
+
* policy refuses. Connecting to such a host resolves nothing, so the
|
|
52
|
+
* resolver's check never sees it; this is that check. A name that is not an
|
|
53
|
+
* address is not refused here.
|
|
54
|
+
*/
|
|
55
|
+
static hostAddressRefused(hostname: string, publicOnly?: boolean): boolean;
|
|
56
|
+
/** A URL's hostname as the address it is, without an IPv6 address's brackets; null for a name. */
|
|
57
|
+
static addressOf(hostname: string): string | null;
|
|
45
58
|
/** The three loopback spellings the configuration accepts. */
|
|
46
59
|
static isLoopbackHost(hostname: string): boolean;
|
|
47
60
|
/** The origin the configuration named, exactly as the URL class spells it. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"EgressPolicy.d.ts","sourceRoot":"","sources":["../../src/egress/EgressPolicy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,6BAA6B,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,iFAAiF;IACjF,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3D;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;gBAEnD,YAAY,EAAE,SAAS,iBAAiB,EAAE;IAiB7D,0EAA0E;WAC5D,UAAU,CACtB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GACjC,YAAY;IAsCf,IAAW,OAAO,IAAI,SAAS,MAAM,EAAE,CAEtC;IAED,iFAAiF;IAC1E,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,WAAW;IAmBnC,gHAAgH;WAClG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAIpE
|
|
1
|
+
{"version":3,"file":"EgressPolicy.d.ts","sourceRoot":"","sources":["../../src/egress/EgressPolicy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,6BAA6B,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,iFAAiF;IACjF,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3D;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;gBAEnD,YAAY,EAAE,SAAS,iBAAiB,EAAE;IAiB7D,0EAA0E;WAC5D,UAAU,CACtB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GACjC,YAAY;IAsCf,IAAW,OAAO,IAAI,SAAS,MAAM,EAAE,CAEtC;IAED,iFAAiF;IAC1E,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,WAAW;IAmBnC,gHAAgH;WAClG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAIpE;;;;;;;;;OASG;WACW,cAAc,CAC1B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,OAAO,EACvB,UAAU,UAAQ,GACjB,OAAO;IAgCV;;;;;OAKG;WACW,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,OAAO;IAQ/E,kGAAkG;WACpF,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKxD,8DAA8D;WAChD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIvD,8EAA8E;WAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI3C,0FAA0F;WAC5E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI3C,+FAA+F;WACjF,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAI/C,OAAO,CAAC,MAAM,CAAC,MAAM;CAMtB"}
|
|
@@ -86,10 +86,14 @@ export class EgressPolicy {
|
|
|
86
86
|
/**
|
|
87
87
|
* Whether a resolved address may be connected to for an origin. A loopback
|
|
88
88
|
* origin must stay on this host; any other must never resolve to this
|
|
89
|
-
* host, the link, multicast, or nowhere.
|
|
90
|
-
*
|
|
89
|
+
* host, the link, multicast, or nowhere. `publicOnly` is for a destination
|
|
90
|
+
* someone other than the operator chose, as a hosted gateway's tenant
|
|
91
|
+
* chooses its upstream: it also refuses every private and shared range,
|
|
92
|
+
* the Azure platform address, and NAT64, so a name cannot reach inward.
|
|
93
|
+
* IPv4-mapped IPv6 addresses match the IPv4 ranges. The lists are built per
|
|
94
|
+
* call so that nothing about them is decided at module load.
|
|
91
95
|
*/
|
|
92
|
-
static addressRefused(address, loopbackOrigin) {
|
|
96
|
+
static addressRefused(address, loopbackOrigin, publicOnly = false) {
|
|
93
97
|
const family = isIP(address);
|
|
94
98
|
if (family === 0)
|
|
95
99
|
return true;
|
|
@@ -109,8 +113,34 @@ export class EgressPolicy {
|
|
|
109
113
|
list.addAddress("::1", "ipv6");
|
|
110
114
|
list.addSubnet("fe80::", 10, "ipv6");
|
|
111
115
|
list.addSubnet("ff00::", 8, "ipv6");
|
|
116
|
+
if (publicOnly) {
|
|
117
|
+
list.addSubnet("10.0.0.0", 8, "ipv4");
|
|
118
|
+
list.addSubnet("100.64.0.0", 10, "ipv4");
|
|
119
|
+
list.addSubnet("172.16.0.0", 12, "ipv4");
|
|
120
|
+
list.addSubnet("192.168.0.0", 16, "ipv4");
|
|
121
|
+
list.addSubnet("198.18.0.0", 15, "ipv4");
|
|
122
|
+
list.addAddress("168.63.129.16", "ipv4");
|
|
123
|
+
list.addSubnet("fc00::", 7, "ipv6");
|
|
124
|
+
list.addSubnet("64:ff9b::", 96, "ipv6");
|
|
125
|
+
}
|
|
112
126
|
return list.check(address, type);
|
|
113
127
|
}
|
|
128
|
+
/**
|
|
129
|
+
* Whether a URL's hostname is an address, written as the host, that the
|
|
130
|
+
* policy refuses. Connecting to such a host resolves nothing, so the
|
|
131
|
+
* resolver's check never sees it; this is that check. A name that is not an
|
|
132
|
+
* address is not refused here.
|
|
133
|
+
*/
|
|
134
|
+
static hostAddressRefused(hostname, publicOnly = false) {
|
|
135
|
+
const literal = EgressPolicy.addressOf(hostname);
|
|
136
|
+
return (literal !== null &&
|
|
137
|
+
EgressPolicy.addressRefused(literal, EgressPolicy.isLoopbackHost(hostname), publicOnly));
|
|
138
|
+
}
|
|
139
|
+
/** A URL's hostname as the address it is, without an IPv6 address's brackets; null for a name. */
|
|
140
|
+
static addressOf(hostname) {
|
|
141
|
+
const literal = hostname.startsWith("[") ? hostname.slice(1, -1) : hostname;
|
|
142
|
+
return isIP(literal) === 0 ? null : literal;
|
|
143
|
+
}
|
|
114
144
|
/** The three loopback spellings the configuration accepts. */
|
|
115
145
|
static isLoopbackHost(hostname) {
|
|
116
146
|
return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"EgressPolicy.js","sourceRoot":"","sources":["../../src/egress/EgressPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAiB3C;;;;;;;;;GASG;AACH,MAAM,OAAO,YAAY;IACN,YAAY,CAAyC;IAEtE,YAAmB,YAA0C;QAC3D,MAAM,MAAM,GAAG,IAAI,GAAG,EAA6B,CAAC;QACpD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAChD,MAAM,CAAC,GAAG,CACR,WAAW,CAAC,MAAM,EAClB,QAAQ,KAAK,SAAS;gBACpB,CAAC,CAAC,WAAW;gBACb,CAAC,CAAC;oBACE,GAAG,QAAQ;oBACX,YAAY,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,YAAY,EAAE,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC;iBACpF,CACN,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;IAC7B,CAAC;IAED,0EAA0E;IACnE,MAAM,CAAC,UAAU,CACtB,MAAsB,EACtB,QAAkC;QAElC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAClC,MAAM,QAAQ,GAAG,CACf,IAAuB,EACvB,MAAmB,EACnB,GAAW,EACU,EAAE,CACvB,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACjB,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC;YAClC,YAAY,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC1C,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC;YACrF,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC,CAAC,CAAC;QACN,MAAM,UAAU,GAAG;YACjB,MAAM,CAAC,UAAU,CAAC,GAAG;YACrB,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;YAC9E,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,KAAK,iBAAiB;gBACzD,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC;gBACzC,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,oBAAoB,KAAK,IAAI;gBAC9C,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;SAC3C,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAChC,MAAM,IAAI,GACR,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI;YAClC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,uBAAuB,CAAC,CAAC;QAC7F,OAAO,IAAI,YAAY,CAAC;YACtB,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,kBAAkB,CAAC;YAC5E,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,KAAK,QAAQ;gBACrC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,QAAQ,EAAE,kBAAkB,CAAC;gBACpF,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,oBAAoB,CAAC;YAC/D,GAAG,IAAI;SACR,CAAC,CAAC;IACL,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,iFAAiF;IAC1E,KAAK,CAAC,GAAQ;QACnB,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAC1D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,2BAA2B,EAAE,CAAC;QAC/D,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,2BAA2B,EAAE,CAAC;QAC/D,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,EAAE,CAAC;YAC/C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,2BAA2B,EAAE,CAAC;QAC/D,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,2BAA2B,EAAE,CAAC;QAC5F,MAAM,KAAK,GAAG,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CACrD,YAAY,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAC/C,CAAC;QACF,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,yBAAyB,EAAE,CAAC;QACvE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IACxC,CAAC;IAED,gHAAgH;IACzG,MAAM,CAAC,WAAW,CAAC,QAAgB,EAAE,MAAc;QACxD,OAAO,QAAQ,KAAK,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;IAClG,CAAC;IAED
|
|
1
|
+
{"version":3,"file":"EgressPolicy.js","sourceRoot":"","sources":["../../src/egress/EgressPolicy.ts"],"names":[],"mappings":"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"}
|
|
@@ -16,7 +16,30 @@ export interface GuardedFetchOptions {
|
|
|
16
16
|
readonly resolve?: AddressResolver;
|
|
17
17
|
/** The executor's own ceiling on any one request, headers and body included. */
|
|
18
18
|
readonly timeoutMs?: number;
|
|
19
|
+
/** Refuse every private and shared address too (EgressPolicy.addressRefused). */
|
|
20
|
+
readonly publicOnly?: boolean;
|
|
21
|
+
/**
|
|
22
|
+
* Whether a TLS failure is this process's own `EGRESS_REFUSED`, as it is
|
|
23
|
+
* unless this says otherwise: a destination the operator named whose
|
|
24
|
+
* handshake fails, or whose verified session breaks, is an attack until
|
|
25
|
+
* shown otherwise. False is for a destination someone else chose, whose TLS
|
|
26
|
+
* is theirs to fix: a refused handshake is thrown with its code, a broken
|
|
27
|
+
* session with its own error, and the caller reports either as it sees fit.
|
|
28
|
+
*/
|
|
29
|
+
readonly reportTls?: boolean;
|
|
19
30
|
}
|
|
31
|
+
/**
|
|
32
|
+
* A peer's alert refusing this side's certificate, which this process never
|
|
33
|
+
* presents: `certificate_required` (TLS 1.3), `bad_certificate`,
|
|
34
|
+
* `certificate_unknown`, `unknown_ca` or `access_denied`, as servers that do
|
|
35
|
+
* not send the first send instead. Any of them says the peer refused the
|
|
36
|
+
* handshake on its side, about a certificate that can only be this side's,
|
|
37
|
+
* since this side had already verified the peer's: under TLS 1.3 it arrives
|
|
38
|
+
* after this side's half of the handshake, but the peer's never completed,
|
|
39
|
+
* so nothing was accepted. Under TLS 1.2 the usual refusal is a bare
|
|
40
|
+
* handshake failure, which says no more than that.
|
|
41
|
+
*/
|
|
42
|
+
export declare const CLIENT_CERTIFICATE_REFUSED: RegExp;
|
|
20
43
|
/**
|
|
21
44
|
* The one way this process opens a connection. Every request is checked
|
|
22
45
|
* against the sealed policy before a socket exists; a name is resolved once
|
|
@@ -42,8 +65,22 @@ export declare class GuardedFetch {
|
|
|
42
65
|
private inspectRedirect;
|
|
43
66
|
/** Every refusal is an event with the origin and the code; the error carries the same and no more. */
|
|
44
67
|
private refuse;
|
|
45
|
-
/**
|
|
68
|
+
/**
|
|
69
|
+
* A failure of the executor's own making is reported; the caller's abort
|
|
70
|
+
* and the network's failures pass through. A handshake that failed is a
|
|
71
|
+
* refusal, and nothing was sent: the peer's certificate did not verify,
|
|
72
|
+
* or the peer refused this side, by refusing its certificate
|
|
73
|
+
* (`EGRESS_TLS_CLIENT_CERT_REFUSED`) or otherwise. A TLS failure once the
|
|
74
|
+
* peer was verified broke a connection that may have carried the request,
|
|
75
|
+
* so it is not a refusal and its own error passes through; it is still
|
|
76
|
+
* reported, as `EGRESS_TLS_BROKEN`, unless the caller reports TLS itself
|
|
77
|
+
* (`reportTls: false`): records that break a verified session are an
|
|
78
|
+
* attack until shown otherwise, and count toward the halt switch and the
|
|
79
|
+
* refusal alerts as they did when they were called a rejected handshake.
|
|
80
|
+
*/
|
|
46
81
|
private classify;
|
|
82
|
+
/** A refused handshake: on the security stream, unless the caller reports it itself. */
|
|
83
|
+
private refuseTls;
|
|
47
84
|
private agentFor;
|
|
48
85
|
/** Resolves once and connects only to what was resolved; one forbidden answer refuses the whole name. */
|
|
49
86
|
private lookupFor;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"GuardedFetch.d.ts","sourceRoot":"","sources":["../../src/egress/GuardedFetch.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"GuardedFetch.d.ts","sourceRoot":"","sources":["../../src/egress/GuardedFetch.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;CACxB;AAED,gFAAgF;AAChF,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;AAExF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,iGAAiG;IACjG,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,gFAAgF;IAChF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAOD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,QACyD,CAAC;AAOjG;;;;;;;;;GASG;AACH,qBAAa,YAAY;IAMJ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL3C,SAAgB,KAAK,EAAE,SAAS,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEC,OAAO,EAAE,mBAAmB;IAMzD,KAAK,IAAI,IAAI;YAKN,OAAO;IA6BrB,OAAO,CAAC,OAAO;IA2Df,yFAAyF;YAC3E,OAAO;IA8CrB,OAAO,CAAC,eAAe;IAYvB,sGAAsG;IACtG,OAAO,CAAC,MAAM;IAKd;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,QAAQ;IAiBhB,wFAAwF;IACxF,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,QAAQ;IA2BhB,yGAAyG;IACzG,OAAO,CAAC,SAAS;IAiCjB,6FAA6F;IAC7F,OAAO,CAAC,MAAM,CAAC,QAAQ;IAqBvB,OAAO,CAAC,MAAM,CAAC,IAAI;IASnB,OAAO,CAAC,MAAM,CAAC,OAAO;IActB,OAAO,CAAC,MAAM,CAAC,WAAW;CAM3B"}
|