GraphQL Tools: Per-request connection parameters persist into later users' WebSocket authentications
Description
# Stale authentication state in @graphql-tools/executor-legacy-ws: per-request extensions.connectionParams persist in executor closure state and are replayed in a later caller's connection_init
Report metadata
| Field | Value | | --- | --- | | Package | @graphql-tools/executor-legacy-ws (npm, pkg:npm/%40graphql-tools/executor-legacy-ws) | | Repository | https://github.com/ardatan/graphql-tools | | Component | buildWSLegacyExecutor (packages/executors/legacy-ws/src/index.ts) | | Vulnerability class | Stale authentication state / credential reuse across requests | | Verified against | Commit b5d1c36ebb8ed3868260ffee5bbcbb423ad5c1f1; npm release 1.1.33 installed and exercised. During validation the same behaviour was also observed on the current latest release 1.1.35, and the unreset closure is still present on master. | | API surface | Public documented API (buildWSLegacyExecutor, and request.extensions.connectionParams on the returned executor) | | Affected in default configuration | Yes — the factory returns a general, reusable Executor with no per-identity or single-use restriction, and no supported teardown clears the retained parameters. |
Version note: the originally recorded affected range was <= 1.1.33. Validation showed that range understates exposure — the same proof of concept leaks identically on 1.1.35.
Summary
buildWSLegacyExecutor keeps a single closure-scoped object, executorConnectionParams, for the lifetime of the executor. Every execution that carries request.extensions.connectionParams merges those keys into that object with Object.assign, and the object is merged into the connection_init payload each time a new WebSocket opens. Nothing ever removes keys: cleanupWebsocket terminates the socket and nulls the handle but leaves executorConnectionParams intact, and a later request that simply omits a key skips the conditional update entirely.
The consumer-side shape is a shared executor that forwards per-user credentials. When one long-lived executor serves multiple principals — the schema-stitching, gateway, or mesh pattern where each ExecutionRequest supplies its own extensions.connectionParams — a request that omits the auth key is sent to the downstream server with the previous caller's Authorization/tenant values in its connection_init, so the downstream server authenticates the later caller as the earlier user.
Behaviour of the neighbouring state in the same file:
- WebSocket handle (
websocket) → reset on teardown incleanupWebsocket, lines 78-88 - Per-request
connectionParamsmerge, present case → applied as documented, lines 93-101 executorConnectionParamsclosure object → **never reset; survives socket teardown and is re-sent on the next connection, line 32 and line 54**
Impact
A caller who supplies no credentials (or lower-privileged ones) can have its downstream GraphQL subscription executed under a previous user's retained token or tenant value, and can receive data that its own connection_init would not authorize. The credential itself is never disclosed to the attacker — it reaches the sink through closure storage, not because the attacker knows it — but the downstream authorization it represents is.
The new capability versus safe behaviour: without this bug, an anonymous request would open a connection whose connection_init contains only base options plus that request's own parameters, and the downstream server would treat it as anonymous. With it, the anonymous request inherits the victim's authorization. Validation also showed partial-overwrite merging: a later caller supplying only {tenant: ""} gets the victim's Authorization retained alongside its own tenant, i.e. an attacker-chosen tenant authenticated with someone else's bearer token.
Scoring note: not scored. No CVSS vector accompanies this finding, and exploitability depends on the consuming application's data flow rather than on the library alone. Consumers that construct a fresh executor per request are not affected — the in-repository UrlLoader wrapper (`packages/loaders/url/src/index.ts:172-182`) builds a new executor for each request and therefore does not exhibit the persistence. The exposure is to applications that use the exported factory directly and share the executor.
Preconditions
- One executor instance created by
buildWSLegacyExecutoris reused across requests belonging to different users or authorization contexts. - The application uses the explicitly supported
extensions.connectionParamsfield to carry per-request downstream identity. This field is documented only by the source comment at line 91, which says additional connection params can be supplied through extensions but does not warn that values persist into later requests. - The first operation's socket is closed before the later operation opens a new one. This is the normal path, not an edge case: the
COMPLETEhandler callscleanupWebsocket()after every operation. - Attacker capability required: the ability to make a request through the sharing application — in a gateway, a remote user controls whether they authenticate and which subscription they ask for, and an anonymous request naturally leaves the
connectionParamskey absent. - The later request omits at least one sensitive key rather than overwriting every prior key (
Object.assignmerges, it does not replace).
This does not require non-standard usage, monkey-patching, or unusual configuration: the affected path is the documented extensions.connectionParams feature on the package's public API, and the library does not document per-request credential isolation as a caller responsibility. Validation confirmed that the library's own documented teardown, executor[Symbol.dispose]() (bound to cleanupWebsocket), does not clear the state either — no supported API resets it.
Data flow
- Source — a victim
ExecutionRequestsuppliesextensions.connectionParams, commonly anAuthorizationor tenant token (`packages/executors/legacy-ws/src/index.ts:90-100`). - Propagation —
Object.assignstores those keys in the closure-scopedexecutorConnectionParams(`index.ts:32`, `index.ts:97-100`). - Propagation —
cleanupWebsocketterminates the socket but does not resetexecutorConnectionParams(`index.ts:78-88`); the attacker's later request omitsconnectionParams, so the conditional update is skipped and the old keys remain (`index.ts:93-101`). - Sink — the new socket's
onopenmerges the retained state into theconnection_initpayload and sends it before the attacker's operation:payload = Object.assign(payload, executorConnectionParams); websocket!.send(...connection_init payload...)(`index.ts:44-65`, `index.ts:120-129`). - Reachability — the package directly exports
buildWSLegacyExecutor(`index.ts:27`), and the entry point is the returned disposable executor plusrequest.extensions.connectionParams.
Vulnerable code
packages/executors/legacy-ws/src/index.ts, lines 32-100 at b5d1c36ebb8ed3868260ffee5bbcbb423ad5c1f1:
let executorConnectionParams = {}; // closure state, lives as long as the executor
...
payload = Object.assign(payload, executorConnectionParams); // sink: retained keys enter connection_init
websocket!.send(JSON.stringify({ type: LEGACY_WS.CONNECTION_INIT, payload }));
...
if (request.extensions?.['connectionParams'] && typeof request.extensions?.['connectionParams'] === 'object') {
executorConnectionParams = Object.assign(executorConnectionParams, request.extensions['connectionParams']);
}
// no else branch: a request that omits connectionParams leaves the previous request's keys in place,
// and cleanupWebsocket (lines 78-88) resets only `websocket`, never `executorConnectionParams`.
Reproduction
Verified dynamically against the real package, not by static review alone. Release 1.1.33 was installed from npm and driven against a live local ws server implementing the legacy graphql-ws protocol, recording the connection_init payload of every physical connection.
Observed across the validation runs, using one shared executor instance:
- Request 1 (victim) sent
extensions.connectionParams{Authorization: "Bearer VICTIM-ALICE-SECRET-TOKEN", tenant: "alice-tenant"}. After that subscription completed, the executor sentconnection_terminateand tore the socket down. - Request 2 supplied no
connectionParams, yet the server observed a brand-new connection whoseconnection_initpayload was byte-identical to the victim's, including the victim's bearer token. - Partial overwrite: when the later caller supplied only
{tenant: "mallory-tenant"},Object.assignmerged rather than replaced, so the victim'sAuthorizationwas retained alongside the attacker's tenant. - Calling
executor[Symbol.dispose]()between requests did not clear the state. - Negative control: patching the installed
1.1.33to addexecutorConnectionParams = {}insidecleanupWebsocketmade the second connection's init payload{}, so the leak is causally attributable to the missing reset. - The same proof of concept leaks identically on
1.1.35, andmasterstill contains the unreset closure. Upstream line numbers onmasterare slightly offset from those cited above (closure declaration L38, conditionalObject.assignL100-105,cleanupWebsocketL84,onopenmerge L60-63).
Steps:
- Run a legacy GraphQL WS server that records the
connection_initpayload and authorizes notifications byAuthorizationvalue. - Use one executor for a victim request with
extensions.connectionParams.Authorization = 'Bearer victim-token'; finish/unsubscribe it so cleanup closes the socket. - Use the same executor for an anonymous request with no
extensions.connectionParams. - Observe that the second
connection_initstill containsBearer victim-tokenand that the anonymous subscription receives victim-authorized results.
import WebSocket from 'isomorphic-ws';
import { parse } from 'graphql';
import { buildWSLegacyExecutor } from '@graphql-tools/executor-legacy-ws';
const exec = buildWSLegacyExecutor('ws://localhost:8081/graphql', WebSocket);
const v = exec({
document: parse('subscription { privateEvents { id } }'),
extensions: { connectionParams: { Authorization: 'Bearer victim-token' } },
});
await v.next();
await v.return?.(); // iterator cleanup closes the first socket; executorConnectionParams is not cleared
const a = exec({ document: parse('subscription { privateEvents { id } }') });
await a.next(); // the server logs a second connection_init payload still carrying Authorization: Bearer victim-token
- Expected: the second
connection_initpayload contains only the base options and the second request's own parameters, with no key omitted by that request carried over from the victim. - Actual: the second
connection_initcarries the victim's retainedAuthorization/tenant values, and the downstream server authenticates the later caller as the victim.
Suggested remediation
Do not retain operation-level extensions.connectionParams beyond the operation and connection they belong to: build each connection_init payload from the base options plus the current request's parameters only, and clear connection-specific state during cleanup.
// 1. Clear the retained state when the connection is torn down.
function cleanupWebsocket() {
// ... existing connection_terminate / terminate / websocket = null ...
executorConnectionParams = {};
}
Alternative, and the more complete form: stop accumulating into shared closure state at all — derive the payload per request, e.g. const payload = { ...options.connectionParams, ...(request.extensions?.['connectionParams'] ?? {}) }, passed down to the onopen handler for that connection rather than read from the executor closure.
Notes:
executor[Symbol.dispose]()is bound tocleanupWebsocket, so fixing the reset there also makes the documented teardown behave as callers expect.Object.assignmerges rather than replaces, so a later request supplying *some* parameters still inherits the keys it omits; a fix that only replaces the object on the "present" branch would leave this half-open.- The
UrlLoaderpath in this repository constructs a fresh executor per request and is already safe; no change is needed there. The exposure is to direct consumers of the exportedbuildWSLegacyExecutor. - It would also help to define explicitly whether mixing distinct auth contexts on one executor is supported, and to reject it if not — today the factory returns a general
Executorwith no stated per-identity restriction.
Suggested regression test alongside the package's existing legacy-ws executor tests (the exact spec file is not verified by the available information): drive one executor against a recording server, send request 1 with extensions.connectionParams = { Authorization: 'Bearer victim-token' }, let it complete, then send request 2 with no connectionParams, and assert the second connection_init payload contains no Authorization key. Add a second case where request 2 supplies only { tenant: 'other' } and assert the payload is exactly { tenant: 'other' } plus base options.
Disclosure status
Currently undisclosed: no CVE, GHSA, advisory URL, upstream issue, or fix commit is associated with this finding, and no fixed version exists to upgrade to.
Resolution
Fixed in @graphql-tools/[email protected], which is published on npm. Each execution opens its own socket. connection_init is built from the executor's base connectionParams plus only that request's extensions.connectionParams. Upgrade to >=1.1.36.
Patches
Vulnerability mechanics
References
5- github.com/advisories/GHSA-434m-5hcj-pxf3ghsaADVISORY
- github.com/ardatan/graphql-tools/commit/c2f226e6f68236be9e4a577f29faeaa92547458bghsa
- github.com/ardatan/graphql-tools/pull/8480ghsa
- github.com/ardatan/graphql-tools/releases/tag/@graphql-tools/[email protected]ghsa
- github.com/ardatan/graphql-tools/security/advisories/GHSA-434m-5hcj-pxf3ghsa
News mentions
0No linked articles in our index yet.