surrealdb: Cross-tenant access through the USE statement
What fixes it
- 3.3.0surrealdb, rustGitHub
A fixed version on one release line is not the upgrade target for every line. Check your exact version and any vendor backports.
Description
An authenticated user scoped to one namespace/database could read, modify, and delete data in another namespace/database on the same instance by switching to it with the SurrealQL USE statement.
USE NS … DB … moved the session to any requested namespace/database without checking that the caller's authenticated level covered it. After the switch, the caller's identity stayed bound to their own tenant, but queries ran against the foreign one, where the only remaining gate was the table's PERMISSIONS clause. So a table declared PERMISSIONS FULL, or with a predicate the caller happened to satisfy, admitted the request. That is a common table shape when the namespace/database itself is treated as the tenant boundary.
For example, a database user of ns_a/db_a could run:
USE NS ns_b DB db_b; SELECT * FROM secrets; -- read another tenant's rows UPDATE secrets:1 SET owned = true; -- modify them DELETE secrets:2; -- delete them
This is the same control that was fixed for the custom API route in GHSA-848m-r628-vrxw. That fix did not extend to the USE statement.
The same root cause was reported through several paths, each published as its own advisory and all fixed in 3.3.0:
- GHSA-vx2p-7hhm-wv62: the
Surreal-NS/Surreal-DBheaders with Basic authentication - GHSA-w5v9-jc5f-5rmc: the headers and the RPC
usemethod, for system users - GHSA-3vw5-j55x-486h:
RETURN … FETCH, for record users
Impact
What an attacker can do:
- With a database- or namespace-level account in any one tenant, switch to another tenant with
USE. They can then read, create, update, and delete rows in its tables whosePERMISSIONSallow the operation, such asPERMISSIONS FULL. - As a record user, write to another tenant's tables whose
PERMISSIONSallow it, even though record users' direct table scans in a foreign tenant were denied.
What it can't do:
- Reach any tenant without valid credentials for some namespace/database on the instance. This is not an unauthenticated bypass.
- Read or write a table whose relevant
PERMISSIONSclause denies the operation, includingPERMISSIONS NONE(theDEFINE TABLEdefault). - Pass IAM-gated operations such as
INFO FOR DB, or change roles. - Affect single-tenant deployments, or callers that already hold instance-wide (root) scope.
Patches
A request can no longer select a namespace/database outside the caller's authenticated level. The check applies to the USE statement, the RPC use method, and HTTP sessions built from the Surreal-NS / Surreal-DB headers. Root can select any namespace/database, and a namespace user any database in their namespace. Database and record users can select only their own namespace/database. Anonymous callers remain governed by table PERMISSIONS.
The query-time scope checks now apply to every scoped principal, not only record users. They also cover record fetches and the document write pipeline, so a read or write in a foreign tenant is refused however the session reached it.
- Versions 3.3.0 and later are not affected by this issue.
Workarounds
Users unable to patch should consider the following workarounds:
- On shared instances, use separate deployments, not namespace/database boundaries, to isolate tenants. Until you upgrade, issue namespace-, database-, and record-level credentials only to parties trusted with every tenant on the instance.
- Prefer a
PERMISSIONS WHEREclause that checks the caller's identity, such as$author a token claim, overPERMISSIONS FULL. This reduces exposure but does not restore the boundary.
References
- SurrealQL Documentation — USE
- SurrealQL Documentation — DEFINE TABLE … PERMISSIONS
- SurrealDB Documentation — Security and authentication
fix(core): enforce tenant boundary on USE / process_use(included in SurrealDB 3.3.0)fix(server): confine Surreal-NS/Surreal-DB header context to the auth level(included in SurrealDB 3.3.0)fix(core): confine record users to their own tenant on the write path(included in SurrealDB 3.3.0)fix(doc): re-verify record-auth namespace/database scope in the document pipeline(included in SurrealDB 3.3.0)
Acknowledgements
Thank you to xaxaks for reporting this issue.
Text from GitHub Advisory Database
Affected versions 1
- surrealdb, rust< 3.3.0GitHub