agl 41.2.0 → 42.1.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/changelog.md +41 -0
- package/dist_serve/bundle.js +2625 -2278
- package/dist_serve/bundle.js.map +2 -2
- package/dist_serve/bundle.js.third-party-notices.json +3 -68
- package/dist_serve/bundle.js.third-party-notices.txt +4 -137
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/aglapi/aglapisurface.document.js +4 -4
- package/dist_ts/classes.authmodels.d.ts +2 -8
- package/dist_ts/classes.authmodels.js +60 -23
- package/dist_ts/classes.authstore.d.ts +24 -0
- package/dist_ts/classes.authstore.js +185 -23
- package/dist_ts/classes.cli.d.ts +3 -6
- package/dist_ts/classes.cli.js +38 -51
- package/dist_ts/classes.config.d.ts +17 -3
- package/dist_ts/classes.config.js +55 -18
- package/dist_ts/classes.controller.d.ts +83 -14
- package/dist_ts/classes.controller.js +545 -229
- package/dist_ts/classes.controllerdevices.d.ts +128 -0
- package/dist_ts/classes.controllerdevices.js +472 -0
- package/dist_ts/classes.controllermanagement.d.ts +42 -9
- package/dist_ts/classes.controllermanagement.js +72 -23
- package/dist_ts/classes.controllerservice.d.ts +3 -31
- package/dist_ts/classes.controllerservice.js +3 -47
- package/dist_ts/classes.mcpcontrollerhost.js +9 -3
- package/dist_ts/classes.processinspection.d.ts +8 -1
- package/dist_ts/classes.processinspection.js +92 -2
- package/dist_ts/classes.proxycontrol.js +6 -1
- package/dist_ts/classes.proxydaemon.d.ts +2 -2
- package/dist_ts/classes.proxydaemon.js +1 -1
- package/dist_ts/classes.proxystore.d.ts +2 -11
- package/dist_ts/classes.proxystore.js +3 -25
- package/dist_ts/classes.sessionfeed.d.ts +10 -1
- package/dist_ts/classes.sessionfeed.js +12 -2
- package/dist_ts/classes.tpmsecretcodec.d.ts +13 -0
- package/dist_ts/classes.tpmsecretcodec.js +28 -0
- package/dist_ts/classes.trustedproxysecrets.d.ts +91 -0
- package/dist_ts/classes.trustedproxysecrets.js +338 -0
- package/dist_ts/classes.upgradecoordinator.d.ts +14 -1
- package/dist_ts/classes.upgradecoordinator.js +21 -3
- package/dist_ts/classes.upgradetransaction.d.ts +32 -0
- package/dist_ts/classes.upgradetransaction.js +101 -4
- package/dist_ts/classes.validation.d.ts +2 -0
- package/dist_ts/classes.validation.js +2 -2
- package/dist_ts/functions.controlleradmission.d.ts +67 -0
- package/dist_ts/functions.controlleradmission.js +127 -0
- package/dist_ts/functions.deviceapi.d.ts +28 -0
- package/dist_ts/functions.deviceapi.js +246 -0
- package/dist_ts/functions.deviceproof.d.ts +33 -0
- package/dist_ts/functions.deviceproof.js +93 -0
- package/dist_ts/functions.remotecli.d.ts +27 -0
- package/dist_ts/functions.remotecli.js +241 -0
- package/dist_ts/functions.retiredenvironment.d.ts +11 -2
- package/dist_ts/functions.retiredenvironment.js +22 -5
- package/dist_ts/index.d.ts +1 -0
- package/dist_ts/index.js +2 -1
- package/dist_ts/interfaces.auth.d.ts +29 -4
- package/dist_ts/interfaces.auth.js +10 -1
- package/dist_ts/interfaces.config.d.ts +14 -0
- package/dist_ts/interfaces.config.js +9 -2
- package/dist_ts/interfaces.lifecycle.d.ts +3 -0
- package/dist_ts_authswitch/classes.authoritydaemon.js +6 -1
- package/dist_ts_interfaces/devices.d.ts +331 -0
- package/dist_ts_interfaces/devices.js +34 -0
- package/dist_ts_interfaces/index.d.ts +2 -0
- package/dist_ts_interfaces/index.js +3 -1
- package/dist_ts_interfaces/interfaces.d.ts +5 -3
- package/dist_ts_interfaces/interfaces.js +3 -2
- package/dist_ts_interfaces/management.d.ts +2 -2
- package/dist_ts_interfaces/management.js +2 -2
- package/dist_ts_interfaces/mcprequests.d.ts +1 -1
- package/dist_ts_interfaces/requests.d.ts +2 -2
- package/dist_ts_interfaces/requests.devices.d.ts +89 -0
- package/dist_ts_interfaces/requests.devices.js +2 -0
- package/dist_ts_interfaces/requests.upgrade.d.ts +0 -12
- package/package.json +12 -11
- package/readme.md +116 -24
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/aglapi/aglapisurface.document.ts +3 -3
- package/ts/classes.authmodels.ts +68 -25
- package/ts/classes.authstore.ts +183 -24
- package/ts/classes.cli.ts +38 -61
- package/ts/classes.config.ts +70 -21
- package/ts/classes.controller.ts +746 -329
- package/ts/classes.controllerdevices.ts +469 -0
- package/ts/classes.controllermanagement.ts +123 -49
- package/ts/classes.controllerservice.ts +3 -56
- package/ts/classes.mcpcontrollerhost.ts +10 -5
- package/ts/classes.processinspection.ts +84 -3
- package/ts/classes.proxycontrol.ts +2 -0
- package/ts/classes.proxydaemon.ts +3 -2
- package/ts/classes.proxystore.ts +4 -25
- package/ts/classes.sessionfeed.ts +13 -1
- package/ts/classes.tpmsecretcodec.ts +26 -0
- package/ts/classes.trustedproxysecrets.ts +317 -0
- package/ts/classes.upgradecoordinator.ts +33 -3
- package/ts/classes.upgradetransaction.ts +130 -1
- package/ts/classes.validation.ts +1 -1
- package/ts/functions.controlleradmission.ts +168 -0
- package/ts/functions.deviceapi.ts +295 -0
- package/ts/functions.deviceproof.ts +118 -0
- package/ts/functions.remotecli.ts +270 -0
- package/ts/functions.retiredenvironment.ts +25 -3
- package/ts/index.ts +1 -0
- package/ts/interfaces.auth.ts +41 -3
- package/ts/interfaces.config.ts +15 -0
- package/ts/interfaces.lifecycle.ts +3 -0
- package/ts_authswitch/classes.authoritydaemon.ts +2 -0
- package/ts_interfaces/devices.schema.json +890 -0
- package/ts_interfaces/devices.ts +392 -0
- package/ts_interfaces/index.ts +2 -0
- package/ts_interfaces/interfaces.ts +5 -2
- package/ts_interfaces/management.ts +2 -2
- package/ts_interfaces/mcprequests.ts +1 -1
- package/ts_interfaces/requests.devices.ts +95 -0
- package/ts_interfaces/requests.ts +10 -10
- package/ts_interfaces/requests.upgrade.ts +0 -16
- package/ts_web/00_commitinfo_data.ts +1 -1
- package/ts_web/classes.controllersocketclient.ts +27 -0
- package/ts_web/elements.devices.ts +752 -0
- package/ts_web/elements.harnesscontrollerapp.ts +18 -1
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/** Seals a secret for this user and machine under a name it is bound to; only its ciphertext is stored. */
|
|
2
|
+
export interface ITpmSecretCodec {
|
|
3
|
+
seal(nameArg: string, plaintextArg: Uint8Array): Promise<string>;
|
|
4
|
+
unseal(nameArg: string, ciphertextArg: string): Promise<Uint8Array>;
|
|
5
|
+
}
|
|
6
|
+
/**
|
|
7
|
+
* TPM2-sealed secrets through `systemd-creds`, bound to their name: the inference proxy's client credentials and
|
|
8
|
+
* signature key, and the controller's trusted-proxy secret.
|
|
9
|
+
*/
|
|
10
|
+
export declare class TpmSecretCodec implements ITpmSecretCodec {
|
|
11
|
+
seal(nameArg: string, plaintextArg: Uint8Array): Promise<string>;
|
|
12
|
+
unseal(nameArg: string, ciphertextArg: string): Promise<Uint8Array>;
|
|
13
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import * as plugins from './plugins.js';
|
|
2
|
+
/**
|
|
3
|
+
* TPM2-sealed secrets through `systemd-creds`, bound to their name: the inference proxy's client credentials and
|
|
4
|
+
* signature key, and the controller's trusted-proxy secret.
|
|
5
|
+
*/
|
|
6
|
+
export class TpmSecretCodec {
|
|
7
|
+
async seal(nameArg, plaintextArg) {
|
|
8
|
+
const ciphertext = await plugins.smartsecret.sealSmartSecretTpm2Credential(nameArg, plaintextArg);
|
|
9
|
+
try {
|
|
10
|
+
return Buffer.from(ciphertext).toString('base64url');
|
|
11
|
+
}
|
|
12
|
+
finally {
|
|
13
|
+
ciphertext.fill(0);
|
|
14
|
+
}
|
|
15
|
+
}
|
|
16
|
+
async unseal(nameArg, ciphertextArg) {
|
|
17
|
+
if (!/^[A-Za-z0-9_-]{1,131072}$/.test(ciphertextArg))
|
|
18
|
+
throw new Error('Invalid sealed secret.');
|
|
19
|
+
const bytes = Buffer.from(ciphertextArg, 'base64url');
|
|
20
|
+
try {
|
|
21
|
+
return await plugins.smartsecret.unsealSmartSecretTpm2Credential(nameArg, bytes);
|
|
22
|
+
}
|
|
23
|
+
finally {
|
|
24
|
+
bytes.fill(0);
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy50cG1zZWNyZXRjb2RlYy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2NsYXNzZXMudHBtc2VjcmV0Y29kZWMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFReEM7OztHQUdHO0FBQ0gsTUFBTSxPQUFPLGNBQWM7SUFDbEIsS0FBSyxDQUFDLElBQUksQ0FBQyxPQUFlLEVBQUUsWUFBd0I7UUFDekQsTUFBTSxVQUFVLEdBQUcsTUFBTSxPQUFPLENBQUMsV0FBVyxDQUFDLDZCQUE2QixDQUFDLE9BQU8sRUFBRSxZQUFZLENBQUMsQ0FBQztRQUNsRyxJQUFJLENBQUM7WUFBQyxPQUFPLE1BQU0sQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLENBQUMsUUFBUSxDQUFDLFdBQVcsQ0FBQyxDQUFDO1FBQUMsQ0FBQztnQkFDckQsQ0FBQztZQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFBQyxDQUFDO0lBQ2pDLENBQUM7SUFFTSxLQUFLLENBQUMsTUFBTSxDQUFDLE9BQWUsRUFBRSxhQUFxQjtRQUN4RCxJQUFJLENBQUMsMkJBQTJCLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQztZQUFFLE1BQU0sSUFBSSxLQUFLLENBQUMsd0JBQXdCLENBQUMsQ0FBQztRQUNoRyxNQUFNLEtBQUssR0FBRyxNQUFNLENBQUMsSUFBSSxDQUFDLGFBQWEsRUFBRSxXQUFXLENBQUMsQ0FBQztRQUN0RCxJQUFJLENBQUM7WUFBQyxPQUFPLE1BQU0sT0FBTyxDQUFDLFdBQVcsQ0FBQywrQkFBK0IsQ0FBQyxPQUFPLEVBQUUsS0FBSyxDQUFDLENBQUM7UUFBQyxDQUFDO2dCQUNqRixDQUFDO1lBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUFDLENBQUM7SUFDNUIsQ0FBQztDQUNGIn0=
|
|
@@ -0,0 +1,91 @@
|
|
|
1
|
+
import * as plugins from './plugins.js';
|
|
2
|
+
import type { ITpmSecretCodec } from './classes.tpmsecretcodec.js';
|
|
3
|
+
/** One sealed generation of a controller's trusted-proxy secret. */
|
|
4
|
+
export interface IControllerTrustedProxySealedSecret {
|
|
5
|
+
/** Grows with every rotation and import; the secret is sealed under a name that binds it. */
|
|
6
|
+
generation: number;
|
|
7
|
+
/** TPM2-sealed (`TpmSecretCodec`); the plaintext exists only in the running controller and its gateway's route. */
|
|
8
|
+
ciphertext: string;
|
|
9
|
+
}
|
|
10
|
+
export interface IControllerTrustedProxySecretDocument {
|
|
11
|
+
/** The controller's id, `controller:<port>`. */
|
|
12
|
+
id: string;
|
|
13
|
+
/** The secret the controller accepts and its reverse proxy injects. */
|
|
14
|
+
active: IControllerTrustedProxySealedSecret;
|
|
15
|
+
/**
|
|
16
|
+
* A rotation its gateway's route does not carry yet: accepted beside `active` until `confirm` makes it the active
|
|
17
|
+
* one. Present only while a rotation is in progress.
|
|
18
|
+
*/
|
|
19
|
+
next?: IControllerTrustedProxySealedSecret;
|
|
20
|
+
}
|
|
21
|
+
export declare class ControllerTrustedProxySecretModel extends plugins.nosqldb.SmartDataDbDoc<ControllerTrustedProxySecretModel, IControllerTrustedProxySecretDocument> {
|
|
22
|
+
static exact: plugins.nosqldb.TExact<ControllerTrustedProxySecretModel>;
|
|
23
|
+
id: string;
|
|
24
|
+
active: IControllerTrustedProxySealedSecret;
|
|
25
|
+
next?: IControllerTrustedProxySealedSecret;
|
|
26
|
+
}
|
|
27
|
+
/** The bytes a well-formed secret encodes; refused, naming the format but never the value, otherwise. */
|
|
28
|
+
export declare const decodeTrustedProxySecret: (valueArg: string) => Buffer;
|
|
29
|
+
export interface IControllerTrustedProxySecretsOptions {
|
|
30
|
+
/** `controller:<port>`. */
|
|
31
|
+
controllerId: string;
|
|
32
|
+
/** The controller database's issuer id: the secret is sealed under a name bound to it. */
|
|
33
|
+
issuerId: string;
|
|
34
|
+
codec: ITpmSecretCodec;
|
|
35
|
+
}
|
|
36
|
+
/** The secret a gateway's route must carry, and the generation `confirm` names once the route carries it. */
|
|
37
|
+
export interface IControllerTrustedProxyRouteSecret {
|
|
38
|
+
secret: string;
|
|
39
|
+
generation: number;
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* The trusted-proxy secret of a controller in TLS-proxy mode: AGL generates it, keeps it TPM2-sealed in the
|
|
43
|
+
* controller's database and hands it only to its own gateway's route (or an operator imports it for another reverse
|
|
44
|
+
* proxy). Admission accepts the active secret and, while a rotation is in progress, the next one: a rotation keeps
|
|
45
|
+
* the previous secret valid until the route carrying the new one is confirmed. One running controller owns the
|
|
46
|
+
* record; the offline `agl remote` commands write it only while that controller is stopped.
|
|
47
|
+
*/
|
|
48
|
+
export declare class ControllerTrustedProxySecrets {
|
|
49
|
+
private readonly options;
|
|
50
|
+
private active;
|
|
51
|
+
private next;
|
|
52
|
+
private mutationTail;
|
|
53
|
+
private closed;
|
|
54
|
+
private constructor();
|
|
55
|
+
/** Opens the record of `controllerId`, generating and sealing the first secret when it has none. */
|
|
56
|
+
static open(optionsArg: IControllerTrustedProxySecretsOptions): Promise<ControllerTrustedProxySecrets>;
|
|
57
|
+
/** Whether a request's header value is the active secret or the rotation's; constant time per secret. */
|
|
58
|
+
accepts(valueArg: string | null): boolean;
|
|
59
|
+
/** The secret the gateway's route must carry: the rotation's while one is in progress, else the active one. */
|
|
60
|
+
routeSecret(): IControllerTrustedProxyRouteSecret;
|
|
61
|
+
/**
|
|
62
|
+
* Starts a rotation: a new secret, accepted beside the active one from now on, which the route must carry next.
|
|
63
|
+
* A rotation already in progress is returned again, so a sync that failed is retried with the same secret.
|
|
64
|
+
*/
|
|
65
|
+
rotate(): Promise<IControllerTrustedProxyRouteSecret>;
|
|
66
|
+
/**
|
|
67
|
+
* Ends a rotation once the route carries generation `generationArg`: it becomes the active secret and the previous
|
|
68
|
+
* one is refused from then on. Confirming the active generation again changes nothing; any other is refused.
|
|
69
|
+
*/
|
|
70
|
+
confirm(generationArg: number): Promise<void>;
|
|
71
|
+
/**
|
|
72
|
+
* Forgets the secrets in memory; the record stays. A rotation or confirmation still running fails, and what it
|
|
73
|
+
* stored meanwhile is not installed: the next open resumes the rotation or loads the confirmed secret.
|
|
74
|
+
*/
|
|
75
|
+
close(): void;
|
|
76
|
+
private assertOpen;
|
|
77
|
+
private mutate;
|
|
78
|
+
/** The stored record, which must still hold exactly what this controller opened or wrote. */
|
|
79
|
+
private readOwnRecord;
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Replaces a stopped controller's trusted-proxy secret with one an operator chose for another reverse proxy; a
|
|
83
|
+
* rotation in progress ends with it. Returns the new generation. The secret is never logged or echoed.
|
|
84
|
+
*/
|
|
85
|
+
export declare const importControllerTrustedProxySecret: (optionsArg: IControllerTrustedProxySecretsOptions & {
|
|
86
|
+
secret: string;
|
|
87
|
+
}) => Promise<{
|
|
88
|
+
generation: number;
|
|
89
|
+
}>;
|
|
90
|
+
/** Removes a stopped controller's trusted-proxy secret; whether there was one. */
|
|
91
|
+
export declare const removeControllerTrustedProxySecret: (controllerIdArg: string) => Promise<boolean>;
|
|
@@ -0,0 +1,338 @@
|
|
|
1
|
+
var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
|
|
2
|
+
function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
|
|
3
|
+
var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
|
|
4
|
+
var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
|
|
5
|
+
var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
|
|
6
|
+
var _, done = false;
|
|
7
|
+
for (var i = decorators.length - 1; i >= 0; i--) {
|
|
8
|
+
var context = {};
|
|
9
|
+
for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
|
|
10
|
+
for (var p in contextIn.access) context.access[p] = contextIn.access[p];
|
|
11
|
+
context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
|
|
12
|
+
var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
|
|
13
|
+
if (kind === "accessor") {
|
|
14
|
+
if (result === void 0) continue;
|
|
15
|
+
if (result === null || typeof result !== "object") throw new TypeError("Object expected");
|
|
16
|
+
if (_ = accept(result.get)) descriptor.get = _;
|
|
17
|
+
if (_ = accept(result.set)) descriptor.set = _;
|
|
18
|
+
if (_ = accept(result.init)) initializers.unshift(_);
|
|
19
|
+
}
|
|
20
|
+
else if (_ = accept(result)) {
|
|
21
|
+
if (kind === "field") initializers.unshift(_);
|
|
22
|
+
else descriptor[key] = _;
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
if (target) Object.defineProperty(target, contextIn.name, descriptor);
|
|
26
|
+
done = true;
|
|
27
|
+
};
|
|
28
|
+
var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
|
|
29
|
+
var useValue = arguments.length > 2;
|
|
30
|
+
for (var i = 0; i < initializers.length; i++) {
|
|
31
|
+
value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
|
|
32
|
+
}
|
|
33
|
+
return useValue ? value : void 0;
|
|
34
|
+
};
|
|
35
|
+
import * as plugins from './plugins.js';
|
|
36
|
+
const isSealedSecret = (valueArg) => {
|
|
37
|
+
const value = valueArg;
|
|
38
|
+
return !!value && typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length === 2
|
|
39
|
+
&& Number.isSafeInteger(value.generation) && value.generation >= 1
|
|
40
|
+
&& typeof value.ciphertext === 'string' && /^[A-Za-z0-9_-]{1,131072}$/u.test(value.ciphertext);
|
|
41
|
+
};
|
|
42
|
+
const assertDocument = (valueArg) => {
|
|
43
|
+
const value = valueArg;
|
|
44
|
+
if (!value || typeof value !== 'object'
|
|
45
|
+
|| Object.keys(value).length !== (Object.hasOwn(value, 'next') ? 3 : 2)
|
|
46
|
+
|| typeof value.id !== 'string' || !/^controller:[1-9][0-9]{0,4}$/u.test(value.id)
|
|
47
|
+
|| !isSealedSecret(value.active)
|
|
48
|
+
|| (Object.hasOwn(value, 'next') && (!isSealedSecret(value.next) || value.next.generation !== value.active.generation + 1))) {
|
|
49
|
+
throw new Error('Invalid trusted-proxy secret record.');
|
|
50
|
+
}
|
|
51
|
+
};
|
|
52
|
+
let ControllerTrustedProxySecretModel = (() => {
|
|
53
|
+
let _classDecorators = [plugins.nosqldb.managed({ collectionName: 'agl_controller_trusted_proxy_secrets' }), plugins.nosqldb.exactPersistence({ assertDocument })];
|
|
54
|
+
let _classDescriptor;
|
|
55
|
+
let _classExtraInitializers = [];
|
|
56
|
+
let _classThis;
|
|
57
|
+
let _classSuper = plugins.nosqldb.SmartDataDbDoc;
|
|
58
|
+
let _id_decorators;
|
|
59
|
+
let _id_initializers = [];
|
|
60
|
+
let _id_extraInitializers = [];
|
|
61
|
+
let _active_decorators;
|
|
62
|
+
let _active_initializers = [];
|
|
63
|
+
let _active_extraInitializers = [];
|
|
64
|
+
let _next_decorators;
|
|
65
|
+
let _next_initializers = [];
|
|
66
|
+
let _next_extraInitializers = [];
|
|
67
|
+
var ControllerTrustedProxySecretModel = class extends _classSuper {
|
|
68
|
+
static { _classThis = this; }
|
|
69
|
+
static {
|
|
70
|
+
const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
|
|
71
|
+
_id_decorators = [plugins.nosqldb.unI()];
|
|
72
|
+
_active_decorators = [plugins.nosqldb.svDb()];
|
|
73
|
+
_next_decorators = [plugins.nosqldb.svDb()];
|
|
74
|
+
__esDecorate(null, null, _id_decorators, { kind: "field", name: "id", static: false, private: false, access: { has: obj => "id" in obj, get: obj => obj.id, set: (obj, value) => { obj.id = value; } }, metadata: _metadata }, _id_initializers, _id_extraInitializers);
|
|
75
|
+
__esDecorate(null, null, _active_decorators, { kind: "field", name: "active", static: false, private: false, access: { has: obj => "active" in obj, get: obj => obj.active, set: (obj, value) => { obj.active = value; } }, metadata: _metadata }, _active_initializers, _active_extraInitializers);
|
|
76
|
+
__esDecorate(null, null, _next_decorators, { kind: "field", name: "next", static: false, private: false, access: { has: obj => "next" in obj, get: obj => obj.next, set: (obj, value) => { obj.next = value; } }, metadata: _metadata }, _next_initializers, _next_extraInitializers);
|
|
77
|
+
__esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
|
|
78
|
+
ControllerTrustedProxySecretModel = _classThis = _classDescriptor.value;
|
|
79
|
+
if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
|
|
80
|
+
__runInitializers(_classThis, _classExtraInitializers);
|
|
81
|
+
}
|
|
82
|
+
id = __runInitializers(this, _id_initializers, void 0);
|
|
83
|
+
active = (__runInitializers(this, _id_extraInitializers), __runInitializers(this, _active_initializers, void 0));
|
|
84
|
+
next = (__runInitializers(this, _active_extraInitializers), __runInitializers(this, _next_initializers, void 0));
|
|
85
|
+
constructor() {
|
|
86
|
+
super(...arguments);
|
|
87
|
+
__runInitializers(this, _next_extraInitializers);
|
|
88
|
+
}
|
|
89
|
+
};
|
|
90
|
+
return ControllerTrustedProxySecretModel = _classThis;
|
|
91
|
+
})();
|
|
92
|
+
export { ControllerTrustedProxySecretModel };
|
|
93
|
+
/** What a reverse proxy injects as `X-Harness-Controller-Proxy-Secret`: 32 random bytes, base64url (43 characters). */
|
|
94
|
+
const trustedProxySecretPattern = /^[A-Za-z0-9_-]{43}$/u;
|
|
95
|
+
/** The bytes a well-formed secret encodes; refused, naming the format but never the value, otherwise. */
|
|
96
|
+
export const decodeTrustedProxySecret = (valueArg) => {
|
|
97
|
+
const refusal = 'A trusted-proxy secret is 32 bytes, base64url-encoded (43 characters).';
|
|
98
|
+
if (!trustedProxySecretPattern.test(valueArg))
|
|
99
|
+
throw new Error(refusal);
|
|
100
|
+
const bytes = Buffer.from(valueArg, 'base64url');
|
|
101
|
+
if (bytes.byteLength !== 32 || bytes.toString('base64url') !== valueArg) {
|
|
102
|
+
bytes.fill(0);
|
|
103
|
+
throw new Error(refusal);
|
|
104
|
+
}
|
|
105
|
+
return bytes;
|
|
106
|
+
};
|
|
107
|
+
const sealName = (optionsArg, generationArg) => `agl-controller.${optionsArg.issuerId.slice(0, 22)}.${optionsArg.controllerId.replace(':', '-')}.trusted-proxy.${generationArg}`;
|
|
108
|
+
const sealSecret = async (optionsArg, generationArg, bytesArg) => ({
|
|
109
|
+
generation: generationArg,
|
|
110
|
+
ciphertext: await optionsArg.codec.seal(sealName(optionsArg, generationArg), bytesArg),
|
|
111
|
+
});
|
|
112
|
+
const unsealSecret = async (optionsArg, sealedArg) => {
|
|
113
|
+
let bytes;
|
|
114
|
+
try {
|
|
115
|
+
bytes = await optionsArg.codec.unseal(sealName(optionsArg, sealedArg.generation), sealedArg.ciphertext);
|
|
116
|
+
}
|
|
117
|
+
catch (errorArg) {
|
|
118
|
+
throw new Error(`The trusted-proxy secret of ${optionsArg.controllerId} cannot be unsealed on this machine. Stop `
|
|
119
|
+
+ 'the controller and import a secret with `agl remote secret import`.', { cause: errorArg });
|
|
120
|
+
}
|
|
121
|
+
try {
|
|
122
|
+
if (bytes.byteLength !== 32)
|
|
123
|
+
throw new Error(`The sealed trusted-proxy secret of ${optionsArg.controllerId} is invalid.`);
|
|
124
|
+
return { generation: sealedArg.generation, text: Buffer.from(Buffer.from(bytes).toString('base64url'), 'utf8') };
|
|
125
|
+
}
|
|
126
|
+
finally {
|
|
127
|
+
bytes.fill(0);
|
|
128
|
+
}
|
|
129
|
+
};
|
|
130
|
+
const readRecord = (controllerIdArg) => ControllerTrustedProxySecretModel.exact.findStoredOne({ id: controllerIdArg });
|
|
131
|
+
/**
|
|
132
|
+
* The trusted-proxy secret of a controller in TLS-proxy mode: AGL generates it, keeps it TPM2-sealed in the
|
|
133
|
+
* controller's database and hands it only to its own gateway's route (or an operator imports it for another reverse
|
|
134
|
+
* proxy). Admission accepts the active secret and, while a rotation is in progress, the next one: a rotation keeps
|
|
135
|
+
* the previous secret valid until the route carrying the new one is confirmed. One running controller owns the
|
|
136
|
+
* record; the offline `agl remote` commands write it only while that controller is stopped.
|
|
137
|
+
*/
|
|
138
|
+
export class ControllerTrustedProxySecrets {
|
|
139
|
+
options;
|
|
140
|
+
active;
|
|
141
|
+
next;
|
|
142
|
+
mutationTail = Promise.resolve();
|
|
143
|
+
closed = false;
|
|
144
|
+
constructor(options, active, next) {
|
|
145
|
+
this.options = options;
|
|
146
|
+
this.active = active;
|
|
147
|
+
this.next = next;
|
|
148
|
+
}
|
|
149
|
+
/** Opens the record of `controllerId`, generating and sealing the first secret when it has none. */
|
|
150
|
+
static async open(optionsArg) {
|
|
151
|
+
let stored = await readRecord(optionsArg.controllerId);
|
|
152
|
+
if (!stored) {
|
|
153
|
+
const bytes = plugins.crypto.randomBytes(32);
|
|
154
|
+
let active;
|
|
155
|
+
try {
|
|
156
|
+
active = await sealSecret(optionsArg, 1, bytes);
|
|
157
|
+
}
|
|
158
|
+
finally {
|
|
159
|
+
bytes.fill(0);
|
|
160
|
+
}
|
|
161
|
+
const inserted = await ControllerTrustedProxySecretModel.exact.insert({ id: optionsArg.controllerId, active });
|
|
162
|
+
if (inserted.status !== 'inserted' && inserted.status !== 'already_committed' && inserted.status !== 'conflict') {
|
|
163
|
+
throw new Error('The trusted-proxy secret could not be stored.');
|
|
164
|
+
}
|
|
165
|
+
stored = await readRecord(optionsArg.controllerId);
|
|
166
|
+
if (!stored)
|
|
167
|
+
throw new Error('The trusted-proxy secret could not be read back.');
|
|
168
|
+
}
|
|
169
|
+
const record = ControllerTrustedProxySecretModel.exact.toPersisted(stored);
|
|
170
|
+
const active = await unsealSecret(optionsArg, record.active);
|
|
171
|
+
try {
|
|
172
|
+
const next = record.next ? await unsealSecret(optionsArg, record.next) : undefined;
|
|
173
|
+
return new ControllerTrustedProxySecrets(optionsArg, active, next);
|
|
174
|
+
}
|
|
175
|
+
catch (errorArg) {
|
|
176
|
+
active.text.fill(0);
|
|
177
|
+
throw errorArg;
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
/** Whether a request's header value is the active secret or the rotation's; constant time per secret. */
|
|
181
|
+
accepts(valueArg) {
|
|
182
|
+
if (valueArg === null || this.closed)
|
|
183
|
+
return false;
|
|
184
|
+
const candidate = Buffer.from(valueArg, 'utf8');
|
|
185
|
+
let accepted = false;
|
|
186
|
+
for (const secret of [this.active, this.next]) {
|
|
187
|
+
if (secret && candidate.byteLength === secret.text.byteLength
|
|
188
|
+
&& plugins.crypto.timingSafeEqual(candidate, secret.text))
|
|
189
|
+
accepted = true;
|
|
190
|
+
}
|
|
191
|
+
return accepted;
|
|
192
|
+
}
|
|
193
|
+
/** The secret the gateway's route must carry: the rotation's while one is in progress, else the active one. */
|
|
194
|
+
routeSecret() {
|
|
195
|
+
this.assertOpen();
|
|
196
|
+
const secret = this.next ?? this.active;
|
|
197
|
+
return { secret: secret.text.toString('utf8'), generation: secret.generation };
|
|
198
|
+
}
|
|
199
|
+
/**
|
|
200
|
+
* Starts a rotation: a new secret, accepted beside the active one from now on, which the route must carry next.
|
|
201
|
+
* A rotation already in progress is returned again, so a sync that failed is retried with the same secret.
|
|
202
|
+
*/
|
|
203
|
+
rotate() {
|
|
204
|
+
return this.mutate(async () => {
|
|
205
|
+
if (this.next)
|
|
206
|
+
return { secret: this.next.text.toString('utf8'), generation: this.next.generation };
|
|
207
|
+
const current = await this.readOwnRecord();
|
|
208
|
+
const generation = this.active.generation + 1;
|
|
209
|
+
const bytes = plugins.crypto.randomBytes(32);
|
|
210
|
+
const text = Buffer.from(bytes.toString('base64url'), 'utf8');
|
|
211
|
+
let installed = false;
|
|
212
|
+
try {
|
|
213
|
+
let next;
|
|
214
|
+
try {
|
|
215
|
+
next = await sealSecret(this.options, generation, bytes);
|
|
216
|
+
}
|
|
217
|
+
finally {
|
|
218
|
+
bytes.fill(0);
|
|
219
|
+
}
|
|
220
|
+
this.assertOpen();
|
|
221
|
+
const result = await ControllerTrustedProxySecretModel.exact.transition({ current, change: (modelArg) => {
|
|
222
|
+
modelArg.next = next;
|
|
223
|
+
} });
|
|
224
|
+
if (result.status !== 'transitioned')
|
|
225
|
+
throw new Error('The trusted-proxy secret changed concurrently.');
|
|
226
|
+
// Closed while the rotation was being stored: it is not installed here; the next open resumes it.
|
|
227
|
+
this.assertOpen();
|
|
228
|
+
this.next = { generation, text };
|
|
229
|
+
installed = true;
|
|
230
|
+
return { secret: text.toString('utf8'), generation };
|
|
231
|
+
}
|
|
232
|
+
finally {
|
|
233
|
+
if (!installed)
|
|
234
|
+
text.fill(0);
|
|
235
|
+
}
|
|
236
|
+
});
|
|
237
|
+
}
|
|
238
|
+
/**
|
|
239
|
+
* Ends a rotation once the route carries generation `generationArg`: it becomes the active secret and the previous
|
|
240
|
+
* one is refused from then on. Confirming the active generation again changes nothing; any other is refused.
|
|
241
|
+
*/
|
|
242
|
+
confirm(generationArg) {
|
|
243
|
+
return this.mutate(async () => {
|
|
244
|
+
if (!this.next && this.active.generation === generationArg)
|
|
245
|
+
return;
|
|
246
|
+
if (!this.next || this.next.generation !== generationArg) {
|
|
247
|
+
throw new Error(`Generation ${generationArg} is not the trusted-proxy secret rotation in progress.`);
|
|
248
|
+
}
|
|
249
|
+
const current = await this.readOwnRecord();
|
|
250
|
+
const result = await ControllerTrustedProxySecretModel.exact.transition({ current, change: (modelArg) => {
|
|
251
|
+
modelArg.active = modelArg.next;
|
|
252
|
+
delete modelArg.next;
|
|
253
|
+
} });
|
|
254
|
+
if (result.status !== 'transitioned')
|
|
255
|
+
throw new Error('The trusted-proxy secret changed concurrently.');
|
|
256
|
+
// Closed while the confirmation was being stored: it stays stored, and the next open loads it as the active one.
|
|
257
|
+
this.assertOpen();
|
|
258
|
+
this.active.text.fill(0);
|
|
259
|
+
this.active = this.next;
|
|
260
|
+
this.next = undefined;
|
|
261
|
+
});
|
|
262
|
+
}
|
|
263
|
+
/**
|
|
264
|
+
* Forgets the secrets in memory; the record stays. A rotation or confirmation still running fails, and what it
|
|
265
|
+
* stored meanwhile is not installed: the next open resumes the rotation or loads the confirmed secret.
|
|
266
|
+
*/
|
|
267
|
+
close() {
|
|
268
|
+
this.closed = true;
|
|
269
|
+
this.active.text.fill(0);
|
|
270
|
+
this.next?.text.fill(0);
|
|
271
|
+
this.next = undefined;
|
|
272
|
+
}
|
|
273
|
+
assertOpen() {
|
|
274
|
+
if (this.closed)
|
|
275
|
+
throw new Error('The trusted-proxy secrets are closed.');
|
|
276
|
+
}
|
|
277
|
+
mutate(operationArg) {
|
|
278
|
+
if (this.closed)
|
|
279
|
+
return Promise.reject(new Error('The trusted-proxy secrets are closed.'));
|
|
280
|
+
const task = this.mutationTail.then(() => {
|
|
281
|
+
this.assertOpen();
|
|
282
|
+
return operationArg();
|
|
283
|
+
});
|
|
284
|
+
this.mutationTail = task.then(() => undefined, () => undefined);
|
|
285
|
+
return task;
|
|
286
|
+
}
|
|
287
|
+
/** The stored record, which must still hold exactly what this controller opened or wrote. */
|
|
288
|
+
async readOwnRecord() {
|
|
289
|
+
const stored = await readRecord(this.options.controllerId);
|
|
290
|
+
const record = stored ? ControllerTrustedProxySecretModel.exact.toPersisted(stored) : undefined;
|
|
291
|
+
if (!stored || record?.active.generation !== this.active.generation
|
|
292
|
+
|| record.next?.generation !== this.next?.generation) {
|
|
293
|
+
throw new Error('The trusted-proxy secret changed outside this controller.');
|
|
294
|
+
}
|
|
295
|
+
return stored;
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
/**
|
|
299
|
+
* Replaces a stopped controller's trusted-proxy secret with one an operator chose for another reverse proxy; a
|
|
300
|
+
* rotation in progress ends with it. Returns the new generation. The secret is never logged or echoed.
|
|
301
|
+
*/
|
|
302
|
+
export const importControllerTrustedProxySecret = async (optionsArg) => {
|
|
303
|
+
const bytes = decodeTrustedProxySecret(optionsArg.secret);
|
|
304
|
+
try {
|
|
305
|
+
const stored = await readRecord(optionsArg.controllerId);
|
|
306
|
+
const record = stored ? ControllerTrustedProxySecretModel.exact.toPersisted(stored) : undefined;
|
|
307
|
+
const generation = Math.max(record?.active.generation ?? 0, record?.next?.generation ?? 0) + 1;
|
|
308
|
+
const active = await sealSecret(optionsArg, generation, bytes);
|
|
309
|
+
if (!stored) {
|
|
310
|
+
const inserted = await ControllerTrustedProxySecretModel.exact.insert({ id: optionsArg.controllerId, active });
|
|
311
|
+
if (inserted.status !== 'inserted')
|
|
312
|
+
throw new Error('The trusted-proxy secret changed concurrently.');
|
|
313
|
+
return { generation };
|
|
314
|
+
}
|
|
315
|
+
const result = await ControllerTrustedProxySecretModel.exact.transition({ current: stored, change: (modelArg) => {
|
|
316
|
+
modelArg.active = active;
|
|
317
|
+
delete modelArg.next;
|
|
318
|
+
} });
|
|
319
|
+
if (result.status !== 'transitioned')
|
|
320
|
+
throw new Error('The trusted-proxy secret changed concurrently.');
|
|
321
|
+
return { generation };
|
|
322
|
+
}
|
|
323
|
+
finally {
|
|
324
|
+
bytes.fill(0);
|
|
325
|
+
}
|
|
326
|
+
};
|
|
327
|
+
/** Removes a stopped controller's trusted-proxy secret; whether there was one. */
|
|
328
|
+
export const removeControllerTrustedProxySecret = async (controllerIdArg) => {
|
|
329
|
+
const stored = await readRecord(controllerIdArg);
|
|
330
|
+
if (!stored)
|
|
331
|
+
return false;
|
|
332
|
+
const deleted = await ControllerTrustedProxySecretModel.exact.delete({ current: stored });
|
|
333
|
+
if (deleted.status !== 'deleted' && await readRecord(controllerIdArg)) {
|
|
334
|
+
throw new Error('The trusted-proxy secret could not be removed.');
|
|
335
|
+
}
|
|
336
|
+
return true;
|
|
337
|
+
};
|
|
338
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy50cnVzdGVkcHJveHlzZWNyZXRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvY2xhc3Nlcy50cnVzdGVkcHJveHlzZWNyZXRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQXVCeEMsTUFBTSxjQUFjLEdBQUcsQ0FBQyxRQUFpQixFQUFtRCxFQUFFO0lBQzVGLE1BQU0sS0FBSyxHQUFHLFFBQStELENBQUM7SUFDOUUsT0FBTyxDQUFDLENBQUMsS0FBSyxJQUFJLE9BQU8sS0FBSyxLQUFLLFFBQVEsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLElBQUksTUFBTSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxNQUFNLEtBQUssQ0FBQztXQUNsRyxNQUFNLENBQUMsYUFBYSxDQUFDLEtBQUssQ0FBQyxVQUFVLENBQUMsSUFBSSxLQUFLLENBQUMsVUFBVyxJQUFJLENBQUM7V0FDaEUsT0FBTyxLQUFLLENBQUMsVUFBVSxLQUFLLFFBQVEsSUFBSSw0QkFBNEIsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLFVBQVUsQ0FBQyxDQUFDO0FBQ25HLENBQUMsQ0FBQztBQUVGLE1BQU0sY0FBYyxHQUFxRixDQUFDLFFBQVEsRUFBRSxFQUFFO0lBQ3BILE1BQU0sS0FBSyxHQUFHLFFBQWlFLENBQUM7SUFDaEYsSUFBSSxDQUFDLEtBQUssSUFBSSxPQUFPLEtBQUssS0FBSyxRQUFRO1dBQ2xDLE1BQU0sQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUMsTUFBTSxLQUFLLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxLQUFLLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO1dBQ3BFLE9BQU8sS0FBSyxDQUFDLEVB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
|
|
@@ -140,6 +140,12 @@ export interface IUpgradeAuthorityHandoff {
|
|
|
140
140
|
export interface IUpgradeTransactionV2 extends IUpgradeTransactionBase {
|
|
141
141
|
version: typeof coordinationVersion;
|
|
142
142
|
sourceVersion: string;
|
|
143
|
+
/**
|
|
144
|
+
* What the source package declares about gateway sources (`controllerGatewaySourcesVersion` in its installed
|
|
145
|
+
* `package.json`), recorded by the CLI that creates the transaction and never changed afterwards. Absent when the
|
|
146
|
+
* source declares none, as every release before 42, whose CLI never writes it: absence means unsupported.
|
|
147
|
+
*/
|
|
148
|
+
sourceGatewaySourcesVersion?: number;
|
|
143
149
|
targetVersion?: string;
|
|
144
150
|
registryUrl?: string;
|
|
145
151
|
targetStartupInvoked?: true;
|
|
@@ -192,6 +198,11 @@ export declare const normalizeUpgradeRegistryUrl: (valueArg: unknown) => string;
|
|
|
192
198
|
* blockers with a `pauseState`; they are read as `settling` and the pause state is dropped.
|
|
193
199
|
*/
|
|
194
200
|
export declare const parseUpgradeBlockers: (valueArg: unknown) => IControllerUpgradeBlocker[];
|
|
201
|
+
/**
|
|
202
|
+
* A declared gateway-sources contract (`controllerGatewaySourcesVersion` in a package, `sourceGatewaySourcesVersion`
|
|
203
|
+
* in an upgrade transaction): a safe integer of 1 or more.
|
|
204
|
+
*/
|
|
205
|
+
export declare const isControllerGatewaySourcesVersion: (valueArg: unknown) => valueArg is number;
|
|
195
206
|
export declare const upgradeTransactionIsStalled: (transactionArg: TUpgradeTransaction, nowArg?: number) => boolean;
|
|
196
207
|
export declare const upgradeTransactionRequiresForwardRecovery: (transactionArg: TUpgradeTransaction) => boolean;
|
|
197
208
|
export declare const upgradeTransactionTargetVersion: (transactionArg: TUpgradeTransaction) => string | undefined;
|
|
@@ -261,7 +272,7 @@ export declare class UpgradeCoordinator {
|
|
|
261
272
|
token: string;
|
|
262
273
|
cliPath: string;
|
|
263
274
|
/** `__serve` is the service unit's controller starting without a CLI: after a failure, at login or at boot. */
|
|
264
|
-
command: 'start' | 'restart' | 'service' | 'foreground' | 'temp-password' | 'config' | '__serve';
|
|
275
|
+
command: 'start' | 'restart' | 'service' | 'foreground' | 'temp-password' | 'config' | 'remote' | '__serve';
|
|
265
276
|
upgradeToken?: string;
|
|
266
277
|
}): Promise<UpgradeStartLease>;
|
|
267
278
|
waitForStartLeasesToDrain(lockArg: UpgradeInstallationLock): Promise<void>;
|
|
@@ -275,6 +286,8 @@ export declare class UpgradeCoordinator {
|
|
|
275
286
|
token: string;
|
|
276
287
|
port: number;
|
|
277
288
|
sourceVersion: string;
|
|
289
|
+
/** The source package's `controllerGatewaySourcesVersion`, read from its installed `package.json`. */
|
|
290
|
+
sourceGatewaySourcesVersion?: number;
|
|
278
291
|
registryUrl?: string;
|
|
279
292
|
controllerWasRunning: boolean;
|
|
280
293
|
continueSessions: boolean;
|