@decionis/agentsafe 0.2.1 → 0.2.3

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.
Files changed (77) hide show
  1. package/dist/cli/Credentials.d.ts.map +1 -1
  2. package/dist/cli/Credentials.js +8 -1
  3. package/dist/cli/Credentials.js.map +1 -1
  4. package/dist/cli/Help.d.ts.map +1 -1
  5. package/dist/cli/Help.js +3 -2
  6. package/dist/cli/Help.js.map +1 -1
  7. package/dist/cli/Intercept.d.ts +46 -10
  8. package/dist/cli/Intercept.d.ts.map +1 -1
  9. package/dist/cli/Intercept.js +255 -27
  10. package/dist/cli/Intercept.js.map +1 -1
  11. package/dist/cli/Login.d.ts +7 -2
  12. package/dist/cli/Login.d.ts.map +1 -1
  13. package/dist/cli/Login.js +106 -3
  14. package/dist/cli/Login.js.map +1 -1
  15. package/dist/cli/Status.d.ts.map +1 -1
  16. package/dist/cli/Status.js +9 -4
  17. package/dist/cli/Status.js.map +1 -1
  18. package/dist/cli/TestCommand.d.ts +24 -2
  19. package/dist/cli/TestCommand.d.ts.map +1 -1
  20. package/dist/cli/TestCommand.js +122 -1
  21. package/dist/cli/TestCommand.js.map +1 -1
  22. package/dist/egress/TransparentDial.d.ts +4 -3
  23. package/dist/egress/TransparentDial.d.ts.map +1 -1
  24. package/dist/egress/TransparentDial.js +4 -3
  25. package/dist/egress/TransparentDial.js.map +1 -1
  26. package/dist/gateway/BoundaryTest.d.ts +54 -0
  27. package/dist/gateway/BoundaryTest.d.ts.map +1 -1
  28. package/dist/gateway/BoundaryTest.js +19 -7
  29. package/dist/gateway/BoundaryTest.js.map +1 -1
  30. package/dist/gateway/Gateway.d.ts +23 -0
  31. package/dist/gateway/Gateway.d.ts.map +1 -1
  32. package/dist/gateway/Gateway.js +39 -10
  33. package/dist/gateway/Gateway.js.map +1 -1
  34. package/dist/gateway/HostedBoundaryTest.d.ts +118 -0
  35. package/dist/gateway/HostedBoundaryTest.d.ts.map +1 -0
  36. package/dist/gateway/HostedBoundaryTest.js +235 -0
  37. package/dist/gateway/HostedBoundaryTest.js.map +1 -0
  38. package/dist/gateway/ShadowLedger.d.ts +21 -2
  39. package/dist/gateway/ShadowLedger.d.ts.map +1 -1
  40. package/dist/gateway/ShadowLedger.js +42 -12
  41. package/dist/gateway/ShadowLedger.js.map +1 -1
  42. package/dist/http/GatewayHttpServer.d.ts +7 -0
  43. package/dist/http/GatewayHttpServer.d.ts.map +1 -1
  44. package/dist/http/GatewayHttpServer.js +8 -0
  45. package/dist/http/GatewayHttpServer.js.map +1 -1
  46. package/dist/http/InterceptGovernor.d.ts +71 -0
  47. package/dist/http/InterceptGovernor.d.ts.map +1 -0
  48. package/dist/http/InterceptGovernor.js +128 -0
  49. package/dist/http/InterceptGovernor.js.map +1 -0
  50. package/dist/http/InterceptServer.d.ts +31 -1
  51. package/dist/http/InterceptServer.d.ts.map +1 -1
  52. package/dist/http/InterceptServer.js +58 -7
  53. package/dist/http/InterceptServer.js.map +1 -1
  54. package/dist/intercept/ClientHello.d.ts.map +1 -1
  55. package/dist/intercept/ClientHello.js +76 -72
  56. package/dist/intercept/ClientHello.js.map +1 -1
  57. package/dist/intercept/Der.d.ts +59 -0
  58. package/dist/intercept/Der.d.ts.map +1 -0
  59. package/dist/intercept/Der.js +140 -0
  60. package/dist/intercept/Der.js.map +1 -0
  61. package/dist/intercept/Destination.d.ts +1 -1
  62. package/dist/intercept/Destination.d.ts.map +1 -1
  63. package/dist/intercept/Destination.js +28 -24
  64. package/dist/intercept/Destination.js.map +1 -1
  65. package/dist/intercept/InterceptLedger.d.ts +43 -7
  66. package/dist/intercept/InterceptLedger.d.ts.map +1 -1
  67. package/dist/intercept/InterceptLedger.js +39 -18
  68. package/dist/intercept/InterceptLedger.js.map +1 -1
  69. package/dist/intercept/LeafIssuer.d.ts +40 -0
  70. package/dist/intercept/LeafIssuer.d.ts.map +1 -0
  71. package/dist/intercept/LeafIssuer.js +124 -0
  72. package/dist/intercept/LeafIssuer.js.map +1 -0
  73. package/dist/intercept/RequestHead.d.ts +1 -1
  74. package/dist/intercept/RequestHead.d.ts.map +1 -1
  75. package/dist/intercept/RequestHead.js +78 -66
  76. package/dist/intercept/RequestHead.js.map +1 -1
  77. package/package.json +2 -2
