# GHSA-r44w-v6gf-x3p6: pyLoad has an authentication bypass in API key validation (check_apikey cache)

> Attackers can bypass API authentication by exploiting a cache flaw that skips secret verification, allowing unauthorized access to user data and functions.

- **Severity:** Not scored
- **Exploited in the wild:** Not known
- **Login needed:** Not needed
- **Attackable:** Over the internet
- **Victim action needed:** Not needed
- **Fix available:** Yes
- **Published:** 9 Oct 2026

## What is GHSA-r44w-v6gf-x3p6?

GHSA-r44w-v6gf-x3p6 is an authentication bypass vulnerability in pyload-ng, published on 9 Oct 2026. An attacker can exploit it over the internet without logging in, with no action from the victim.

### Official description

## Summary

The API-key cache in `check_apikey()` allows an attacker to authenticate with a **forged API key** as long as the legitimate key for the same `key_id` has been used recently.

On a cache hit, the API key **secret is never verified**, resulting in a complete authentication bypass during the cache lifetime.

---

# Affected Components

- `src/pyload/core/api/init.py`
  - `Api.check_apikey()`

- `src/pyload/core/database/apikey_database.py`
  - `check_apikey()`
  - `_check_key()`

The cache is used by normal API requests through:

- `src/pyload/webui/app/helpers.py`

which calls:

```python
api.check_apikey(api_key)
```

without providing a `ttl`, meaning the default **300-second cache** is always enabled.

---

# Root Cause

Successful API key validations are cached in:

```python
self._apikey_cache
```

using the following structure:

```python
{
    key_id: (timestamp, cached_data)
}
```

The cache key is based **only on `key_id`**, and that value is parsed directly from the user-supplied API key rather than being obtained from a trusted lookup.

When a cache hit occurs within the TTL, `check_apikey()` returns:

```python
{
    "success": True,
    "data": cached_data
}
```

after checking only:

- `expires_at`

At no point on this execution path is the supplied secret:

```text
apikey[-43:]
```

compared against the stored key hash.

---

The actual secret verification exists only in:

```python
_check_key()
```

which correctly uses:

```python
hmac.compare_digest()
```

However, this function is only reached on a **cache miss** through the database layer's `check_apikey()` implementation.

Furthermore, the cached object cannot be used for verification because it intentionally does **not** include the stored key hash.

The cached record contains only:

- `id`
- `user_id`
- `name`
- `created_at`
- `expires_at`
- `last_used`

Since `key_hash` is absent, the cache lacks the information required to validate the presented secret.

As a result, once a legitimate request populates the cache, every subsequent request using the same `key_id` within the 300-second cache window is accepted **without validating the secret**.

---

# Impact

`key_id` values are small sequential integers assigned when API keys are created (1, 2, 3, ...), making them trivial to enumerate.

The API key format is also publicly reconstructable from the source code.

An attacker therefore does **not** need to know any valid API key secret.

They only need a `key_id` whose legitimate key has been used within the previous five minutes, which is likely on an actively used deployment.

During that cache window, a forged API key follows exactly the same authentication path as a legitimate key and inherits the associated user's permissions.

This results in a **complete remote authentication bypass**.

I would classify the issue as **Critical** severity.

---

# Estimated CVSS v3.1

```
AV:N/AC:H/PR:N/UI:N/S:U/C:H/I:H/A:H
```

(`AC:H` only because successful exploitation depends on the cache already containing an entry.)

---

# Reproduction

### 1. Create an administrator account.

---

### 2. Generate an API key.

Example:

```text
pl_11<43-character-secret>
```

where:

```
key_id = 1
```

---

### 3. Send a legitimate authenticated request.

```bash
curl \
  -H "X-API-Key: pl_11<real-43-char-secret>" \
  http://127.0.0.1:8000/api/status
```

Expected response:

```text
HTTP/1.1 200 OK
```

---

### 4. Within 300 seconds, send the same request using a forged API key.

```bash
curl \
  -H "X-API-Key: pl_11xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  http://127.0.0.1:8000/api/status
```

Observed response:

```text
HTTP/1.1 200 OK
```

The request succeeds even though the API key secret is entirely incorrect.

---

# Control Test

If the forged API key is sent **before** any legitimate request has populated the cache, the server correctly returns:

```text
HTTP/1.1 401 Unauthorized
```

The only difference between the failing and succeeding forged request is whether the cache already contains an entry for that `key_id`.

This isolates the vulnerability specifically to the cache-hit path.

---

# Suggested Fix

Cache hits should **never replace secret verification**.

Possible approaches include:

- Store a value derived from the complete API key (or its hash) in the cache and verify it using `hmac.compare_digest()` on every cache hit before returning success.

- Alternatively, key the cache using a value derived from the **entire API key secret** (for example, a cryptographic hash of the complete API key) rather than using only `key_id`.

Regardless of implementation, the security invariant should remain:

> **The API key secret must be validated on every authenticated request, regardless of whether the cache is hit or missed.**

## Which versions are affected by GHSA-r44w-v6gf-x3p6?

2 open source packages ship an affected version, including pyload-ng.


| Package | Ecosystem | Affected | Fixed in |
| --- | --- | --- | --- |
| `pyload-ng` | PyPI | All versions | 0.5.0b3.dev101 |
| `pyload-ng` | PyPI | All versions | 0.5.0b3.dev101 |

## How do I fix GHSA-r44w-v6gf-x3p6?

Upgrade pyload-ng to 0.5.0b3.dev101 or later.

## Is GHSA-r44w-v6gf-x3p6 being exploited?

There is no known exploitation of GHSA-r44w-v6gf-x3p6 in the wild and no public exploit code.

## Fix prompt for AI coding agents

```text
Check this codebase for GHSA-r44w-v6gf-x3p6 and fix it if it is affected.

What it is: GHSA-r44w-v6gf-x3p6 is an authentication bypass vulnerability in pyload-ng, published on 9 Oct 2026. An attacker can exploit it over the internet without logging in, with no action from the victim.
Exploitation: There is no known exploitation of GHSA-r44w-v6gf-x3p6 in the wild and no public exploit code.

Affected packages and fixed versions:
- pyload-ng (PyPI): affected all versions; fixed in 0.5.0b3.dev101
- pyload-ng (PyPI): affected all versions; fixed in 0.5.0b3.dev101

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-r44w-v6gf-x3p6/ (Markdown: https://insights.sbomify.com/GHSA-r44w-v6gf-x3p6/index.md)
```

## Sources

- OSV: https://osv.dev/vulnerability/GHSA-r44w-v6gf-x3p6

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