@adaptic/backend 0.0.1038 → 0.0.1040
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/esm/auth/authorization-map.d.ts +13 -1
- package/esm/auth/authorization-map.d.ts.map +1 -1
- package/esm/auth/authorization-map.js.map +1 -1
- package/esm/auth/authorization-map.mjs +14 -1
- package/esm/auth/credential-fields.d.ts +19 -0
- package/esm/auth/credential-fields.d.ts.map +1 -0
- package/esm/auth/credential-fields.js.map +1 -0
- package/esm/auth/credential-fields.mjs +42 -0
- package/esm/auth/credential-redaction.d.ts +56 -0
- package/esm/auth/credential-redaction.d.ts.map +1 -0
- package/esm/auth/credential-redaction.js.map +1 -0
- package/esm/auth/credential-redaction.mjs +99 -0
- package/esm/auth/mutation-authorization.d.ts +206 -0
- package/esm/auth/mutation-authorization.d.ts.map +1 -0
- package/esm/auth/mutation-authorization.js.map +1 -0
- package/esm/auth/mutation-authorization.mjs +271 -0
- package/esm/auth/nested-write-inspector.d.ts +94 -0
- package/esm/auth/nested-write-inspector.d.ts.map +1 -0
- package/esm/auth/nested-write-inspector.js.map +1 -0
- package/esm/auth/nested-write-inspector.mjs +185 -0
- package/esm/auth/nested-write-policy.d.ts +95 -0
- package/esm/auth/nested-write-policy.d.ts.map +1 -0
- package/esm/auth/nested-write-policy.js.map +1 -0
- package/esm/auth/nested-write-policy.mjs +154 -0
- package/esm/auth/service-token.d.ts +11 -1
- package/esm/auth/service-token.d.ts.map +1 -1
- package/esm/auth/service-token.js.map +1 -1
- package/esm/auth/service-token.mjs +31 -5
- package/esm/auth/token-verifier.d.ts +9 -1
- package/esm/auth/token-verifier.d.ts.map +1 -1
- package/esm/auth/token-verifier.js.map +1 -1
- package/esm/auth/user-write-content.d.ts +41 -0
- package/esm/auth/user-write-content.d.ts.map +1 -0
- package/esm/auth/user-write-content.js.map +1 -0
- package/esm/auth/user-write-content.mjs +100 -0
- package/esm/middleware/__tests__/credential-field-coverage.harness.d.ts +55 -0
- package/esm/middleware/__tests__/credential-field-coverage.harness.d.ts.map +1 -0
- package/esm/middleware/__tests__/credential-field-coverage.harness.js.map +1 -0
- package/esm/middleware/__tests__/credential-field-coverage.harness.mjs +438 -0
- package/esm/middleware/__tests__/mutation-auth-guard.harness.d.ts +49 -0
- package/esm/middleware/__tests__/mutation-auth-guard.harness.d.ts.map +1 -0
- package/esm/middleware/__tests__/mutation-auth-guard.harness.js.map +1 -0
- package/esm/middleware/__tests__/mutation-auth-guard.harness.mjs +402 -0
- package/esm/middleware/__tests__/ts-node-harness.d.ts +10 -0
- package/esm/middleware/__tests__/ts-node-harness.d.ts.map +1 -0
- package/esm/middleware/__tests__/ts-node-harness.js.map +1 -0
- package/esm/middleware/__tests__/ts-node-harness.mjs +71 -0
- package/esm/middleware/audit-logger.d.ts +18 -1
- package/esm/middleware/audit-logger.d.ts.map +1 -1
- package/esm/middleware/audit-logger.js.map +1 -1
- package/esm/middleware/audit-logger.mjs +36 -13
- package/esm/middleware/audit-payload-guard.d.ts +85 -0
- package/esm/middleware/audit-payload-guard.d.ts.map +1 -0
- package/esm/middleware/audit-payload-guard.js.map +1 -0
- package/esm/middleware/audit-payload-guard.mjs +97 -0
- package/esm/middleware/credential-field-guard.d.ts +55 -7
- package/esm/middleware/credential-field-guard.d.ts.map +1 -1
- package/esm/middleware/credential-field-guard.js.map +1 -1
- package/esm/middleware/credential-field-guard.mjs +275 -106
- package/esm/middleware/generated-type-names.d.ts +44 -0
- package/esm/middleware/generated-type-names.d.ts.map +1 -0
- package/esm/middleware/generated-type-names.js.map +1 -0
- package/esm/middleware/generated-type-names.mjs +73 -0
- package/esm/middleware/guard-log-throttle.d.ts +80 -0
- package/esm/middleware/guard-log-throttle.d.ts.map +1 -0
- package/esm/middleware/guard-log-throttle.js.map +1 -0
- package/esm/middleware/guard-log-throttle.mjs +87 -0
- package/esm/middleware/mutation-account-facts.d.ts +140 -0
- package/esm/middleware/mutation-account-facts.d.ts.map +1 -0
- package/esm/middleware/mutation-account-facts.js.map +1 -0
- package/esm/middleware/mutation-account-facts.mjs +212 -0
- package/esm/middleware/mutation-auth-guard.d.ts +82 -0
- package/esm/middleware/mutation-auth-guard.d.ts.map +1 -0
- package/esm/middleware/mutation-auth-guard.js.map +1 -0
- package/esm/middleware/mutation-auth-guard.mjs +425 -0
- package/esm/middleware/mutation-tenant-facts.d.ts +58 -0
- package/esm/middleware/mutation-tenant-facts.d.ts.map +1 -0
- package/esm/middleware/mutation-tenant-facts.js.map +1 -0
- package/esm/middleware/mutation-tenant-facts.mjs +75 -0
- package/esm/middleware/trading-policy-audit.d.ts +172 -0
- package/esm/middleware/trading-policy-audit.d.ts.map +1 -0
- package/esm/middleware/trading-policy-audit.js.map +1 -0
- package/esm/middleware/trading-policy-audit.mjs +309 -0
- package/package.json +1 -1
- package/server.cjs +27 -2
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Attributed audit rows for every TradingPolicy write.
|
|
3
|
+
*
|
|
4
|
+
* `TradingPolicy` carries the switches that decide whether a brokerage account
|
|
5
|
+
* trades at all — `realtimeTradingEnabled`, `paperTradingOnly`,
|
|
6
|
+
* `killSwitchEnabled`, `autonomyMode` — and on a LIVE account flipping one is
|
|
7
|
+
* a capital decision. The generic mutation audit plugin cannot answer "who
|
|
8
|
+
* did this": it records a user id only for a UUID subject (so a service write
|
|
9
|
+
* or an anonymous one is `null`), records nothing for a mutation that failed
|
|
10
|
+
* or was refused, and reads the payload from `variables` (so an inline
|
|
11
|
+
* argument records as empty). A LIVE-flag change that nobody can attribute is
|
|
12
|
+
* the defect this module exists to close.
|
|
13
|
+
*
|
|
14
|
+
* Every TradingPolicy write — a root `…TradingPolicy` mutation or a nested
|
|
15
|
+
* `tradingPolicy: { … }` write under another model — produces:
|
|
16
|
+
*
|
|
17
|
+
* 1. an `attempt` row, written BEFORE the resolver runs, carrying the actor
|
|
18
|
+
* (principal kind, subject, email, IP, user agent, origin), the caller's
|
|
19
|
+
* stated reason (`X-Adaptic-Change-Reason` header), the authorization
|
|
20
|
+
* decision and its reason, the requested change, and each touched account's
|
|
21
|
+
* type and current switch values; and
|
|
22
|
+
* 2. a `result` row after it, carrying the outcome, linked by `attemptId`.
|
|
23
|
+
*
|
|
24
|
+
* Each touched policy is resolved from its OWN argument path: a nested write
|
|
25
|
+
* that reaches a different account than the root's is recorded against that
|
|
26
|
+
* account, and one whose account the arguments do not identify is recorded
|
|
27
|
+
* as `unresolved` — never attributed to the root's account.
|
|
28
|
+
*
|
|
29
|
+
* A refused write produces only the `attempt` row (its outcome is `denied`).
|
|
30
|
+
*
|
|
31
|
+
* Writing the attempt row first is what makes the record durable: if the
|
|
32
|
+
* attempt row cannot be written and the mutation is being enforced, the
|
|
33
|
+
* mutation is refused rather than executed unattributed. The caller decides
|
|
34
|
+
* that; this module reports the failure and never swallows it. The one
|
|
35
|
+
* exception is a write that only DISARMS ({@link isDisarmOnlyPolicyWrite}):
|
|
36
|
+
* refusing it during an AuditLog outage would block the protective direction
|
|
37
|
+
* (a kill switch, `realtimeTradingEnabled = false`) exactly when the system is
|
|
38
|
+
* degraded, so it is admitted, counted on
|
|
39
|
+
* `graphql_mutation_audit_bypassed_total`, and logged in full at error level.
|
|
40
|
+
*
|
|
41
|
+
* @module middleware/trading-policy-audit
|
|
42
|
+
*/
|
|
43
|
+
import { Counter } from 'prom-client';
|
|
44
|
+
import type { MutationAction, MutationAuthReason } from '../auth/mutation-authorization';
|
|
45
|
+
import type { BackendPrincipal } from '../auth/token-verifier';
|
|
46
|
+
/** Header a caller uses to state why it is changing a policy. */
|
|
47
|
+
export declare const CHANGE_REASON_HEADER = "x-adaptic-change-reason";
|
|
48
|
+
/** The switches whose change arms or disarms an account. */
|
|
49
|
+
export declare const TRADING_SWITCH_FIELDS: readonly ["realtimeTradingEnabled", "paperTradingOnly", "killSwitchEnabled", "autonomyMode"];
|
|
50
|
+
/** The switch values of one policy as they stood before the write. */
|
|
51
|
+
export type TradingSwitches = Partial<Record<(typeof TRADING_SWITCH_FIELDS)[number], boolean | string | null>>;
|
|
52
|
+
/**
|
|
53
|
+
* How a touched policy's account was identified: read from the database
|
|
54
|
+
* (`resolved`), created by this same mutation (`new_account`), or not
|
|
55
|
+
* identifiable from the arguments (`unresolved`).
|
|
56
|
+
*/
|
|
57
|
+
export type PolicyResolution = 'resolved' | 'new_account' | 'unresolved';
|
|
58
|
+
/** A policy row the write will touch, as read before the write. */
|
|
59
|
+
export interface AuditedPolicyRow {
|
|
60
|
+
/** Argument path of the nested write that reaches it; `null` for a root write. */
|
|
61
|
+
readonly nestedPath: string | null;
|
|
62
|
+
readonly resolution: PolicyResolution;
|
|
63
|
+
readonly policyId: string | null;
|
|
64
|
+
readonly alpacaAccountId: string | null;
|
|
65
|
+
readonly accountType: string | null;
|
|
66
|
+
readonly before: TradingSwitches | null;
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* Whether a write may touch a LIVE account's switches: a resolved LIVE
|
|
70
|
+
* account, or any account the guard could not identify (which may be LIVE).
|
|
71
|
+
*/
|
|
72
|
+
export declare function mayTouchLiveAccount(policies: readonly AuditedPolicyRow[]): boolean;
|
|
73
|
+
/** Who is writing, as far as the request can prove and report it. */
|
|
74
|
+
export interface AuditActor {
|
|
75
|
+
readonly principalKind: BackendPrincipal['kind'] | 'none';
|
|
76
|
+
readonly sub: string | null;
|
|
77
|
+
readonly email: string | null;
|
|
78
|
+
readonly ip: string | null;
|
|
79
|
+
readonly userAgent: string | null;
|
|
80
|
+
readonly origin: string | null;
|
|
81
|
+
}
|
|
82
|
+
/** Outcome recorded on a row. */
|
|
83
|
+
export type AuditOutcome = 'pending' | 'denied' | 'succeeded' | 'failed';
|
|
84
|
+
/** Everything recorded about one TradingPolicy write attempt. */
|
|
85
|
+
export interface TradingPolicyAuditEntry {
|
|
86
|
+
readonly mutation: string;
|
|
87
|
+
readonly action: MutationAction | 'custom';
|
|
88
|
+
/** Argument paths of the nested TradingPolicy writes; empty for a root write. */
|
|
89
|
+
readonly nestedPaths: readonly string[];
|
|
90
|
+
readonly actor: AuditActor;
|
|
91
|
+
readonly changeReason: string | null;
|
|
92
|
+
readonly decision: 'allowed' | 'would_deny' | 'denied';
|
|
93
|
+
readonly authorizationReason: MutationAuthReason;
|
|
94
|
+
readonly effectiveMode: string;
|
|
95
|
+
readonly graphqlOperationName: string | null;
|
|
96
|
+
readonly requested: Record<string, unknown>;
|
|
97
|
+
readonly policies: readonly AuditedPolicyRow[];
|
|
98
|
+
}
|
|
99
|
+
/** The slice of the Prisma client this module writes through. */
|
|
100
|
+
export interface AuditLogWriter {
|
|
101
|
+
auditLog: {
|
|
102
|
+
create(args: {
|
|
103
|
+
data: Record<string, unknown>;
|
|
104
|
+
}): Promise<{
|
|
105
|
+
id: string;
|
|
106
|
+
}>;
|
|
107
|
+
};
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* Disarm-only TradingPolicy writes admitted without an attempt row because
|
|
111
|
+
* AuditLog was unavailable under enforce. Each is also logged in full.
|
|
112
|
+
*/
|
|
113
|
+
export declare const mutationAuditBypassedTotal: Counter<"reason">;
|
|
114
|
+
/** Audit-row write failures, by phase. Non-zero means an unattributed write risk. */
|
|
115
|
+
export declare const mutationAuditWriteFailuresTotal: Counter<"phase">;
|
|
116
|
+
/** Collapse control characters and bound the length of a header value. */
|
|
117
|
+
export declare function sanitizeHeader(value: string | string[] | undefined, max: number): string | null;
|
|
118
|
+
/** The request slice the actor is read from. */
|
|
119
|
+
export interface ActorRequest {
|
|
120
|
+
ip?: string;
|
|
121
|
+
headers?: Record<string, string | string[] | undefined>;
|
|
122
|
+
}
|
|
123
|
+
/** Build the actor record for a request. */
|
|
124
|
+
export declare function actorFor(principal: BackendPrincipal | null, req: ActorRequest | undefined): AuditActor;
|
|
125
|
+
/** The caller's stated reason for the change, if it gave one. */
|
|
126
|
+
export declare function changeReasonFor(req: ActorRequest | undefined): string | null;
|
|
127
|
+
/** Whether a requested payload names any trading switch at any depth. */
|
|
128
|
+
export declare function touchesTradingSwitch(requested: unknown): boolean;
|
|
129
|
+
/**
|
|
130
|
+
* Write the pre-execution `attempt` row.
|
|
131
|
+
*
|
|
132
|
+
* @returns The new row's id.
|
|
133
|
+
* @throws Whatever the database raised; the caller decides whether that
|
|
134
|
+
* refuses the mutation. The failure is counted before it propagates.
|
|
135
|
+
*/
|
|
136
|
+
export declare function writeAttemptRow(prisma: AuditLogWriter, entry: TradingPolicyAuditEntry, outcome: 'pending' | 'denied'): Promise<string>;
|
|
137
|
+
/**
|
|
138
|
+
* Write the post-execution `result` row, linked to its attempt.
|
|
139
|
+
*
|
|
140
|
+
* @throws Whatever the database raised, after counting it. The mutation has
|
|
141
|
+
* already run at this point; the caller logs the failure loudly because the
|
|
142
|
+
* attempt row, not this one, is the attribution of record.
|
|
143
|
+
*/
|
|
144
|
+
export declare function writeResultRow(prisma: AuditLogWriter, entry: TradingPolicyAuditEntry, attemptId: string | null, outcome: 'succeeded' | 'failed', errorCode: string | null): Promise<void>;
|
|
145
|
+
/**
|
|
146
|
+
* Whether a root `updateOneTradingPolicy` only disarms: it sets at least one
|
|
147
|
+
* trading switch, every switch it sets moves to its disarmed value, and every
|
|
148
|
+
* other field it sets is bookkeeping (or re-states the row's own `id`). Any
|
|
149
|
+
* other shape — a nested write, an upsert (which may create an armed policy),
|
|
150
|
+
* a bulk write, a change to limits — is not disarm-only.
|
|
151
|
+
*
|
|
152
|
+
* @param target - The classified root mutation field.
|
|
153
|
+
* @param args - The field's arguments.
|
|
154
|
+
*/
|
|
155
|
+
export declare function isDisarmOnlyPolicyWrite(target: {
|
|
156
|
+
readonly model: string;
|
|
157
|
+
readonly action: string;
|
|
158
|
+
readonly cardinality: string;
|
|
159
|
+
}, args: Record<string, unknown>): boolean;
|
|
160
|
+
/**
|
|
161
|
+
* The actor request for a GraphQL-over-WebSocket operation, so a mutation
|
|
162
|
+
* sent over `/subscriptions` is attributed like an HTTP one: IP (socket
|
|
163
|
+
* remote address), user agent and origin from the upgrade request, and the
|
|
164
|
+
* change reason from the upgrade request's `X-Adaptic-Change-Reason` header
|
|
165
|
+
* or the connection's `connectionParams` (a browser cannot set headers on a
|
|
166
|
+
* WebSocket upgrade). The reason is per connection, not per operation.
|
|
167
|
+
*
|
|
168
|
+
* @param extra - graphql-ws `ctx.extra` (carries the upgrade `request`).
|
|
169
|
+
* @param connectionParams - graphql-ws `ctx.connectionParams`.
|
|
170
|
+
*/
|
|
171
|
+
export declare function wsActorRequest(extra: unknown, connectionParams: unknown): ActorRequest;
|
|
172
|
+
//# sourceMappingURL=trading-policy-audit.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"trading-policy-audit.d.ts","sourceRoot":"","sources":["../../../src/middleware/trading-policy-audit.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"trading-policy-audit.js","sourceRoot":"","sources":["../../../src/middleware/trading-policy-audit.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,309 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Attributed audit rows for every TradingPolicy write.
|
|
3
|
+
*
|
|
4
|
+
* `TradingPolicy` carries the switches that decide whether a brokerage account
|
|
5
|
+
* trades at all — `realtimeTradingEnabled`, `paperTradingOnly`,
|
|
6
|
+
* `killSwitchEnabled`, `autonomyMode` — and on a LIVE account flipping one is
|
|
7
|
+
* a capital decision. The generic mutation audit plugin cannot answer "who
|
|
8
|
+
* did this": it records a user id only for a UUID subject (so a service write
|
|
9
|
+
* or an anonymous one is `null`), records nothing for a mutation that failed
|
|
10
|
+
* or was refused, and reads the payload from `variables` (so an inline
|
|
11
|
+
* argument records as empty). A LIVE-flag change that nobody can attribute is
|
|
12
|
+
* the defect this module exists to close.
|
|
13
|
+
*
|
|
14
|
+
* Every TradingPolicy write — a root `…TradingPolicy` mutation or a nested
|
|
15
|
+
* `tradingPolicy: { … }` write under another model — produces:
|
|
16
|
+
*
|
|
17
|
+
* 1. an `attempt` row, written BEFORE the resolver runs, carrying the actor
|
|
18
|
+
* (principal kind, subject, email, IP, user agent, origin), the caller's
|
|
19
|
+
* stated reason (`X-Adaptic-Change-Reason` header), the authorization
|
|
20
|
+
* decision and its reason, the requested change, and each touched account's
|
|
21
|
+
* type and current switch values; and
|
|
22
|
+
* 2. a `result` row after it, carrying the outcome, linked by `attemptId`.
|
|
23
|
+
*
|
|
24
|
+
* Each touched policy is resolved from its OWN argument path: a nested write
|
|
25
|
+
* that reaches a different account than the root's is recorded against that
|
|
26
|
+
* account, and one whose account the arguments do not identify is recorded
|
|
27
|
+
* as `unresolved` — never attributed to the root's account.
|
|
28
|
+
*
|
|
29
|
+
* A refused write produces only the `attempt` row (its outcome is `denied`).
|
|
30
|
+
*
|
|
31
|
+
* Writing the attempt row first is what makes the record durable: if the
|
|
32
|
+
* attempt row cannot be written and the mutation is being enforced, the
|
|
33
|
+
* mutation is refused rather than executed unattributed. The caller decides
|
|
34
|
+
* that; this module reports the failure and never swallows it. The one
|
|
35
|
+
* exception is a write that only DISARMS ({@link isDisarmOnlyPolicyWrite}):
|
|
36
|
+
* refusing it during an AuditLog outage would block the protective direction
|
|
37
|
+
* (a kill switch, `realtimeTradingEnabled = false`) exactly when the system is
|
|
38
|
+
* degraded, so it is admitted, counted on
|
|
39
|
+
* `graphql_mutation_audit_bypassed_total`, and logged in full at error level.
|
|
40
|
+
*
|
|
41
|
+
* @module middleware/trading-policy-audit
|
|
42
|
+
*/
|
|
43
|
+
import { Counter } from 'prom-client';
|
|
44
|
+
import { redactCredentials } from '../auth/credential-redaction.mjs';
|
|
45
|
+
import { metricsRegistry } from '../config/metrics.mjs';
|
|
46
|
+
/** Header a caller uses to state why it is changing a policy. */
|
|
47
|
+
export const CHANGE_REASON_HEADER = 'x-adaptic-change-reason';
|
|
48
|
+
/** Longest change reason recorded, in characters. */
|
|
49
|
+
const MAX_CHANGE_REASON_LENGTH = 500;
|
|
50
|
+
/** Longest free-text header value (user agent, origin) recorded. */
|
|
51
|
+
const MAX_HEADER_LENGTH = 300;
|
|
52
|
+
/** The switches whose change arms or disarms an account. */
|
|
53
|
+
export const TRADING_SWITCH_FIELDS = [
|
|
54
|
+
'realtimeTradingEnabled',
|
|
55
|
+
'paperTradingOnly',
|
|
56
|
+
'killSwitchEnabled',
|
|
57
|
+
'autonomyMode',
|
|
58
|
+
];
|
|
59
|
+
/**
|
|
60
|
+
* Whether a write may touch a LIVE account's switches: a resolved LIVE
|
|
61
|
+
* account, or any account the guard could not identify (which may be LIVE).
|
|
62
|
+
*/
|
|
63
|
+
export function mayTouchLiveAccount(policies) {
|
|
64
|
+
return policies.some((p) => p.accountType === 'LIVE' || p.resolution !== 'resolved');
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* Disarm-only TradingPolicy writes admitted without an attempt row because
|
|
68
|
+
* AuditLog was unavailable under enforce. Each is also logged in full.
|
|
69
|
+
*/
|
|
70
|
+
export const mutationAuditBypassedTotal = new Counter({
|
|
71
|
+
name: 'graphql_mutation_audit_bypassed_total',
|
|
72
|
+
help: 'TradingPolicy writes admitted under enforce without an attempt audit row, by reason. ' +
|
|
73
|
+
'Only disarm-only writes (kill switch on, trading off, paper only, safe autonomy) qualify.',
|
|
74
|
+
labelNames: ['reason'],
|
|
75
|
+
registers: [metricsRegistry],
|
|
76
|
+
});
|
|
77
|
+
/** Audit-row write failures, by phase. Non-zero means an unattributed write risk. */
|
|
78
|
+
export const mutationAuditWriteFailuresTotal = new Counter({
|
|
79
|
+
name: 'graphql_mutation_audit_write_failures_total',
|
|
80
|
+
help: 'TradingPolicy audit rows that could not be written, by phase (attempt | result). ' +
|
|
81
|
+
'An attempt failure under enforce refuses the mutation; under shadow the write proceeds unattributed.',
|
|
82
|
+
labelNames: ['phase'],
|
|
83
|
+
registers: [metricsRegistry],
|
|
84
|
+
});
|
|
85
|
+
const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
|
|
86
|
+
/** C0 control characters and DEL: a header carrying them could forge log or row structure. */
|
|
87
|
+
const FIRST_PRINTABLE = 0x20;
|
|
88
|
+
const DELETE = 0x7f;
|
|
89
|
+
function isControlCharacter(ch) {
|
|
90
|
+
const code = ch.charCodeAt(0);
|
|
91
|
+
return code < FIRST_PRINTABLE || code === DELETE;
|
|
92
|
+
}
|
|
93
|
+
/** Collapse control characters and bound the length of a header value. */
|
|
94
|
+
export function sanitizeHeader(value, max) {
|
|
95
|
+
const raw = Array.isArray(value) ? value.join(',') : value;
|
|
96
|
+
if (typeof raw !== 'string')
|
|
97
|
+
return null;
|
|
98
|
+
const clean = [...raw]
|
|
99
|
+
.map((ch) => (isControlCharacter(ch) ? ' ' : ch))
|
|
100
|
+
.join('')
|
|
101
|
+
.replace(/ {2,}/g, ' ')
|
|
102
|
+
.trim();
|
|
103
|
+
if (clean.length === 0)
|
|
104
|
+
return null;
|
|
105
|
+
return clean.length > max ? `${clean.slice(0, max)}…` : clean;
|
|
106
|
+
}
|
|
107
|
+
/** Build the actor record for a request. */
|
|
108
|
+
export function actorFor(principal, req) {
|
|
109
|
+
const headers = req?.headers ?? {};
|
|
110
|
+
const base = {
|
|
111
|
+
ip: req?.ip ?? null,
|
|
112
|
+
userAgent: sanitizeHeader(headers['user-agent'], MAX_HEADER_LENGTH),
|
|
113
|
+
origin: sanitizeHeader(headers.origin, MAX_HEADER_LENGTH),
|
|
114
|
+
};
|
|
115
|
+
if (!principal)
|
|
116
|
+
return { principalKind: 'none', sub: null, email: null, ...base };
|
|
117
|
+
if (principal.kind === 'server') {
|
|
118
|
+
return { principalKind: 'server', sub: principal.sub ?? null, email: null, ...base };
|
|
119
|
+
}
|
|
120
|
+
return { principalKind: principal.kind, sub: principal.sub, email: principal.email ?? null, ...base };
|
|
121
|
+
}
|
|
122
|
+
/** The caller's stated reason for the change, if it gave one. */
|
|
123
|
+
export function changeReasonFor(req) {
|
|
124
|
+
return sanitizeHeader(req?.headers?.[CHANGE_REASON_HEADER], MAX_CHANGE_REASON_LENGTH);
|
|
125
|
+
}
|
|
126
|
+
/** Whether a requested payload names any trading switch at any depth. */
|
|
127
|
+
export function touchesTradingSwitch(requested) {
|
|
128
|
+
if (requested === null || typeof requested !== 'object')
|
|
129
|
+
return false;
|
|
130
|
+
for (const [key, child] of Object.entries(requested)) {
|
|
131
|
+
if (TRADING_SWITCH_FIELDS.includes(key))
|
|
132
|
+
return true;
|
|
133
|
+
if (touchesTradingSwitch(child))
|
|
134
|
+
return true;
|
|
135
|
+
}
|
|
136
|
+
return false;
|
|
137
|
+
}
|
|
138
|
+
function operationTypeFor(action) {
|
|
139
|
+
if (action === 'create')
|
|
140
|
+
return 'CREATE';
|
|
141
|
+
if (action === 'delete')
|
|
142
|
+
return 'DELETE';
|
|
143
|
+
return 'UPDATE';
|
|
144
|
+
}
|
|
145
|
+
function recordIdFor(policies) {
|
|
146
|
+
if (policies.length === 1) {
|
|
147
|
+
const [row] = policies;
|
|
148
|
+
if (row.policyId)
|
|
149
|
+
return row.policyId;
|
|
150
|
+
return row.alpacaAccountId ? `alpacaAccount:${row.alpacaAccountId}` : row.resolution;
|
|
151
|
+
}
|
|
152
|
+
return policies.length === 0 ? 'unresolved' : `bulk:${policies.length}`;
|
|
153
|
+
}
|
|
154
|
+
function rowData(entry, phase, outcome, extra) {
|
|
155
|
+
const { actor } = entry;
|
|
156
|
+
return {
|
|
157
|
+
userId: actor.sub !== null && UUID.test(actor.sub) ? actor.sub : null,
|
|
158
|
+
operationType: operationTypeFor(entry.action),
|
|
159
|
+
modelName: 'TradingPolicy',
|
|
160
|
+
recordId: recordIdFor(entry.policies),
|
|
161
|
+
operationName: entry.mutation,
|
|
162
|
+
ipAddress: actor.ip ? actor.ip.slice(0, 45) : null,
|
|
163
|
+
changedFields: redactCredentials({
|
|
164
|
+
requested: entry.requested,
|
|
165
|
+
nestedPaths: entry.nestedPaths,
|
|
166
|
+
}),
|
|
167
|
+
metadata: redactCredentials({
|
|
168
|
+
source: 'mutation-auth-guard',
|
|
169
|
+
phase,
|
|
170
|
+
outcome,
|
|
171
|
+
actor,
|
|
172
|
+
changeReason: entry.changeReason,
|
|
173
|
+
decision: entry.decision,
|
|
174
|
+
authorizationReason: entry.authorizationReason,
|
|
175
|
+
effectiveMode: entry.effectiveMode,
|
|
176
|
+
graphqlOperationName: entry.graphqlOperationName,
|
|
177
|
+
tradingSwitchTouched: touchesTradingSwitch(entry.requested),
|
|
178
|
+
accounts: entry.policies,
|
|
179
|
+
...extra,
|
|
180
|
+
}),
|
|
181
|
+
};
|
|
182
|
+
}
|
|
183
|
+
/**
|
|
184
|
+
* Write the pre-execution `attempt` row.
|
|
185
|
+
*
|
|
186
|
+
* @returns The new row's id.
|
|
187
|
+
* @throws Whatever the database raised; the caller decides whether that
|
|
188
|
+
* refuses the mutation. The failure is counted before it propagates.
|
|
189
|
+
*/
|
|
190
|
+
export async function writeAttemptRow(prisma, entry, outcome) {
|
|
191
|
+
try {
|
|
192
|
+
const row = await prisma.auditLog.create({ data: rowData(entry, 'attempt', outcome, {}) });
|
|
193
|
+
return row.id;
|
|
194
|
+
}
|
|
195
|
+
catch (error) {
|
|
196
|
+
mutationAuditWriteFailuresTotal.inc({ phase: 'attempt' });
|
|
197
|
+
throw error;
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
/**
|
|
201
|
+
* Write the post-execution `result` row, linked to its attempt.
|
|
202
|
+
*
|
|
203
|
+
* @throws Whatever the database raised, after counting it. The mutation has
|
|
204
|
+
* already run at this point; the caller logs the failure loudly because the
|
|
205
|
+
* attempt row, not this one, is the attribution of record.
|
|
206
|
+
*/
|
|
207
|
+
export async function writeResultRow(prisma, entry, attemptId, outcome, errorCode) {
|
|
208
|
+
try {
|
|
209
|
+
await prisma.auditLog.create({
|
|
210
|
+
data: rowData(entry, 'result', outcome, { attemptId, errorCode }),
|
|
211
|
+
});
|
|
212
|
+
}
|
|
213
|
+
catch (error) {
|
|
214
|
+
mutationAuditWriteFailuresTotal.inc({ phase: 'result' });
|
|
215
|
+
throw error;
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
/** The value each trading switch moves to when a write DISARMS it. */
|
|
219
|
+
const DISARMED_VALUES = {
|
|
220
|
+
realtimeTradingEnabled: new Set([false]),
|
|
221
|
+
killSwitchEnabled: new Set([true]),
|
|
222
|
+
paperTradingOnly: new Set([true]),
|
|
223
|
+
autonomyMode: new Set(['ADVISORY_ONLY', 'EMERGENCY_SAFE_MODE']),
|
|
224
|
+
};
|
|
225
|
+
/** Bookkeeping fields a disarm write may also set. */
|
|
226
|
+
const DISARM_BOOKKEEPING_FIELDS = new Set(['lastModifiedBy', 'lastModifiedAt', 'version']);
|
|
227
|
+
/** The value a generated update input sets: `{ set: v }` → `v`; anything else is not a plain set. */
|
|
228
|
+
function setValueOf(value) {
|
|
229
|
+
if (value === null || typeof value !== 'object' || Array.isArray(value))
|
|
230
|
+
return null;
|
|
231
|
+
const record = value;
|
|
232
|
+
const keys = Object.keys(record).filter((key) => record[key] !== undefined);
|
|
233
|
+
return keys.length === 1 && keys[0] === 'set' ? { value: record.set } : null;
|
|
234
|
+
}
|
|
235
|
+
/**
|
|
236
|
+
* Whether a root `updateOneTradingPolicy` only disarms: it sets at least one
|
|
237
|
+
* trading switch, every switch it sets moves to its disarmed value, and every
|
|
238
|
+
* other field it sets is bookkeeping (or re-states the row's own `id`). Any
|
|
239
|
+
* other shape — a nested write, an upsert (which may create an armed policy),
|
|
240
|
+
* a bulk write, a change to limits — is not disarm-only.
|
|
241
|
+
*
|
|
242
|
+
* @param target - The classified root mutation field.
|
|
243
|
+
* @param args - The field's arguments.
|
|
244
|
+
*/
|
|
245
|
+
export function isDisarmOnlyPolicyWrite(target, args) {
|
|
246
|
+
if (target.model !== 'TradingPolicy' || target.action !== 'update' || target.cardinality !== 'one') {
|
|
247
|
+
return false;
|
|
248
|
+
}
|
|
249
|
+
const data = args.data;
|
|
250
|
+
if (data === null || typeof data !== 'object' || Array.isArray(data))
|
|
251
|
+
return false;
|
|
252
|
+
const where = args.where;
|
|
253
|
+
let disarmed = 0;
|
|
254
|
+
for (const [key, raw] of Object.entries(data)) {
|
|
255
|
+
if (raw === undefined)
|
|
256
|
+
continue;
|
|
257
|
+
const set = setValueOf(raw);
|
|
258
|
+
if (!set)
|
|
259
|
+
return false;
|
|
260
|
+
if (key in DISARMED_VALUES) {
|
|
261
|
+
if (!DISARMED_VALUES[key].has(set.value))
|
|
262
|
+
return false;
|
|
263
|
+
disarmed += 1;
|
|
264
|
+
}
|
|
265
|
+
else if (!DISARM_BOOKKEEPING_FIELDS.has(key) && !(key === 'id' && where?.id === set.value)) {
|
|
266
|
+
return false;
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
return disarmed > 0;
|
|
270
|
+
}
|
|
271
|
+
/** Case-insensitive read of one key from a WebSocket `connectionParams` bag. */
|
|
272
|
+
function connectionParam(params, name) {
|
|
273
|
+
if (params === null || typeof params !== 'object')
|
|
274
|
+
return undefined;
|
|
275
|
+
for (const [key, value] of Object.entries(params)) {
|
|
276
|
+
if (key.toLowerCase() === name && typeof value === 'string')
|
|
277
|
+
return value;
|
|
278
|
+
}
|
|
279
|
+
return undefined;
|
|
280
|
+
}
|
|
281
|
+
/**
|
|
282
|
+
* The actor request for a GraphQL-over-WebSocket operation, so a mutation
|
|
283
|
+
* sent over `/subscriptions` is attributed like an HTTP one: IP (socket
|
|
284
|
+
* remote address), user agent and origin from the upgrade request, and the
|
|
285
|
+
* change reason from the upgrade request's `X-Adaptic-Change-Reason` header
|
|
286
|
+
* or the connection's `connectionParams` (a browser cannot set headers on a
|
|
287
|
+
* WebSocket upgrade). The reason is per connection, not per operation.
|
|
288
|
+
*
|
|
289
|
+
* @param extra - graphql-ws `ctx.extra` (carries the upgrade `request`).
|
|
290
|
+
* @param connectionParams - graphql-ws `ctx.connectionParams`.
|
|
291
|
+
*/
|
|
292
|
+
export function wsActorRequest(extra, connectionParams) {
|
|
293
|
+
const request = extra !== null && typeof extra === 'object' ? extra.request : undefined;
|
|
294
|
+
const req = request !== null && typeof request === 'object' ? request : {};
|
|
295
|
+
const rawHeaders = req.headers !== null && typeof req.headers === 'object' ? req.headers : {};
|
|
296
|
+
const headers = {};
|
|
297
|
+
for (const name of ['user-agent', 'origin', CHANGE_REASON_HEADER]) {
|
|
298
|
+
const value = rawHeaders[name];
|
|
299
|
+
if (typeof value === 'string' || Array.isArray(value))
|
|
300
|
+
headers[name] = value;
|
|
301
|
+
}
|
|
302
|
+
headers[CHANGE_REASON_HEADER] ??= connectionParam(connectionParams, CHANGE_REASON_HEADER);
|
|
303
|
+
const socket = req.socket !== null && typeof req.socket === 'object' ? req.socket : {};
|
|
304
|
+
return {
|
|
305
|
+
ip: typeof socket.remoteAddress === 'string' ? socket.remoteAddress : undefined,
|
|
306
|
+
headers,
|
|
307
|
+
};
|
|
308
|
+
}
|
|
309
|
+
//# sourceMappingURL=trading-policy-audit.js.map
|
package/package.json
CHANGED
package/server.cjs
CHANGED
|
@@ -63,6 +63,8 @@ const rate_limiter_1 = require("./middleware/rate-limiter.cjs");
|
|
|
63
63
|
const audit_logger_1 = require("./middleware/audit-logger.cjs");
|
|
64
64
|
const tenancy_scoping_1 = require("./middleware/tenancy-scoping.cjs");
|
|
65
65
|
const credential_field_guard_1 = require("./middleware/credential-field-guard.cjs");
|
|
66
|
+
const mutation_auth_guard_1 = require("./middleware/mutation-auth-guard.cjs");
|
|
67
|
+
const trading_policy_audit_1 = require("./middleware/trading-policy-audit.cjs");
|
|
66
68
|
const cortex_auth_checker_1 = require("./auth/cortex-auth-checker.cjs");
|
|
67
69
|
const authorization_map_1 = require("./auth/authorization-map.cjs");
|
|
68
70
|
const http_status_mapper_1 = require("./plugins/http-status-mapper.cjs");
|
|
@@ -169,6 +171,20 @@ const startServer = async () => {
|
|
|
169
171
|
// byte-identical live behaviour until enforcement is flipped on.
|
|
170
172
|
authChecker: cortex_auth_checker_1.cortexAuthChecker,
|
|
171
173
|
});
|
|
174
|
+
// Mutation authorization: every mutation is admitted only for a principal
|
|
175
|
+
// authorised to write that model — the engine's service principal and admins
|
|
176
|
+
// everywhere, a user only on an account, row or tenant it owns — and every
|
|
177
|
+
// TradingPolicy write leaves an attributed audit row. Installed on the built
|
|
178
|
+
// schema's Mutation fields (not as a global middleware, which would tax every
|
|
179
|
+
// read field), so it covers generated and custom mutations alike on both the
|
|
180
|
+
// HTTP and WebSocket transports. Gated by `MUTATION_AUTH_MODE` (unset =
|
|
181
|
+
// `shadow`) and the per-model escalation `MUTATION_AUTH_ENFORCE_MODELS`; see
|
|
182
|
+
// src/middleware/mutation-auth-guard.ts and
|
|
183
|
+
// docs/security/2026-09-24-mutation-authorization-runbook.md.
|
|
184
|
+
const guardedMutations = (0, mutation_auth_guard_1.installMutationAuthGuard)(schema);
|
|
185
|
+
logger_1.logger.info('[mutation-auth] guard installed on every root Mutation field', {
|
|
186
|
+
guardedMutations,
|
|
187
|
+
});
|
|
172
188
|
const app = (0, express_1.default)();
|
|
173
189
|
const httpServer = (0, http_1.createServer)(app);
|
|
174
190
|
// Trust the load-balancer proxy chain so `req.ip` resolves the CLIENT address
|
|
@@ -315,7 +331,10 @@ const startServer = async () => {
|
|
|
315
331
|
},
|
|
316
332
|
credentials: true,
|
|
317
333
|
methods: ['GET', 'POST', 'OPTIONS'],
|
|
318
|
-
|
|
334
|
+
// X-Adaptic-Change-Reason is the stated reason recorded on every
|
|
335
|
+
// TradingPolicy audit row (src/middleware/trading-policy-audit.ts); a
|
|
336
|
+
// browser caller can only send it if preflight allows it.
|
|
337
|
+
allowedHeaders: ['Content-Type', 'Authorization', 'X-Request-ID', 'X-Adaptic-Change-Reason'],
|
|
319
338
|
maxAge: 86400, // 24h preflight cache
|
|
320
339
|
};
|
|
321
340
|
app.use('/graphql', (0, cors_1.default)(corsOptions),
|
|
@@ -455,12 +474,18 @@ const startServer = async () => {
|
|
|
455
474
|
userAgent: wsIdentity.userAgent,
|
|
456
475
|
authHeaderPresent: authHeader.length > 0,
|
|
457
476
|
});
|
|
458
|
-
return {
|
|
477
|
+
return {
|
|
478
|
+
prisma: global.prisma,
|
|
479
|
+
req: (0, trading_policy_audit_1.wsActorRequest)(ctx.extra, ctx.connectionParams),
|
|
480
|
+
user: null,
|
|
481
|
+
principal: null,
|
|
482
|
+
};
|
|
459
483
|
}
|
|
460
484
|
case 'authenticated': {
|
|
461
485
|
(0, graphql_auth_shadow_1.recordAuthContextOutcome)('ws', 'authenticated');
|
|
462
486
|
return {
|
|
463
487
|
prisma: global.prisma,
|
|
488
|
+
req: (0, trading_policy_audit_1.wsActorRequest)(ctx.extra, ctx.connectionParams),
|
|
464
489
|
user: principalToUser(decision.principal),
|
|
465
490
|
principal: decision.principal,
|
|
466
491
|
};
|