@decionis/agentsafe 0.2.4 → 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 +20 -0
- package/dist/Cli.js.map +1 -1
- package/dist/Index.d.ts +22 -5
- package/dist/Index.d.ts.map +1 -1
- package/dist/Index.js +19 -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 +91 -0
- package/dist/adapters/mcp/McpGuard.d.ts.map +1 -0
- package/dist/adapters/mcp/McpGuard.js +147 -0
- package/dist/adapters/mcp/McpGuard.js.map +1 -0
- package/dist/adapters/mcp/McpIntentBinder.d.ts +54 -0
- package/dist/adapters/mcp/McpIntentBinder.d.ts.map +1 -0
- package/dist/adapters/mcp/McpIntentBinder.js +79 -0
- package/dist/adapters/mcp/McpIntentBinder.js.map +1 -0
- package/dist/adapters/mcp/McpInvocation.d.ts +55 -0
- package/dist/adapters/mcp/McpInvocation.d.ts.map +1 -0
- package/dist/adapters/mcp/McpInvocation.js +88 -0
- package/dist/adapters/mcp/McpInvocation.js.map +1 -0
- 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/boundary/BoundaryIdentity.d.ts +88 -0
- package/dist/boundary/BoundaryIdentity.d.ts.map +1 -0
- package/dist/boundary/BoundaryIdentity.js +126 -0
- package/dist/boundary/BoundaryIdentity.js.map +1 -0
- package/dist/cli/Commands.d.ts +1 -1
- package/dist/cli/Commands.d.ts.map +1 -1
- package/dist/cli/Commands.js +10 -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 +9 -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/Identity.d.ts +47 -0
- package/dist/cli/Identity.d.ts.map +1 -0
- package/dist/cli/Identity.js +145 -0
- package/dist/cli/Identity.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/cli/TestCommand.d.ts +8 -0
- package/dist/cli/TestCommand.d.ts.map +1 -1
- package/dist/cli/TestCommand.js +25 -5
- package/dist/cli/TestCommand.js.map +1 -1
- 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/AuthorityAttacks.d.ts +39 -0
- package/dist/gateway/AuthorityAttacks.d.ts.map +1 -0
- package/dist/gateway/AuthorityAttacks.js +158 -0
- package/dist/gateway/AuthorityAttacks.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 +197 -10
- package/dist/gateway/Gateway.d.ts.map +1 -1
- package/dist/gateway/Gateway.js +524 -63
- package/dist/gateway/Gateway.js.map +1 -1
- package/dist/gateway/GatewayConfig.d.ts +78 -0
- package/dist/gateway/GatewayConfig.d.ts.map +1 -1
- package/dist/gateway/GatewayConfig.js +167 -2
- package/dist/gateway/GatewayConfig.js.map +1 -1
- package/dist/gateway/GatewayReport.d.ts +31 -1
- package/dist/gateway/GatewayReport.d.ts.map +1 -1
- package/dist/gateway/GatewayReport.js +12 -0
- package/dist/gateway/GatewayReport.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/provenance/DockerProvenanceProvider.d.ts +23 -0
- package/dist/provenance/DockerProvenanceProvider.d.ts.map +1 -0
- package/dist/provenance/DockerProvenanceProvider.js +24 -0
- package/dist/provenance/DockerProvenanceProvider.js.map +1 -0
- package/dist/provenance/KubernetesProvenanceProvider.d.ts +17 -0
- package/dist/provenance/KubernetesProvenanceProvider.d.ts.map +1 -0
- package/dist/provenance/KubernetesProvenanceProvider.js +18 -0
- package/dist/provenance/KubernetesProvenanceProvider.js.map +1 -0
- package/dist/provenance/NoneProvenanceProvider.d.ts +15 -0
- package/dist/provenance/NoneProvenanceProvider.d.ts.map +1 -0
- package/dist/provenance/NoneProvenanceProvider.js +16 -0
- package/dist/provenance/NoneProvenanceProvider.js.map +1 -0
- package/dist/provenance/ProvenanceProvider.d.ts +94 -0
- package/dist/provenance/ProvenanceProvider.d.ts.map +1 -0
- package/dist/provenance/ProvenanceProvider.js +118 -0
- package/dist/provenance/ProvenanceProvider.js.map +1 -0
- package/dist/provenance/StaticProvenanceProvider.d.ts +18 -0
- package/dist/provenance/StaticProvenanceProvider.d.ts.map +1 -0
- package/dist/provenance/StaticProvenanceProvider.js +25 -0
- package/dist/provenance/StaticProvenanceProvider.js.map +1 -0
- 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,139 @@
|
|
|
1
|
+
import { readFile } from "node:fs/promises";
|
|
2
|
+
import { ENTITLEMENT_TYPE } from "./EntitlementEvaluation.js";
|
|
3
|
+
/** Where Decionis publishes the keys that sign policy bundles and the entitlement. */
|
|
4
|
+
export const ENTITLEMENT_JWKS_PATH = "/.well-known/decionis-policy-bundle-jwks.json";
|
|
5
|
+
export const ENTITLEMENT_PATH = "/v1/edge/entitlement";
|
|
6
|
+
const COMPACT_JWS = /^[\w-]+\.[\w-]+\.[\w-]+$/;
|
|
7
|
+
const MAX_BYTES = 256 * 1024;
|
|
8
|
+
/** A base URL without its trailing slashes, trimmed in one pass. */
|
|
9
|
+
export function withoutTrailingSlash(url) {
|
|
10
|
+
let end = url.length;
|
|
11
|
+
while (end > 0 && url[end - 1] === "/")
|
|
12
|
+
end -= 1;
|
|
13
|
+
return url.slice(0, end);
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* The compact JWS out of what a source returned: the JWS on its own, or a
|
|
17
|
+
* JSON object carrying it as `entitlement` or `signed_entitlement`.
|
|
18
|
+
*/
|
|
19
|
+
export function entitlementTokenOf(text) {
|
|
20
|
+
const trimmed = text.trim();
|
|
21
|
+
let candidate = trimmed;
|
|
22
|
+
if (trimmed.startsWith("{")) {
|
|
23
|
+
try {
|
|
24
|
+
const body = JSON.parse(trimmed);
|
|
25
|
+
candidate = body["signed_entitlement"] ?? body["entitlement"];
|
|
26
|
+
}
|
|
27
|
+
catch {
|
|
28
|
+
return null;
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
return typeof candidate === "string" && COMPACT_JWS.test(candidate) ? candidate : null;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Checks the entitlement's signature against the JWKS: `alg` EdDSA, the
|
|
35
|
+
* entitlement's `typ`, a `kid` the JWKS holds. Its claims are evaluated
|
|
36
|
+
* elsewhere (`licenceWarnings`), so an expired entitlement is still read.
|
|
37
|
+
*/
|
|
38
|
+
export async function verifyEntitlement(material) {
|
|
39
|
+
if (material.token === null)
|
|
40
|
+
return { status: "missing" };
|
|
41
|
+
const { compactVerify, decodeProtectedHeader, importJWK } = await import("jose");
|
|
42
|
+
try {
|
|
43
|
+
const header = decodeProtectedHeader(material.token);
|
|
44
|
+
const keys = JSON.parse(material.jwks ?? "null").keys;
|
|
45
|
+
const jwk = Array.isArray(keys)
|
|
46
|
+
? keys.find((key) => key["kid"] === header.kid)
|
|
47
|
+
: undefined;
|
|
48
|
+
if (header.alg !== "EdDSA" || header.typ !== ENTITLEMENT_TYPE || jwk === undefined) {
|
|
49
|
+
return { status: "read", claims: null };
|
|
50
|
+
}
|
|
51
|
+
const key = await importJWK({ ...jwk, alg: "EdDSA" }, "EdDSA");
|
|
52
|
+
const { payload } = await compactVerify(material.token, key, { algorithms: ["EdDSA"] });
|
|
53
|
+
return { status: "read", claims: JSON.parse(new TextDecoder().decode(payload)) };
|
|
54
|
+
}
|
|
55
|
+
catch {
|
|
56
|
+
return { status: "read", claims: null };
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
async function boundedText(response) {
|
|
60
|
+
const text = await response.text();
|
|
61
|
+
return Buffer.byteLength(text) > MAX_BYTES ? null : text;
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* `GET /v1/edge/entitlement` with the organisation's key, and the JWKS from
|
|
65
|
+
* its well-known path on the same origin, both through the guarded fetch.
|
|
66
|
+
* A failure of either is a missing entitlement or keys, never an error: the
|
|
67
|
+
* entitlement only ever warns.
|
|
68
|
+
*/
|
|
69
|
+
export class UrlEntitlementSource {
|
|
70
|
+
options;
|
|
71
|
+
constructor(options) {
|
|
72
|
+
this.options = options;
|
|
73
|
+
}
|
|
74
|
+
async read() {
|
|
75
|
+
const base = withoutTrailingSlash(this.options.baseUrl);
|
|
76
|
+
const [entitlement, jwks] = await Promise.all([
|
|
77
|
+
this.get(`${base}${ENTITLEMENT_PATH}`, true),
|
|
78
|
+
this.get(`${base}${ENTITLEMENT_JWKS_PATH}`, false),
|
|
79
|
+
]);
|
|
80
|
+
return { token: entitlement === null ? null : entitlementTokenOf(entitlement), jwks };
|
|
81
|
+
}
|
|
82
|
+
async get(url, authenticated) {
|
|
83
|
+
const controller = new AbortController();
|
|
84
|
+
const timeout = setTimeout(() => controller.abort(), this.options.timeoutMs ?? 10_000);
|
|
85
|
+
try {
|
|
86
|
+
const response = await this.options.fetch(url, {
|
|
87
|
+
method: "GET",
|
|
88
|
+
headers: {
|
|
89
|
+
accept: "application/json",
|
|
90
|
+
...(authenticated ? { authorization: `Bearer ${this.options.apiKey()}` } : {}),
|
|
91
|
+
},
|
|
92
|
+
signal: controller.signal,
|
|
93
|
+
});
|
|
94
|
+
if (!response.ok) {
|
|
95
|
+
await response.body?.cancel().catch(() => undefined);
|
|
96
|
+
return null;
|
|
97
|
+
}
|
|
98
|
+
return await boundedText(response);
|
|
99
|
+
}
|
|
100
|
+
catch {
|
|
101
|
+
return null;
|
|
102
|
+
}
|
|
103
|
+
finally {
|
|
104
|
+
clearTimeout(timeout);
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
/**
|
|
109
|
+
* The air-gapped form: the entitlement an operator downloaded and placed on
|
|
110
|
+
* disk, and the Decionis JWKS pinned beside it. Either file missing is a
|
|
111
|
+
* missing entitlement or keys.
|
|
112
|
+
*/
|
|
113
|
+
export class FileEntitlementSource {
|
|
114
|
+
entitlementFile;
|
|
115
|
+
jwksFile;
|
|
116
|
+
constructor(entitlementFile, jwksFile) {
|
|
117
|
+
this.entitlementFile = entitlementFile;
|
|
118
|
+
this.jwksFile = jwksFile;
|
|
119
|
+
}
|
|
120
|
+
async read() {
|
|
121
|
+
const read = async (path) => {
|
|
122
|
+
if (path === null)
|
|
123
|
+
return null;
|
|
124
|
+
try {
|
|
125
|
+
const text = await readFile(path, "utf8");
|
|
126
|
+
return Buffer.byteLength(text) > MAX_BYTES ? null : text;
|
|
127
|
+
}
|
|
128
|
+
catch {
|
|
129
|
+
return null;
|
|
130
|
+
}
|
|
131
|
+
};
|
|
132
|
+
const entitlement = await read(this.entitlementFile);
|
|
133
|
+
return {
|
|
134
|
+
token: entitlement === null ? null : entitlementTokenOf(entitlement),
|
|
135
|
+
jwks: await read(this.jwksFile),
|
|
136
|
+
};
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
//# sourceMappingURL=Entitlement.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Entitlement.js","sourceRoot":"","sources":["../../src/edge/Entitlement.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
/** The JWS `typ` of the signed entitlement document. */
|
|
3
|
+
export declare const ENTITLEMENT_TYPE = "decionis-edge-entitlement+jwt";
|
|
4
|
+
/** How long after a period ends its report is due, when no entitlement says otherwise. */
|
|
5
|
+
export declare const DEFAULT_REPORT_DUE_DAYS = 35;
|
|
6
|
+
/**
|
|
7
|
+
* The entitlement's claims (Edge evaluator phase 4, section 2). Claims this
|
|
8
|
+
* host does not read are allowed, so Decionis can add one without breaking
|
|
9
|
+
* a deployed executor. `volume_band` is read only for a ceiling it states.
|
|
10
|
+
*/
|
|
11
|
+
export declare const EntitlementClaimsSchema: z.ZodObject<{
|
|
12
|
+
iss: z.ZodString;
|
|
13
|
+
aud: z.ZodString;
|
|
14
|
+
iat: z.ZodNumber;
|
|
15
|
+
exp: z.ZodNumber;
|
|
16
|
+
plan: z.ZodString;
|
|
17
|
+
tier: z.ZodEnum<{
|
|
18
|
+
hosted: "hosted";
|
|
19
|
+
dedicated: "dedicated";
|
|
20
|
+
self_managed: "self_managed";
|
|
21
|
+
}>;
|
|
22
|
+
included_actions_per_month: z.ZodNullable<z.ZodNumber>;
|
|
23
|
+
volume_band: z.ZodUnknown;
|
|
24
|
+
edge: z.ZodBoolean;
|
|
25
|
+
usage_report_due_days: z.ZodNumber;
|
|
26
|
+
}, z.core.$loose>;
|
|
27
|
+
export type EntitlementClaims = z.infer<typeof EntitlementClaimsSchema>;
|
|
28
|
+
/**
|
|
29
|
+
* What the host could establish about the entitlement before evaluating it:
|
|
30
|
+
* none to read, or one read whose claims are those its signature verified,
|
|
31
|
+
* and null when the signature did not verify.
|
|
32
|
+
*/
|
|
33
|
+
export type EntitlementState = {
|
|
34
|
+
readonly status: "missing";
|
|
35
|
+
} | {
|
|
36
|
+
readonly status: "read";
|
|
37
|
+
readonly claims: unknown;
|
|
38
|
+
};
|
|
39
|
+
/**
|
|
40
|
+
* Everything a licence warning can say. None of them stops or changes a
|
|
41
|
+
* decision: each is a line, a security event and a metric for someone to
|
|
42
|
+
* act on.
|
|
43
|
+
*/
|
|
44
|
+
export type LicenceWarning = "ENTITLEMENT_MISSING" | "ENTITLEMENT_INVALID" | "ENTITLEMENT_EXPIRED" | "EDGE_NOT_ENTITLED" | "INCLUDED_ACTIONS_EXCEEDED" | "VOLUME_BAND_EXCEEDED" | "USAGE_REPORT_KEY_MISSING" | "USAGE_REPORT_OVERDUE";
|
|
45
|
+
export interface LicenceInput {
|
|
46
|
+
readonly entitlement: EntitlementState;
|
|
47
|
+
/** The organisation the executor decides for: the entitlement's audience. */
|
|
48
|
+
readonly orgId: string;
|
|
49
|
+
readonly now: number;
|
|
50
|
+
/** Governed actions this month as this installation counted them: decisions not delegated. */
|
|
51
|
+
readonly governed: number;
|
|
52
|
+
/** Whether a usage-report key is configured; without one no report is ever made. */
|
|
53
|
+
readonly reporting: boolean;
|
|
54
|
+
/** Completed periods whose report has not been delivered. */
|
|
55
|
+
readonly undelivered: readonly string[];
|
|
56
|
+
}
|
|
57
|
+
/**
|
|
58
|
+
* The licence warnings that stand at `now`, in a fixed order. An entitlement
|
|
59
|
+
* that is missing, or whose claims are not an entitlement for this
|
|
60
|
+
* organisation, is a warning about itself and says nothing else; one that
|
|
61
|
+
* verified is read in full even when expired, so every limit it states is
|
|
62
|
+
* reported. A report is overdue once its period ended more than the
|
|
63
|
+
* entitlement's due days ago (35 without one).
|
|
64
|
+
*/
|
|
65
|
+
export declare function licenceWarnings(input: LicenceInput): readonly LicenceWarning[];
|
|
66
|
+
//# sourceMappingURL=EntitlementEvaluation.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"EntitlementEvaluation.d.ts","sourceRoot":"","sources":["../../src/edge/EntitlementEvaluation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,kCAAkC,CAAC;AAEhE,0FAA0F;AAC1F,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAI1C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;iBAWlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAC1B;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAEzF;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB,qBAAqB,GACrB,qBAAqB,GACrB,qBAAqB,GACrB,mBAAmB,GACnB,2BAA2B,GAC3B,sBAAsB,GACtB,0BAA0B,GAC1B,sBAAsB,CAAC;AAE3B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8FAA8F;IAC9F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oFAAoF;IACpF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAQD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,cAAc,EAAE,CA2B9E"}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { reportDueAt, usagePeriod } from "./UsagePeriod.js";
|
|
3
|
+
/** The JWS `typ` of the signed entitlement document. */
|
|
4
|
+
export const ENTITLEMENT_TYPE = "decionis-edge-entitlement+jwt";
|
|
5
|
+
/** How long after a period ends its report is due, when no entitlement says otherwise. */
|
|
6
|
+
export const DEFAULT_REPORT_DUE_DAYS = 35;
|
|
7
|
+
const count = z.number().int().nonnegative();
|
|
8
|
+
/**
|
|
9
|
+
* The entitlement's claims (Edge evaluator phase 4, section 2). Claims this
|
|
10
|
+
* host does not read are allowed, so Decionis can add one without breaking
|
|
11
|
+
* a deployed executor. `volume_band` is read only for a ceiling it states.
|
|
12
|
+
*/
|
|
13
|
+
export const EntitlementClaimsSchema = z.looseObject({
|
|
14
|
+
iss: z.string().min(1),
|
|
15
|
+
aud: z.string().min(1),
|
|
16
|
+
iat: count,
|
|
17
|
+
exp: count,
|
|
18
|
+
plan: z.string().min(1),
|
|
19
|
+
tier: z.enum(["hosted", "dedicated", "self_managed"]),
|
|
20
|
+
included_actions_per_month: count.nullable(),
|
|
21
|
+
volume_band: z.unknown(),
|
|
22
|
+
edge: z.boolean(),
|
|
23
|
+
usage_report_due_days: count,
|
|
24
|
+
});
|
|
25
|
+
/** The ceiling a volume band states, when it states one as `max_actions_per_month`. */
|
|
26
|
+
function bandCeiling(band) {
|
|
27
|
+
const parsed = z.object({ max_actions_per_month: count }).safeParse(band);
|
|
28
|
+
return parsed.success ? parsed.data.max_actions_per_month : null;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* The licence warnings that stand at `now`, in a fixed order. An entitlement
|
|
32
|
+
* that is missing, or whose claims are not an entitlement for this
|
|
33
|
+
* organisation, is a warning about itself and says nothing else; one that
|
|
34
|
+
* verified is read in full even when expired, so every limit it states is
|
|
35
|
+
* reported. A report is overdue once its period ended more than the
|
|
36
|
+
* entitlement's due days ago (35 without one).
|
|
37
|
+
*/
|
|
38
|
+
export function licenceWarnings(input) {
|
|
39
|
+
const warnings = [];
|
|
40
|
+
let claims = null;
|
|
41
|
+
if (input.entitlement.status === "missing")
|
|
42
|
+
warnings.push("ENTITLEMENT_MISSING");
|
|
43
|
+
else {
|
|
44
|
+
const parsed = EntitlementClaimsSchema.safeParse(input.entitlement.claims);
|
|
45
|
+
if (parsed.success && parsed.data.aud === input.orgId)
|
|
46
|
+
claims = parsed.data;
|
|
47
|
+
else
|
|
48
|
+
warnings.push("ENTITLEMENT_INVALID");
|
|
49
|
+
}
|
|
50
|
+
if (claims !== null) {
|
|
51
|
+
if (claims.exp * 1000 <= input.now)
|
|
52
|
+
warnings.push("ENTITLEMENT_EXPIRED");
|
|
53
|
+
if (!claims.edge)
|
|
54
|
+
warnings.push("EDGE_NOT_ENTITLED");
|
|
55
|
+
const included = claims.included_actions_per_month;
|
|
56
|
+
if (included !== null && input.governed > included) {
|
|
57
|
+
warnings.push("INCLUDED_ACTIONS_EXCEEDED");
|
|
58
|
+
}
|
|
59
|
+
const ceiling = bandCeiling(claims.volume_band);
|
|
60
|
+
if (ceiling !== null && input.governed > ceiling)
|
|
61
|
+
warnings.push("VOLUME_BAND_EXCEEDED");
|
|
62
|
+
}
|
|
63
|
+
if (!input.reporting)
|
|
64
|
+
warnings.push("USAGE_REPORT_KEY_MISSING");
|
|
65
|
+
const dueDays = claims?.usage_report_due_days ?? DEFAULT_REPORT_DUE_DAYS;
|
|
66
|
+
const overdue = input.undelivered.some((period) => {
|
|
67
|
+
const parsed = usagePeriod(period);
|
|
68
|
+
return reportDueAt(parsed, dueDays) <= input.now;
|
|
69
|
+
});
|
|
70
|
+
if (overdue)
|
|
71
|
+
warnings.push("USAGE_REPORT_OVERDUE");
|
|
72
|
+
return warnings;
|
|
73
|
+
}
|
|
74
|
+
//# sourceMappingURL=EntitlementEvaluation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"EntitlementEvaluation.js","sourceRoot":"","sources":["../../src/edge/EntitlementEvaluation.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { type PeriodUsage } from "./UsageTally.js";
|
|
2
|
+
import type { UsagePeriod } from "./UsagePeriod.js";
|
|
3
|
+
export type UsageFindingCode = "CHAIN_LINE_INVALID" | "CHAIN_HASH_MISMATCH" | "CHAIN_HEAD_UNKNOWN" | "CHAIN_START_MISSING" | "CHAIN_RANGE_BROKEN" | "USAGE_MISMATCH";
|
|
4
|
+
export interface UsageFinding {
|
|
5
|
+
readonly code: UsageFindingCode;
|
|
6
|
+
/** One-based position in the input, for a finding about one line. */
|
|
7
|
+
readonly line?: number;
|
|
8
|
+
}
|
|
9
|
+
export interface UsageCount {
|
|
10
|
+
readonly ok: boolean;
|
|
11
|
+
readonly usage: PeriodUsage;
|
|
12
|
+
readonly findings: readonly UsageFinding[];
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Counts a period's edge decisions from collected log lines: the chain of
|
|
16
|
+
* `stream` that ends at `head` (the last line in the input unless named) is
|
|
17
|
+
* walked back to its start, and the `EDGE_DECISION` lines on it whose `at`
|
|
18
|
+
* falls in the period are counted. A tampered line anywhere in the stream,
|
|
19
|
+
* or a chain that is cut off after the period began, is a finding, and a
|
|
20
|
+
* report is not made from it.
|
|
21
|
+
*/
|
|
22
|
+
export declare function countUsage(lines: Iterable<string>, options: {
|
|
23
|
+
readonly stream: string;
|
|
24
|
+
readonly period: UsagePeriod;
|
|
25
|
+
readonly head?: string;
|
|
26
|
+
}): UsageCount;
|
|
27
|
+
/** What a usage report claims about its range and counts. */
|
|
28
|
+
export interface ClaimedUsage extends PeriodUsage {
|
|
29
|
+
readonly stream: string;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Recounts a report's period from collected log lines and checks it: the
|
|
33
|
+
* range must be one unbroken chain from `first_hash` back from `last_hash`,
|
|
34
|
+
* and the `EDGE_DECISION` lines on it in the period must count exactly what
|
|
35
|
+
* the report says, with the same first and last line and the same bundles.
|
|
36
|
+
* A report that counted nothing names no range and claims nothing to check
|
|
37
|
+
* beyond its zeros.
|
|
38
|
+
*/
|
|
39
|
+
export declare function verifyUsage(lines: Iterable<string>, claimed: ClaimedUsage, period: UsagePeriod): UsageCount;
|
|
40
|
+
//# sourceMappingURL=UsageCount.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"UsageCount.d.ts","sourceRoot":"","sources":["../../src/edge/UsageCount.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GACxB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,CAAC;AAErB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;CAC5C;AA4FD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,OAAO,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACzF,UAAU,CAcZ;AAED,6DAA6D;AAC7D,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,WAAW,GAClB,UAAU,CAeZ"}
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
import { CanonicalIntentHasher } from "@decionis/agent-safe-pipeline";
|
|
2
|
+
import { HashChain } from "../audit/HashChain.js";
|
|
3
|
+
import { emptyUsage, UsageTally } from "./UsageTally.js";
|
|
4
|
+
/**
|
|
5
|
+
* The lines of one stream, each checked against its own hash and indexed by
|
|
6
|
+
* it. A line whose hash does not match its fields is a finding and is left
|
|
7
|
+
* out, so no walk can pass through it. `last` is the last good line in the
|
|
8
|
+
* input: the head the chain reached when the log was collected.
|
|
9
|
+
*/
|
|
10
|
+
function index(lines, stream) {
|
|
11
|
+
const byHash = new Map();
|
|
12
|
+
const findings = [];
|
|
13
|
+
let last;
|
|
14
|
+
let position = 0;
|
|
15
|
+
for (const text of lines) {
|
|
16
|
+
position += 1;
|
|
17
|
+
let record;
|
|
18
|
+
try {
|
|
19
|
+
record = JSON.parse(text);
|
|
20
|
+
}
|
|
21
|
+
catch {
|
|
22
|
+
if (text.trim() !== "")
|
|
23
|
+
findings.push({ code: "CHAIN_LINE_INVALID", line: position });
|
|
24
|
+
continue;
|
|
25
|
+
}
|
|
26
|
+
if (record?.["stream"] !== stream)
|
|
27
|
+
continue;
|
|
28
|
+
const { seq, prev_hash, hash } = record;
|
|
29
|
+
if (!Number.isSafeInteger(seq) || typeof prev_hash !== "string") {
|
|
30
|
+
findings.push({ code: "CHAIN_LINE_INVALID", line: position });
|
|
31
|
+
continue;
|
|
32
|
+
}
|
|
33
|
+
if (HashChain.digest(record) !== hash) {
|
|
34
|
+
findings.push({ code: "CHAIN_HASH_MISMATCH", line: position });
|
|
35
|
+
continue;
|
|
36
|
+
}
|
|
37
|
+
last = { seq: seq, prev_hash, hash, record };
|
|
38
|
+
byHash.set(hash, last);
|
|
39
|
+
}
|
|
40
|
+
return { byHash, last, findings };
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* The chain ending at `head`, oldest first: each line's `prev_hash` is the
|
|
44
|
+
* line before it and its `seq` one more. The walk stops at the first line,
|
|
45
|
+
* at `stop`, or where the line before is missing. A branch a crash
|
|
46
|
+
* abandoned (lines written after the last persisted head, then written
|
|
47
|
+
* again under the same numbers) is not on this chain and is not walked.
|
|
48
|
+
*/
|
|
49
|
+
function walk(byHash, head, stop) {
|
|
50
|
+
const path = [head];
|
|
51
|
+
let current = head;
|
|
52
|
+
while (current.hash !== stop) {
|
|
53
|
+
const previous = byHash.get(current.prev_hash);
|
|
54
|
+
if (previous?.seq !== current.seq - 1)
|
|
55
|
+
break;
|
|
56
|
+
path.push(previous);
|
|
57
|
+
current = previous;
|
|
58
|
+
}
|
|
59
|
+
return path.reverse();
|
|
60
|
+
}
|
|
61
|
+
function tally(path, period) {
|
|
62
|
+
const usage = new UsageTally();
|
|
63
|
+
for (const line of path) {
|
|
64
|
+
const record = line.record;
|
|
65
|
+
if (record["event"] !== "EDGE_DECISION")
|
|
66
|
+
continue;
|
|
67
|
+
usage.add({
|
|
68
|
+
at: String(record["at"]),
|
|
69
|
+
mode: record["mode"],
|
|
70
|
+
verdict: record["verdict"],
|
|
71
|
+
delegated: record["delegated"],
|
|
72
|
+
jti: record["jti"],
|
|
73
|
+
seq: line.seq,
|
|
74
|
+
hash: line.hash,
|
|
75
|
+
}, period);
|
|
76
|
+
}
|
|
77
|
+
return usage.usage(period.period);
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* Counts a period's edge decisions from collected log lines: the chain of
|
|
81
|
+
* `stream` that ends at `head` (the last line in the input unless named) is
|
|
82
|
+
* walked back to its start, and the `EDGE_DECISION` lines on it whose `at`
|
|
83
|
+
* falls in the period are counted. A tampered line anywhere in the stream,
|
|
84
|
+
* or a chain that is cut off after the period began, is a finding, and a
|
|
85
|
+
* report is not made from it.
|
|
86
|
+
*/
|
|
87
|
+
export function countUsage(lines, options) {
|
|
88
|
+
const indexed = index(lines, options.stream);
|
|
89
|
+
const findings = indexed.findings;
|
|
90
|
+
const head = options.head === undefined ? indexed.last : indexed.byHash.get(options.head);
|
|
91
|
+
if (head === undefined) {
|
|
92
|
+
if (options.head !== undefined)
|
|
93
|
+
findings.push({ code: "CHAIN_HEAD_UNKNOWN" });
|
|
94
|
+
return { ok: findings.length === 0, usage: emptyUsage(), findings };
|
|
95
|
+
}
|
|
96
|
+
const path = walk(indexed.byHash, head);
|
|
97
|
+
const first = path[0];
|
|
98
|
+
if (first.seq !== 1 && Date.parse(String(first.record["at"])) >= options.period.start) {
|
|
99
|
+
findings.push({ code: "CHAIN_START_MISSING" });
|
|
100
|
+
}
|
|
101
|
+
return { ok: findings.length === 0, usage: tally(path, options.period), findings };
|
|
102
|
+
}
|
|
103
|
+
/**
|
|
104
|
+
* Recounts a report's period from collected log lines and checks it: the
|
|
105
|
+
* range must be one unbroken chain from `first_hash` back from `last_hash`,
|
|
106
|
+
* and the `EDGE_DECISION` lines on it in the period must count exactly what
|
|
107
|
+
* the report says, with the same first and last line and the same bundles.
|
|
108
|
+
* A report that counted nothing names no range and claims nothing to check
|
|
109
|
+
* beyond its zeros.
|
|
110
|
+
*/
|
|
111
|
+
export function verifyUsage(lines, claimed, period) {
|
|
112
|
+
let usage = emptyUsage();
|
|
113
|
+
if (claimed.last_hash !== null) {
|
|
114
|
+
const indexed = index(lines, claimed.stream);
|
|
115
|
+
const broken = { ok: false, usage, findings: [{ code: "CHAIN_RANGE_BROKEN" }] };
|
|
116
|
+
const head = indexed.byHash.get(claimed.last_hash);
|
|
117
|
+
if (head === undefined)
|
|
118
|
+
return broken;
|
|
119
|
+
const path = walk(indexed.byHash, head, claimed.first_hash ?? undefined);
|
|
120
|
+
if (path[0].hash !== claimed.first_hash)
|
|
121
|
+
return broken;
|
|
122
|
+
usage = tally(path, period);
|
|
123
|
+
}
|
|
124
|
+
const same = CanonicalIntentHasher.stringify(comparable(usage)) ===
|
|
125
|
+
CanonicalIntentHasher.stringify(comparable(claimed));
|
|
126
|
+
return { ok: same, usage, findings: same ? [] : [{ code: "USAGE_MISMATCH" }] };
|
|
127
|
+
}
|
|
128
|
+
/** The fields a recount must reproduce, as one value. */
|
|
129
|
+
function comparable(usage) {
|
|
130
|
+
return {
|
|
131
|
+
counts: usage.counts,
|
|
132
|
+
delegated: usage.delegated,
|
|
133
|
+
bundles: [...usage.bundles],
|
|
134
|
+
first_seq: usage.first_seq,
|
|
135
|
+
first_hash: usage.first_hash,
|
|
136
|
+
last_seq: usage.last_seq,
|
|
137
|
+
last_hash: usage.last_hash,
|
|
138
|
+
};
|
|
139
|
+
}
|
|
140
|
+
//# sourceMappingURL=UsageCount.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"UsageCount.js","sourceRoot":"","sources":["../../src/edge/UsageCount.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import type { FetchLike } from "../handlers/HandlerRegistration.js";
|
|
2
|
+
import type { UsageSigningKey } from "./UsageReport.js";
|
|
3
|
+
/** What registering an installation's usage-report key came to. */
|
|
4
|
+
export type UsageKeyRegistration = {
|
|
5
|
+
readonly result: "REGISTERED";
|
|
6
|
+
}
|
|
7
|
+
/** The kid is registered to another installation; nothing was changed. */
|
|
8
|
+
| {
|
|
9
|
+
readonly result: "KEY_ID_IN_USE";
|
|
10
|
+
readonly issuer: string;
|
|
11
|
+
} | {
|
|
12
|
+
readonly result: "FAILED";
|
|
13
|
+
readonly code: string;
|
|
14
|
+
};
|
|
15
|
+
/**
|
|
16
|
+
* Registers an installation's usage-report key with Decionis
|
|
17
|
+
* (`POST /v1/execution/provider-keys`, purpose `usage_report`, `issuer` the
|
|
18
|
+
* installation id). Decionis keeps one key per kid and a registration under a
|
|
19
|
+
* kid it already holds re-points that kid to the new issuer, which would make
|
|
20
|
+
* the first installation's reports fail `USAGE_REPORT_ISSUER_MISMATCH`. So a
|
|
21
|
+
* kid already registered, unrevoked, to another installation is refused here
|
|
22
|
+
* and left alone: replicas sharing one key file each need their own kid.
|
|
23
|
+
*
|
|
24
|
+
* The API key needs `policy:write`; it is an operator's, used for this call
|
|
25
|
+
* only, never the executor's runtime key.
|
|
26
|
+
*/
|
|
27
|
+
export declare function registerUsageKey(options: {
|
|
28
|
+
readonly baseUrl: string;
|
|
29
|
+
readonly apiKey: string;
|
|
30
|
+
readonly fetch: FetchLike;
|
|
31
|
+
readonly key: UsageSigningKey;
|
|
32
|
+
readonly installationId: string;
|
|
33
|
+
}): Promise<UsageKeyRegistration>;
|
|
34
|
+
//# sourceMappingURL=UsageKeyRegistration.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"UsageKeyRegistration.d.ts","sourceRoot":"","sources":["../../src/edge/UsageKeyRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,mEAAmE;AACnE,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE;AACnC,0EAA0E;GACxE;IAAE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAQzD;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA8BhC"}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import { withoutTrailingSlash } from "./Entitlement.js";
|
|
2
|
+
/**
|
|
3
|
+
* Registers an installation's usage-report key with Decionis
|
|
4
|
+
* (`POST /v1/execution/provider-keys`, purpose `usage_report`, `issuer` the
|
|
5
|
+
* installation id). Decionis keeps one key per kid and a registration under a
|
|
6
|
+
* kid it already holds re-points that kid to the new issuer, which would make
|
|
7
|
+
* the first installation's reports fail `USAGE_REPORT_ISSUER_MISMATCH`. So a
|
|
8
|
+
* kid already registered, unrevoked, to another installation is refused here
|
|
9
|
+
* and left alone: replicas sharing one key file each need their own kid.
|
|
10
|
+
*
|
|
11
|
+
* The API key needs `policy:write`; it is an operator's, used for this call
|
|
12
|
+
* only, never the executor's runtime key.
|
|
13
|
+
*/
|
|
14
|
+
export async function registerUsageKey(options) {
|
|
15
|
+
const url = `${withoutTrailingSlash(options.baseUrl)}/v1/execution/provider-keys`;
|
|
16
|
+
const headers = {
|
|
17
|
+
authorization: `Bearer ${options.apiKey}`,
|
|
18
|
+
accept: "application/json",
|
|
19
|
+
};
|
|
20
|
+
const listed = await call(options.fetch, url, { method: "GET", headers });
|
|
21
|
+
if (!listed.ok)
|
|
22
|
+
return { result: "FAILED", code: listed.code };
|
|
23
|
+
const keys = listed.body.keys;
|
|
24
|
+
const holder = Array.isArray(keys)
|
|
25
|
+
? keys.find(
|
|
26
|
+
// Revoked means a revocation time; anything else holds the kid.
|
|
27
|
+
(entry) => entry.kid === options.key.kid && typeof entry.revoked_at !== "string")
|
|
28
|
+
: undefined;
|
|
29
|
+
if (typeof holder?.issuer === "string" && holder.issuer !== options.installationId) {
|
|
30
|
+
return { result: "KEY_ID_IN_USE", issuer: holder.issuer };
|
|
31
|
+
}
|
|
32
|
+
const registered = await call(options.fetch, url, {
|
|
33
|
+
method: "POST",
|
|
34
|
+
headers: { ...headers, "content-type": "application/json" },
|
|
35
|
+
body: JSON.stringify({
|
|
36
|
+
kid: options.key.kid,
|
|
37
|
+
issuer: options.installationId,
|
|
38
|
+
algorithm: "EdDSA",
|
|
39
|
+
public_jwk: options.key.publicJwk,
|
|
40
|
+
purpose: "usage_report",
|
|
41
|
+
}),
|
|
42
|
+
});
|
|
43
|
+
return registered.ok ? { result: "REGISTERED" } : { result: "FAILED", code: registered.code };
|
|
44
|
+
}
|
|
45
|
+
async function call(fetch, url, init) {
|
|
46
|
+
const controller = new AbortController();
|
|
47
|
+
const timeout = setTimeout(() => controller.abort(), 10_000);
|
|
48
|
+
try {
|
|
49
|
+
const response = await fetch(url, { ...init, signal: controller.signal });
|
|
50
|
+
let body = null;
|
|
51
|
+
try {
|
|
52
|
+
body = await response.json();
|
|
53
|
+
}
|
|
54
|
+
catch {
|
|
55
|
+
// A body that is not JSON carries no code.
|
|
56
|
+
}
|
|
57
|
+
if (response.ok)
|
|
58
|
+
return { ok: true, body };
|
|
59
|
+
const error = body?.error;
|
|
60
|
+
return {
|
|
61
|
+
ok: false,
|
|
62
|
+
code: typeof error === "string" && /^[A-Z_]{1,60}$/.test(error)
|
|
63
|
+
? error
|
|
64
|
+
: `USAGE_KEY_HTTP_${response.status}`,
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
catch {
|
|
68
|
+
return { ok: false, code: "USAGE_KEY_SEND_FAILED" };
|
|
69
|
+
}
|
|
70
|
+
finally {
|
|
71
|
+
clearTimeout(timeout);
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
//# sourceMappingURL=UsageKeyRegistration.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"UsageKeyRegistration.js","sourceRoot":"","sources":["../../src/edge/UsageKeyRegistration.ts"],"names":[],"mappings":"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"}
|