@@ -16,15 +16,43 @@ export type InterceptRefusal = DestinationRefusal
16
16
  /** The destination is this interceptor's own listener: a loop, refused. */
17
17
  | "HOST_IS_INTERCEPTOR"
18
18
  /** The interceptor holds as many connections as it will. */
19
- | "TOO_MANY_CONNECTIONS";
20
- export interface DestinationCounts {
19
+ | "TOO_MANY_CONNECTIONS"
20
+ /** The operator governs a list of destinations and refuses the rest; this was the rest. */
21
+ | "UNLISTED_DESTINATION"
22
+ /** A governed connection could not be taken: no authority to mint with, a failed handshake, no gateway. */
23
+ | "GOVERN_UNAVAILABLE";
24
+ /** A destination whose connections were spliced through: what the hop itself measured. */
25
+ export interface SplicedCounts {
21
26
  readonly protocol: InterceptProtocol;
27
+ readonly governed: false;
22
28
  readonly connections: number;
23
29
  readonly bytes_to_destination: number;
24
30
  readonly bytes_from_destination: number;
25
31
  /** HTTP methods seen in the clear; empty for TLS, whose requests are not read. */
26
32
  readonly methods: Readonly<Record<string, number>>;
27
33
  }
34
+ /** What the gateway for a governed destination did with the requests it was handed. */
35
+ export interface GovernedGatewayCounts {
36
+ readonly mode: "SHADOW" | "ENFORCEMENT";
37
+ /** The gateway's own counts by name: `governed`, `interceptions`, `allows`, `blocks`, `escalations`, `shadow`, `passthrough`, ... */
38
+ readonly requests: Readonly<Record<string, number>>;
39
+ }
40
+ /**
41
+ * A destination whose connections the gateway took: the hop counted the
42
+ * connections and read the first request's method where it was in the clear,
43
+ * and the requests themselves are the gateway's account, not a byte count.
44
+ */
45
+ export interface GovernedCounts {
46
+ readonly protocol: InterceptProtocol;
47
+ readonly governed: true;
48
+ readonly connections: number;
49
+ readonly methods: Readonly<Record<string, number>>;
50
+ /** Null until the report is written, or when no request reached the gateway. */
51
+ readonly gateway: GovernedGatewayCounts | null;
52
+ }
53
+ export type DestinationCounts = SplicedCounts | GovernedCounts;
54
+ /** The gateway counts for a governed destination at report time, or null when none was created. */
55
+ export type GovernedCountsSource = (host: string, protocol: InterceptProtocol) => GovernedGatewayCounts | null;
28
56
  export interface InterceptSummary {
29
57
  readonly since: string | null;
30
58
  readonly until: string | null;
@@ -44,13 +72,14 @@ export interface InterceptReport {
44
72
  export declare class InterceptLedger {
45
73
  private since;
46
74
  private until;
47
- private connections;
75
+ private count;
48
76
  private spliced;
49
77
  private readonly refusals;
50
78
  private readonly destinations;
51
79
  /** A connection whose destination was read; returns the key `bytes` takes. */
52
- record(host: string, port: number, protocol: InterceptProtocol, method: string | null, at: string): string;
53
- /** Bytes that crossed for a placed connection, by the key `record` returned. */
80
+ record(host: string, port: number, protocol: InterceptProtocol, method: string | null, at: string, governed?: boolean): string;
81
+ private fresh;
82
+ /** Bytes that crossed for a spliced connection, by the key `record` returned; a governed destination has none to count. */
54
83
  bytes(key: string, toDestination: number, fromDestination: number): void;
55
84
  /** A recorded connection whose destination answered: the splice is up. */
56
85
  placed(): void;
@@ -60,8 +89,15 @@ export declare class InterceptLedger {
60
89
  * here; one refused after `record` has.
61
90
  */
62
91
  refuse(reason: InterceptRefusal, at: string, countConnection: boolean): void;
63
- summary(): InterceptSummary;
64
- report(at: string): InterceptReport;
92
+ /**
93
+ * The summary so far. A governed destination's `gateway` is filled from
94
+ * `governed`, the gateway's account of the requests it was handed, when one
95
+ * is given; the key is `host:port`, and the port names the protocol.
96
+ */
97
+ summary(governed?: GovernedCountsSource): InterceptSummary;
98
+ report(at: string, governed?: GovernedCountsSource): InterceptReport;
99
+ /** How many connections have been counted so far, placed or refused. */
100
+ get connections(): number;
65
101
  private touch;
66
102
  }
67
103
  //# sourceMappingURL=InterceptLedger.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"InterceptLedger.d.ts","sourceRoot":"","sources":["../../src/intercept/InterceptLedger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GACxB,kBAAkB;AACpB,+DAA+D;GAC7D,cAAc;AAChB,sDAAsD;GACpD,sBAAsB;AACxB,2EAA2E;GACzE,qBAAqB;AACvB,4DAA4D;GAC1D,sBAAsB,CAAC;AAE3B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,kFAAkF;IAClF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAMD,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwC;IAErE,8EAA8E;IACvE,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,EAAE,EAAE,MAAM,GACT,MAAM;IAoBT,gFAAgF;IACzE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IAU/E,0EAA0E;IACnE,MAAM,IAAI,IAAI;IAIrB;;;;OAIG;IACI,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,GAAG,IAAI;IAM5E,OAAO,IAAI,gBAAgB;IAW3B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe;IAS1C,OAAO,CAAC,KAAK;CAKd"}
1
+ {"version":3,"file":"InterceptLedger.d.ts","sourceRoot":"","sources":["../../src/intercept/InterceptLedger.ts"],"names":[],"mappings":"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"}
@@ -4,32 +4,38 @@ const OTHER = "other";
4
4
  export class InterceptLedger {
5
5
  since = null;
6
6
  until = null;
7
- connections = 0;
7
+ count = 0;
8
8
  spliced = 0;
9
9
  refusals = new Map();
10
10
  destinations = new Map();
11
11
  /** A connection whose destination was read; returns the key `bytes` takes. */
12
- record(host, port, protocol, method, at) {
12
+ record(host, port, protocol, method, at, governed = false) {
13
13
  this.touch(at);
14
14
  const wanted = `${host}:${port}`;
15
15
  const key = this.destinations.has(wanted) || this.destinations.size < MAX_DESTINATIONS ? wanted : OTHER;
16
- const counts = this.destinations.get(key) ?? {
17
- protocol,
18
- connections: 0,
19
- bytes_to_destination: 0,
20
- bytes_from_destination: 0,
21
- methods: {},
22
- };
16
+ const counts = this.destinations.get(key) ?? this.fresh(protocol, governed);
23
17
  const methods = method === null
24
18
  ? counts.methods
25
19
  : { ...counts.methods, [method]: (counts.methods[method] ?? 0) + 1 };
26
20
  this.destinations.set(key, { ...counts, connections: counts.connections + 1, methods });
27
21
  return key;
28
22
  }
29
- /** Bytes that crossed for a placed connection, by the key `record` returned. */
23
+ fresh(protocol, governed) {
24
+ return governed
25
+ ? { protocol, governed: true, connections: 0, methods: {}, gateway: null }
26
+ : {
27
+ protocol,
28
+ governed: false,
29
+ connections: 0,
30
+ bytes_to_destination: 0,
31
+ bytes_from_destination: 0,
32
+ methods: {},
33
+ };
34
+ }
35
+ /** Bytes that crossed for a spliced connection, by the key `record` returned; a governed destination has none to count. */
30
36
  bytes(key, toDestination, fromDestination) {
31
37
  const counts = this.destinations.get(key);
32
- if (counts === undefined)
38
+ if (counts === undefined || counts.governed)
33
39
  return;
34
40
  this.destinations.set(key, {
35
41
  ...counts,
@@ -53,28 +59,43 @@ export class InterceptLedger {
53
59
  this.until = at;
54
60
  this.refusals.set(reason, (this.refusals.get(reason) ?? 0) + 1);
55
61
  }
56
- summary() {
62
+ /**
63
+ * The summary so far. A governed destination's `gateway` is filled from
64
+ * `governed`, the gateway's account of the requests it was handed, when one
65
+ * is given; the key is `host:port`, and the port names the protocol.
66
+ */
67
+ summary(governed = () => null) {
68
+ const destinations = [...this.destinations.entries()].sort().map(([key, counts]) => {
69
+ if (!counts.governed)
70
+ return [key, counts];
71
+ const host = key.slice(0, key.lastIndexOf(":"));
72
+ return [key, { ...counts, gateway: governed(host, counts.protocol) }];
73
+ });
57
74
  return {
58
75
  since: this.since,
59
76
  until: this.until,
60
- connections: this.connections,
77
+ connections: this.count,
61
78
  placed: this.spliced,
62
79
  refused: Object.fromEntries([...this.refusals.entries()].sort()),
63
- destinations: Object.fromEntries([...this.destinations.entries()].sort()),
80
+ destinations: Object.fromEntries(destinations),
64
81
  };
65
82
  }
66
- report(at) {
83
+ report(at, governed) {
67
84
  return {
68
85
  event: "INTERCEPT_REPORT",
69
86
  at,
70
- intercept: this.summary(),
71
- next: "Every destination listed is somewhere this workload acts. agentsafe proxy --upstream https://<host> governs one today; governing them transparently, in this same hop, is the interceptor's next phase.",
87
+ intercept: this.summary(governed),
88
+ next: "Every destination listed is somewhere this workload acts. Name the ones to govern in AGENTSAFE_INTERCEPT_GOVERN, with the authority the workload trusts, and this same hop asks Decionis before each consequential request reaches them.",
72
89
  };
73
90
  }
91
+ /** How many connections have been counted so far, placed or refused. */
92
+ get connections() {
93
+ return this.count;
94
+ }
74
95
  touch(at) {
75
96
  this.since ??= at;
76
97
  this.until = at;
77
- this.connections += 1;
98
+ this.count += 1;
78
99
  }
79
100
  }
80
101
  //# sourceMappingURL=InterceptLedger.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"InterceptLedger.js","sourceRoot":"","sources":["../../src/intercept/InterceptLedger.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"InterceptLedger.js","sourceRoot":"","sources":["../../src/intercept/InterceptLedger.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ export declare class LeafIssuerError extends Error {
2
+ readonly code: "CA_CERTIFICATE_INVALID" | "CA_KEY_INVALID" | "CA_KEY_MISMATCH" | "CA_NOT_AN_AUTHORITY";
3
+ constructor(code: "CA_CERTIFICATE_INVALID" | "CA_KEY_INVALID" | "CA_KEY_MISMATCH" | "CA_NOT_AN_AUTHORITY");
4
+ }
5
+ export interface OperatorAuthority {
6
+ /** The authority's certificate, PEM. Sent to clients as the chain, so an intermediate works too. */
7
+ readonly certificatePem: string;
8
+ /** The authority's private key, PEM (PKCS#8 or traditional), EC or RSA. */
9
+ readonly keyPem: string;
10
+ }
11
+ /** A minted leaf: what a TLS server presents for one host, and until when. */
12
+ export interface Leaf {
13
+ /** The leaf certificate alone, PEM. */
14
+ readonly certificatePem: string;
15
+ /** The leaf followed by the authority's certificate: the chain a client is sent. */
16
+ readonly chainPem: string;
17
+ /** The leaf's private key, PKCS#8 PEM, this process's alone. */
18
+ readonly keyPem: string;
19
+ readonly notAfter: number;
20
+ }
21
+ /**
22
+ * Mints and caches one leaf certificate per server name, signed by the
23
+ * operator's authority. The TLS context that presents a leaf is the
24
+ * listener's to build, under `src/http`, where sockets are opened.
25
+ */
26
+ export declare class LeafIssuer {
27
+ private readonly clock;
28
+ private readonly signer;
29
+ private readonly signatureAlgorithm;
30
+ private readonly issuerName;
31
+ private readonly authorityPem;
32
+ private readonly leafKeyPem;
33
+ private readonly leafPublicKeyDer;
34
+ private readonly leaves;
35
+ constructor(authority: OperatorAuthority, clock?: () => number);
36
+ /** The leaf for `host`: minted now, or kept from before while it has more than two hours left. */
37
+ leafFor(host: string): Leaf;
38
+ private certificate;
39
+ }
40
+ //# sourceMappingURL=LeafIssuer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LeafIssuer.d.ts","sourceRoot":"","sources":["../../src/intercept/LeafIssuer.ts"],"names":[],"mappings":"AA0CA,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,IAAI,EAClB,wBAAwB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,qBAAqB;gBADzE,IAAI,EAClB,wBAAwB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,qBAAqB;CAK5F;AAmBD,MAAM,WAAW,iBAAiB;IAChC,oGAAoG;IACpG,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,8EAA8E;AAC9E,MAAM,WAAW,IAAI;IACnB,uCAAuC;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,qBAAa,UAAU;IAWnB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAVxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;gBAGhD,SAAS,EAAE,iBAAiB,EACX,KAAK,GAAE,MAAM,MAAyB;IAgCzD,kGAAkG;IAC3F,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAoBlC,OAAO,CAAC,WAAW;CAwBpB"}
@@ -0,0 +1,124 @@
1
+ /**
2
+ * The certificates the governing interceptor presents to a workload: one leaf
3
+ * per server name, minted from the operator's own certificate authority, so
4
+ * that a workload whose runtime trusts that authority completes its TLS
5
+ * handshake with the interceptor and never learns the difference. This is the
6
+ * price of governing HTTPS transparently, stated in ADR 0005, and this module
7
+ * is where it is paid: the authority's private key is read from a file the
8
+ * operator mounts, the leaf's key is generated once per process and never
9
+ * written anywhere, and each leaf names exactly one host, for a day.
10
+ *
11
+ * The shape is one X.509 v3 certificate with the extensions a TLS client
12
+ * reads (basic constraints, key usage, extended key usage for server
13
+ * authentication, one subject alternative name), written with the DER
14
+ * functions in `Der.ts` and signed with the authority's key: ECDSA with
15
+ * SHA-256 for an EC key, sha256WithRSAEncryption for an RSA key. The leaf's
16
+ * issuer is the authority certificate's subject, taken byte for byte from the
17
+ * certificate, so a verifier that compares names as bytes chains them.
18
+ */
19
+ import { createPrivateKey, generateKeyPairSync, randomBytes, sign, X509Certificate, } from "node:crypto";
20
+ import { asn1Null, bitString, explicit, extension, implicit, integer, oid, pem, sequence, set, subjectNameOf, utcTime, utf8String, } from "./Der.js";
21
+ export class LeafIssuerError extends Error {
22
+ code;
23
+ constructor(code) {
24
+ super(code);
25
+ this.code = code;
26
+ this.name = "LeafIssuerError";
27
+ }
28
+ }
29
+ const ECDSA_WITH_SHA256 = "1.2.840.10045.4.3.2";
30
+ const SHA256_WITH_RSA = "1.2.840.113549.1.1.11";
31
+ const COMMON_NAME = "2.5.4.3";
32
+ const BASIC_CONSTRAINTS = "2.5.29.19";
33
+ const KEY_USAGE = "2.5.29.15";
34
+ const SUBJECT_ALT_NAME = "2.5.29.17";
35
+ const EXTENDED_KEY_USAGE = "2.5.29.37";
36
+ const SERVER_AUTH = "1.3.6.1.5.5.7.3.1";
37
+ const HOUR_MS = 60 * 60 * 1_000;
38
+ /** A leaf is valid for a day, backdated an hour for clocks that disagree. */
39
+ const LEAF_LIFETIME_MS = 24 * HOUR_MS;
40
+ const LEAF_BACKDATE_MS = HOUR_MS;
41
+ /** A cached leaf is reissued when no more than this remains, so no client sees one expire. */
42
+ const REISSUE_MARGIN_MS = 2 * HOUR_MS;
43
+ /** The most leaves kept at once; a governed set is a handful of hosts, and this is the ceiling. */
44
+ const MAX_CACHED_LEAVES = 1_000;
45
+ /**
46
+ * Mints and caches one leaf certificate per server name, signed by the
47
+ * operator's authority. The TLS context that presents a leaf is the
48
+ * listener's to build, under `src/http`, where sockets are opened.
49
+ */
50
+ export class LeafIssuer {
51
+ clock;
52
+ signer;
53
+ signatureAlgorithm;
54
+ issuerName;
55
+ authorityPem;
56
+ leafKeyPem;
57
+ leafPublicKeyDer;
58
+ leaves = new Map();
59
+ constructor(authority, clock = () => Date.now()) {
60
+ this.clock = clock;
61
+ let certificate;
62
+ try {
63
+ certificate = new X509Certificate(authority.certificatePem);
64
+ }
65
+ catch {
66
+ throw new LeafIssuerError("CA_CERTIFICATE_INVALID");
67
+ }
68
+ if (!certificate.ca)
69
+ throw new LeafIssuerError("CA_NOT_AN_AUTHORITY");
70
+ try {
71
+ this.signer = createPrivateKey(authority.keyPem);
72
+ }
73
+ catch {
74
+ throw new LeafIssuerError("CA_KEY_INVALID");
75
+ }
76
+ if (!certificate.checkPrivateKey(this.signer))
77
+ throw new LeafIssuerError("CA_KEY_MISMATCH");
78
+ switch (this.signer.asymmetricKeyType) {
79
+ case "ec":
80
+ this.signatureAlgorithm = sequence(oid(ECDSA_WITH_SHA256));
81
+ break;
82
+ case "rsa":
83
+ this.signatureAlgorithm = sequence(oid(SHA256_WITH_RSA), asn1Null);
84
+ break;
85
+ default:
86
+ throw new LeafIssuerError("CA_KEY_INVALID");
87
+ }
88
+ this.issuerName = subjectNameOf(certificate.raw);
89
+ this.authorityPem = certificate.toString();
90
+ const keys = generateKeyPairSync("ec", { namedCurve: "P-256" });
91
+ this.leafKeyPem = keys.privateKey.export({ type: "pkcs8", format: "pem" });
92
+ this.leafPublicKeyDer = keys.publicKey.export({ type: "spki", format: "der" });
93
+ }
94
+ /** The leaf for `host`: minted now, or kept from before while it has more than two hours left. */
95
+ leafFor(host) {
96
+ const now = this.clock();
97
+ const cached = this.leaves.get(host);
98
+ if (cached !== undefined && cached.notAfter - now > REISSUE_MARGIN_MS)
99
+ return cached;
100
+ if (this.leaves.size >= MAX_CACHED_LEAVES && cached === undefined)
101
+ this.leaves.clear();
102
+ const notAfter = now + LEAF_LIFETIME_MS;
103
+ const certificatePem = pem("CERTIFICATE", this.certificate(host, now - LEAF_BACKDATE_MS, notAfter));
104
+ const leaf = {
105
+ certificatePem,
106
+ chainPem: `${certificatePem}${this.authorityPem}`,
107
+ keyPem: this.leafKeyPem,
108
+ notAfter,
109
+ };
110
+ this.leaves.set(host, leaf);
111
+ return leaf;
112
+ }
113
+ certificate(host, notBefore, notAfter) {
114
+ // A positive serial in minimal form: the first byte is never zero and never has its top bit set.
115
+ const serial = randomBytes(16);
116
+ serial.writeUInt8((serial.readUInt8(0) & 0x7f) | 0x01, 0);
117
+ const subject = sequence(set(sequence(oid(COMMON_NAME), utf8String(host))));
118
+ const extensions = sequence(extension(BASIC_CONSTRAINTS, true, sequence()), extension(KEY_USAGE, true, bitString(Buffer.from([0x80]), 7)), extension(EXTENDED_KEY_USAGE, false, sequence(oid(SERVER_AUTH))), extension(SUBJECT_ALT_NAME, false, sequence(implicit(2, Buffer.from(host)))));
119
+ const tbs = sequence(explicit(0, integer(Buffer.from([2]))), integer(serial), this.signatureAlgorithm, this.issuerName, sequence(utcTime(new Date(notBefore)), utcTime(new Date(notAfter))), subject, this.leafPublicKeyDer, explicit(3, extensions));
120
+ const signature = sign("sha256", tbs, this.signer);
121
+ return sequence(tbs, this.signatureAlgorithm, bitString(signature));
122
+ }
123
+ }
124
+ //# sourceMappingURL=LeafIssuer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"LeafIssuer.js","sourceRoot":"","sources":["../../src/intercept/LeafIssuer.ts"],"names":[],"mappings":"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"}
@@ -42,7 +42,7 @@ interface Authority {
42
42
  readonly host: string;
43
43
  readonly port: number | null;
44
44
  }
45
- /** `host[:port]`, with the host a name, an IPv4 address or a bracketed IPv6 address. */
45
+ /** `host[:port]`, with the host a name, an IPv4 address or a bracketed IPv6 address, lowercased. */
46
46
  export declare function parseAuthority(value: string): Authority | null;
47
47
  export {};
48
48
  //# sourceMappingURL=RequestHead.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"RequestHead.d.ts","sourceRoot":"","sources":["../../src/intercept/RequestHead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,uDAAuD;AACvD,MAAM,MAAM,kBAAkB;AAC5B,sEAAsE;AACpE;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE;AAChC,2CAA2C;GACzC;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE;AAC/B,2EAA2E;GACzE;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GACnE;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEN,MAAM,MAAM,kBAAkB,GAC1B,sBAAsB,GACtB,cAAc,GACd,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,4BAA4B,GAC5B,gBAAgB,GAChB,eAAe,CAAC;AAEpB,iFAAiF;AACjF,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAW7C,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,kBAAkB,CAwDrE;AAED,UAAU,SAAS;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAsB9D"}
1
+ {"version":3,"file":"RequestHead.d.ts","sourceRoot":"","sources":["../../src/intercept/RequestHead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,uDAAuD;AACvD,MAAM,MAAM,kBAAkB;AAC5B,sEAAsE;AACpE;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE;AAChC,2CAA2C;GACzC;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE;AAC/B,2EAA2E;GACzE;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GACnE;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEN,MAAM,MAAM,kBAAkB,GAC1B,sBAAsB,GACtB,cAAc,GACd,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,4BAA4B,GAC5B,gBAAgB,GAChB,eAAe,CAAC;AAEpB,iFAAiF;AACjF,eAAO,MAAM,sBAAsB,QAAS,CAAC;AA8B7C,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,kBAAkB,CAsDrE;AAED,UAAU,SAAS;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,oGAAoG;AACpG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAY9D"}
@@ -13,134 +13,146 @@
13
13
  /** The most head bytes read before a request is refused as too long to place. */
14
14
  export const MAX_REQUEST_HEAD_BYTES = 16_384;
15
15
  const HEAD_END = "\r\n\r\n";
16
+ const LINE_END = "\r\n";
16
17
  const TOKEN = /^[!#$%&'*+\-.^`|~\w]+$/;
18
+ /** Method, target and version: the target is origin-form or absolute-form, checked after. */
17
19
  const REQUEST_LINE = /^([!#$%&'*+\-.^`|~\w]+) (\S+) HTTP\/1\.[01]$/;
20
+ /** Absolute-form target: the scheme this interceptor speaks, an authority, and a path that may be absent. */
21
+ const ABSOLUTE_TARGET = /^http:\/\/([^/?#]+)(\/\S*)?$/i;
22
+ /** A method token followed by a space, or by the end of what has arrived so far. */
23
+ const REQUEST_LINE_START = /^[A-Z][!#$%&'*+\-.^`|~\w]{0,19}(?: |$)/;
24
+ /** RFC 1123 host name: labels of letters, digits and hyphens, at most 253 characters. */
18
25
  const HOST_NAME = /^(?=.{1,253}$)[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)*$/;
19
- const IPV4 = /^(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|[1-9]?\d)){3}$/;
20
- const IPV6_LITERAL = /^\[[0-9a-f:.]+\]$/;
21
- const METHODS_WITHOUT_ORIGIN_FORM = new Set(["CONNECT"]);
26
+ /** A bracketed IPv6 literal, then an optional port. */
27
+ const IPV6_AUTHORITY = /^(\[[0-9a-f:.]+\])(?::(\d{1,5}))?$/;
28
+ /** A name or IPv4 address, then an optional port. */
29
+ const NAMED_AUTHORITY = /^([a-z0-9.-]+)(?::(\d{1,5}))?$/;
30
+ /** One decimal octet, no leading zero. */
31
+ const OCTET = /^(?:0|[1-9]\d{0,2})$/;
32
+ /** What can only be meant as an address. */
33
+ const DIGITS_AND_DOTS = /^[\d.]+$/;
34
+ const NEED_MORE = { kind: "NEED_MORE" };
35
+ const NOT_HTTP = { kind: "NOT_HTTP" };
36
+ const malformed = (reason) => ({
37
+ kind: "MALFORMED",
38
+ reason,
39
+ });
22
40
  /** Reads a client's first bytes as an HTTP/1 request head, or says why they are not one. */
23
41
  export function readRequestHead(bytes) {
24
- const text = latin1(bytes.subarray(0, Math.min(bytes.length, MAX_REQUEST_HEAD_BYTES + HEAD_END.length)));
42
+ // Only as much as a head may be, plus the terminator that would end it.
43
+ const window = Math.min(bytes.length, MAX_REQUEST_HEAD_BYTES + HEAD_END.length);
44
+ const text = latin1(bytes.subarray(0, window));
25
45
  const end = text.indexOf(HEAD_END);
26
46
  if (end === -1) {
27
- if (!looksLikeRequestLine(text))
28
- return { kind: "NOT_HTTP" };
29
- return bytes.length > MAX_REQUEST_HEAD_BYTES
30
- ? { kind: "MALFORMED", reason: "HEAD_TOO_LONG" }
31
- : { kind: "NEED_MORE" };
47
+ if (!REQUEST_LINE_START.test(text))
48
+ return NOT_HTTP;
49
+ return bytes.length > MAX_REQUEST_HEAD_BYTES ? malformed("HEAD_TOO_LONG") : NEED_MORE;
32
50
  }
33
- const lines = text.slice(0, end).split("\r\n");
34
- const requestLine = lines.shift() ?? "";
51
+ const head = text.slice(0, end);
52
+ const firstLineEnd = head.indexOf(LINE_END);
53
+ const requestLine = firstLineEnd === -1 ? head : head.slice(0, firstLineEnd);
54
+ const headerLines = firstLineEnd === -1 ? [] : head.slice(firstLineEnd + LINE_END.length).split(LINE_END);
35
55
  const match = REQUEST_LINE.exec(requestLine);
36
56
  if (match === null) {
37
- return looksLikeRequestLine(text)
38
- ? { kind: "MALFORMED", reason: "REQUEST_LINE_INVALID" }
39
- : { kind: "NOT_HTTP" };
57
+ return REQUEST_LINE_START.test(text) ? malformed("REQUEST_LINE_INVALID") : NOT_HTTP;
40
58
  }
41
- const method = match[1] ?? "";
42
- const rawTarget = match[2] ?? "";
43
- if (METHODS_WITHOUT_ORIGIN_FORM.has(method))
44
- return { kind: "MALFORMED", reason: "TARGET_INVALID" };
59
+ // Stryker disable next-line all: both groups are matched whenever the line is; the fallbacks satisfy the type.
60
+ const [method, rawTarget] = [match[1] ?? "", match[2] ?? ""];
45
61
  let hostHeader = null;
46
- for (const line of lines) {
62
+ for (const line of headerLines) {
47
63
  const header = readHeaderLine(line);
48
64
  if (header === null)
49
- return { kind: "MALFORMED", reason: "HEADER_INVALID" };
65
+ return malformed("HEADER_INVALID");
50
66
  if (header.name !== "host")
51
67
  continue;
52
68
  if (hostHeader !== null)
53
- return { kind: "MALFORMED", reason: "HOST_REPEATED" };
69
+ return malformed("HOST_REPEATED");
54
70
  hostHeader = header.value;
55
71
  }
56
72
  let target = rawTarget;
57
73
  let authority = null;
58
74
  if (!rawTarget.startsWith("/")) {
59
- const absolute = /^http:\/\/([^/?#]+)(\/\S*)?$/i.exec(rawTarget);
75
+ const absolute = ABSOLUTE_TARGET.exec(rawTarget);
60
76
  if (absolute === null)
61
- return { kind: "MALFORMED", reason: "TARGET_INVALID" };
77
+ return malformed("TARGET_INVALID");
78
+ // Stryker disable next-line all: the authority group is matched whenever the target is; the fallback satisfies the type.
62
79
  authority = parseAuthority(absolute[1] ?? "");
63
80
  if (authority === null)
64
- return { kind: "MALFORMED", reason: "TARGET_INVALID" };
81
+ return malformed("TARGET_INVALID");
65
82
  target = absolute[2] ?? "/";
66
83
  }
67
84
  if (hostHeader === null) {
68
85
  if (authority === null)
69
- return { kind: "MALFORMED", reason: "HOST_MISSING" };
86
+ return malformed("HOST_MISSING");
70
87
  }
71
88
  else {
72
89
  const fromHeader = parseAuthority(hostHeader);
73
90
  if (fromHeader === null)
74
- return { kind: "MALFORMED", reason: "HOST_INVALID" };
91
+ return malformed("HOST_INVALID");
75
92
  if (authority !== null &&
76
93
  (authority.host !== fromHeader.host || authority.port !== fromHeader.port)) {
77
- return { kind: "MALFORMED", reason: "TARGET_DISAGREES_WITH_HOST" };
94
+ return malformed("TARGET_DISAGREES_WITH_HOST");
78
95
  }
79
96
  authority ??= fromHeader;
80
97
  }
81
98
  return { kind: "REQUEST", method, target, host: authority.host, port: authority.port };
82
99
  }
83
- /** `host[:port]`, with the host a name, an IPv4 address or a bracketed IPv6 address. */
100
+ /** `host[:port]`, with the host a name, an IPv4 address or a bracketed IPv6 address, lowercased. */
84
101
  export function parseAuthority(value) {
85
- const text = value.trim().toLowerCase();
86
- if (text.length === 0 || text.length > 260)
102
+ const text = value.toLowerCase();
103
+ const match = IPV6_AUTHORITY.exec(text) ?? NAMED_AUTHORITY.exec(text);
104
+ if (match === null)
87
105
  return null;
88
- let host;
89
- let rest;
90
- if (text.startsWith("[")) {
91
- const close = text.indexOf("]");
92
- if (close === -1)
93
- return null;
94
- host = text.slice(0, close + 1);
95
- rest = text.slice(close + 1);
96
- if (!IPV6_LITERAL.test(host))
97
- return null;
98
- }
99
- else {
100
- const colon = text.indexOf(":");
101
- host = colon === -1 ? text : text.slice(0, colon);
102
- rest = colon === -1 ? "" : text.slice(colon);
103
- if (!HOST_NAME.test(host) && !IPV4.test(host))
104
- return null;
105
- }
106
- if (rest === "")
107
- return { host, port: null };
108
- if (!/^:\d{1,5}$/.test(rest))
106
+ // Stryker disable next-line all: the host group is matched whenever the authority is; the fallback satisfies the type.
107
+ const host = match[1] ?? "";
108
+ if (!host.startsWith("[") && !isHost(host))
109
109
  return null;
110
- const port = Number(rest.slice(1));
110
+ const digits = match[2];
111
+ if (digits === undefined)
112
+ return { host, port: null };
113
+ const port = Number(digits);
111
114
  if (port < 1 || port > 65_535)
112
115
  return null;
113
116
  return { host, port };
114
117
  }
115
118
  /**
116
- * Whether the first bytes could still be an HTTP request line: an uppercase
117
- * method token, then a space or the end of what has arrived. Enough to tell a
118
- * request from a binary protocol before the head is complete.
119
+ * A host name, or an IPv4 address. Digits and dots alone are read as an
120
+ * address and must be a valid one: `256.1.1.1` is a name to the grammar and an
121
+ * address to a reader, which is exactly the disagreement this parser refuses.
119
122
  */
120
- function looksLikeRequestLine(text) {
121
- return /^[A-Z][!#$%&'*+\-.^`|~\w]{0,19}(?: |$)/.test(text.slice(0, 21));
123
+ function isHost(host) {
124
+ if (DIGITS_AND_DOTS.test(host))
125
+ return isIpv4(host);
126
+ return HOST_NAME.test(host);
127
+ }
128
+ /** Four decimal octets, each without a leading zero and at most 255. */
129
+ function isIpv4(text) {
130
+ const octets = text.split(".");
131
+ return octets.length === 4 && octets.every((octet) => OCTET.test(octet) && Number(octet) <= 255);
122
132
  }
123
133
  /**
124
134
  * One header line as `name: value`, the name a token lowercased and the value
125
135
  * without its optional leading and trailing space or tab. A line with a bare
126
- * CR or LF, or no colon, or a name that is not a token, is not a header.
136
+ * CR or LF, no colon, or a name that is not a token is not a header.
127
137
  */
128
138
  function readHeaderLine(line) {
129
139
  if (line.includes("\n") || line.includes("\r"))
130
140
  return null;
131
141
  const colon = line.indexOf(":");
132
- if (colon <= 0)
142
+ if (colon === -1)
133
143
  return null;
134
144
  const name = line.slice(0, colon);
135
145
  if (!TOKEN.test(name))
136
146
  return null;
137
- let start = colon + 1;
138
- let end = line.length;
139
- while (start < end && (line[start] === " " || line[start] === "\t"))
140
- start += 1;
141
- while (end > start && (line[end - 1] === " " || line[end - 1] === "\t"))
142
- end -= 1;
143
- return { name: name.toLowerCase(), value: line.slice(start, end) };
147
+ return { name: name.toLowerCase(), value: trimBlanks(line.slice(colon + 1)) };
148
+ }
149
+ /** Without the optional leading and trailing spaces and tabs; nothing else is whitespace to HTTP. */
150
+ function trimBlanks(value) {
151
+ // Both searches find the same absence in a blank value, and the slice from
152
+ // one past the other's end is empty.
153
+ const start = value.search(/[^ \t]/);
154
+ const end = value.search(/[^ \t][ \t]*$/);
155
+ return value.slice(start, end + 1);
144
156
  }
145
157
  function latin1(bytes) {
146
158
  let text = "";