# GHSA-cc8f-fcx3-gpjr: SurrealDB: Arbitrary file read via DEFINE ANALYZER mapper() filter

> A low-privileged database user can read arbitrary files via a misconfigured analyzer filter, potentially exposing credentials and escalating privileges.

- **Severity:** Not scored
- **Exploited in the wild:** Not known
- **Login needed:** Any signed-in user
- **Attackable:** Over the internet
- **Victim action needed:** Not needed
- **Fix available:** Yes
- **Published:** 19 Jun 2026

## What is GHSA-cc8f-fcx3-gpjr?

GHSA-cc8f-fcx3-gpjr is a path traversal vulnerability in surrealdb, published on 19 Jun 2026. Any signed-in user can exploit it over the network, with no action from the victim.

### Official description

SurrealDB's full-text search lets you define a text analyzer whose `mapper` filter loads a term-mapping file from disk (`DEFINE ANALYZER ... FILTERS mapper('<path>')`). A database user with the `EDITOR` or `OWNER` role could point that filter at any file the SurrealDB process can read and have its content returned in the query's error message.

File access is meant to be restricted by the `SURREAL_FILE_ALLOWLIST` setting, but an empty allowlist applied no restriction at all — and empty is the default. 

## Impact

The file is read with the privileges of the SurrealDB process, so a database `EDITOR` or `OWNER` user can disclose the contents of any file the process can access. Only the **first line** of the file is returned, except for files with no newlines.

However recovering the process's command line and environment could expose startup root credentials (`--user` / `--pass`) and secret environment variables, escalating a single-database role toward full control of the instance.

The read on the underlying filesystem is bounded by what the SurrealDB process can reach — any file readable by the OS user it runs as — so the impact scales with how the process is run and what is mounted into it.

## Patches

A patch has been included in SurrealDB 3.1.5.

File access is now secure by default. `check_is_path_allowed` denies every path when no `SURREAL_FILE_ALLOWLIST` is configured, so the `mapper` filter cannot open any file unless the operator has explicitly allowed its directory. Analyzer parse errors no longer include the contents of the mapped file, only the line number.

## Workarounds

Users unable to upgrade are advised to consider the following:

- Set `SURREAL_FILE_ALLOWLIST` to a directory that contains only the intended mapping files; this confines the `mapper` filter to that path. On affected versions the allowlist must be non-empty to have any effect.
- Grant the `EDITOR` and `OWNER` database roles only to trusted principals.
- Avoid supplying secrets — including the root credentials — on the command line or through environment variables; prefer mounted files with least-privilege permissions.

## References

- [SurrealQL Documentation — DEFINE ANALYZER](https://surrealdb.com/docs/surrealql/statements/define/analyzer#define-analyzer-statement)
- [SurrealDB Documentation — Capabilities](https://surrealdb.com/docs/surrealdb/security/capabilities)
- Related earlier advisory: [GHSA-2cvj-g5r5-jrrg](https://github.com/surrealdb/surrealdb/security/advisories/GHSA-2cvj-g5r5-jrrg) local file read of 2-column TSV files via analyzers
- https://github.com/surrealdb/surrealdb/pull/5600
- fix(iam): deny filesystem access by default and stop leaking file content in analyzer errors

## Acknowledgements

Thanks to Jan Kahmen ([@kah-ja](https://github.com/kah-ja)) for finding and reporting this issue.

## Which versions are affected by GHSA-cc8f-fcx3-gpjr?

2 open source packages ship an affected version, including surrealdb.


| Package | Ecosystem | Affected | Fixed in |
| --- | --- | --- | --- |
| `surrealdb` | crates.io | All versions | 3.1.5 |
| `surrealdb` | crates.io | All versions | 3.1.5 |

## How do I fix GHSA-cc8f-fcx3-gpjr?

Upgrade surrealdb to 3.1.5 or later.

## Is GHSA-cc8f-fcx3-gpjr being exploited?

There is no known exploitation of GHSA-cc8f-fcx3-gpjr in the wild and no public exploit code.

## Fix prompt for AI coding agents

```text
Check this codebase for GHSA-cc8f-fcx3-gpjr and fix it if it is affected.

What it is: GHSA-cc8f-fcx3-gpjr is a path traversal vulnerability in surrealdb, published on 19 Jun 2026. Any signed-in user can exploit it over the network, with no action from the victim.
Exploitation: There is no known exploitation of GHSA-cc8f-fcx3-gpjr in the wild and no public exploit code.

Affected packages and fixed versions:
- surrealdb (crates.io): affected all versions; fixed in 3.1.5
- surrealdb (crates.io): affected all versions; fixed in 3.1.5

Task:
1. Search the dependency manifests and lockfiles (for example package.json, package-lock.json, requirements.txt, poetry.lock, uv.lock, pom.xml, build.gradle, go.mod, Cargo.lock, Gemfile.lock) and any Dockerfiles for the affected packages, including transitive dependencies.
2. If an affected version is in use, upgrade it to the fixed version for its release line with the project's package manager, so the lockfile is regenerated. Prefer the smallest upgrade that fixes it.
3. If there is no fix, or the upgrade would break the build, do not guess: explain the risk and the safest workaround instead.
4. Run the tests and summarise what changed and why.
5. If nothing in the project is affected, say so and change nothing.

Reference: https://insights.sbomify.com/GHSA-cc8f-fcx3-gpjr/ (Markdown: https://insights.sbomify.com/GHSA-cc8f-fcx3-gpjr/index.md)
```

## Sources

- OSV: https://osv.dev/vulnerability/GHSA-cc8f-fcx3-gpjr

---
From sbomify Insights: https://insights.sbomify.com/GHSA-cc8f-fcx3-gpjr/
Summaries are generated and may contain mistakes; the official description above is the record.