VDB
Sign up
HIGH8.8

GHSA-354v-3q48-cv69

Jupyter Server: Gateway WebSocket handler bypasses kernel execute authorization

Quick fix

GHSA-354v-3q48-cv69 — jupyter-server: upgrade to the fixed version with the command below.

pip install --upgrade 'jupyter-server>=2.6.0'

Details

### Summary

Jupyter Server's gateway WebSocket handler checks that a user is authenticated, but it does not ask the configured Authorizer whether that user may execute kernels.

In Jupyter Server 2.0.0 through 2.5.0, enabling GatewayClient.url automatically replaced the normal kernel channel handler with this gateway-specific handler. An authenticated user who is denied the `execute` action on the `kernels` resource can therefore still open a kernel channel and send messages to the upstream kernel.

### Details

The normal handler performs the expected authorization check before creating the WebSocket connection:

https://github.com/jupyter-server/jupyter_server/blob/v2.5.0/jupyter_server/services/kernels/websocket.py#L39-L47

The gateway handler only checks `current_user` and then opens the upstream channel. It never calls `authorizer.is_authorized(...)`:

https://github.com/jupyter-server/jupyter_server/blob/v2.5.0/jupyter_server/gateway/handlers.py#L49-L75 https://github.com/jupyter-server/jupyter_server/blob/v2.5.0/jupyter_server/gateway/handlers.py#L87-L98

Gateway mode selected that handler automatically by replacing handlers with matching routes:

https://github.com/jupyter-server/jupyter_server/blob/v2.5.0/jupyter_server/serverapp.py#L437-L446

PR #1261 stopped replacing the normal handler and routed gateway traffic through `GatewayWebSocketConnection` instead. This appears to have fixed the default gateway configuration in 2.6.0, although the deprecated handler is still present in current releases and can still be registered directly.

https://github.com/jupyter-server/jupyter_server/pull/1261

### Code-level validation

1. Configure a custom Authorizer that returns false for `execute` on `kernels` for a regular authenticated user. 2. Configure `GatewayClient.url` on Jupyter Server 2.0.0-2.5.0. 3. The normal `KernelWebsocketHandler` would reject that user with 403 in `pre_get`. 4. Gateway mode replaces it with `WebSocketChannelsHandler`. Its `authenticate` method only rejects anonymous users, and `get` proceeds to the upstream gateway without an authorization decision.

### Impact

This is a missing authorization check, not an authentication bypass. It matters in deployments that use a restrictive custom Authorizer and Jupyter Gateway/Enterprise Gateway. A read-only or otherwise limited authenticated user can cross the intended authorization boundary and obtain kernel execution, with access to data and credentials available to that kernel.

### Affected versions

- Default gateway configuration: 2.0.0 through 2.5.0 - 2.6.0 and later: the default path uses the authorized standard handler, but manually registering the deprecated `jupyter_server.gateway.handlers` module still exposes the old behavior.

Are you affected?

Enter the version of the package you're using.

Affected packages

PyPI/jupyter-server
Introduced in: 2.0.0Fixed in: 2.6.0
Fixpip install --upgrade 'jupyter-server>=2.6.0'

References