Skip to content

Security: Developmi/caddy-waf

SECURITY.md

Security policy

Supported versions

Version Supported
3.6.x ✅ Yes (current)
3.5.x ❌ No - upgrade to 3.6.x
2.0.x ❌ No - migrated to Developmi, upgrade to 3.6.x
1.0.x ❌ No

Only the latest release line receives security updates.


Reporting a vulnerability

Do not open a public GitHub issue for security vulnerabilities.

Report vulnerabilities privately via one of these channels:

Include in your report:

  • Description of the vulnerability and its potential impact.
  • Steps to reproduce or a proof-of-concept.
  • Affected versions.
  • Any suggested mitigations.

Response timeline

Stage Target time
Acknowledgment 48 hours
Initial assessment 5 business days
Fix or mitigation 30 days (critical: 7 days)
Public disclosure After fix is available and users have had a reasonable window to upgrade

Disclosure policy

This project follows coordinated disclosure. We ask that you give us reasonable time to address the vulnerability before public disclosure. We will credit reporters in the release notes unless anonymity is requested.


Supply chain

This project uses:

  • Pinned dependencies: All Go plugins are pinned by version in the Dockerfile build args.
  • SHA256 verification: OWASP CRS rules and Coraza configuration are checksum-verified before installation.
  • Pin apk versions: Alpine packages (wget, tar) pinned by version.
  • Signed images: Container images published to GHCR are signed with Cosign (keyless OIDC). SBOM attestations are attached for every release.
  • Vulnerability scanning: Both architectures (linux/amd64 and linux/arm64) are scanned with Trivy before pushing. CRITICAL and HIGH vulnerabilities on either architecture block the pipeline.
  • SLSA provenance: Build provenance attested via GitHub's attest-build-provenance action.
  • Multi-arch: Images built for linux/amd64 and linux/arm64.

Verify the image signature before pulling in production:

cosign verify \
  --certificate-identity "https://github.com/Developmi/caddy-waf/.github/workflows/docker-build-scan-sign.yml@refs/heads/main" \
  --certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
  ghcr.io/developmi/caddy-waf@sha256:<digest>

Tip: Use immutable image digests (@sha256:...) instead of version tags in production for deterministic deployments.


Resolved CVEs

All CVEs listed below are resolved in caddy-waf v3.0.0 (Caddy ≥ 2.11.4) and later.


CVE-2026-27590

Field Value
CVE ID CVE-2026-27590
CVSS 9.1 CRITICAL
Vector AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N
CWE CWE-172 (Encoding Error)
Description Remote Code Execution via FastCGI Unicode encoding bypass. An attacker can execute arbitrary code when Caddy is configured as a reverse proxy to a FastCGI backend by sending a specially crafted request with Unicode-encoded path segments.
Affected caddy-waf < 3.0.0 (Caddy < 2.11.1)
Resolved In Caddy 2.11.1+ (included in caddy-waf v3.0.0)

CVE-2026-27587

Field Value
CVE ID CVE-2026-27587
CVSS 9.1 CRITICAL
Vector AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N
CWE CWE-22 (Path Traversal)
Description Path traversal via encoded URI. An attacker can access files outside the document root by submitting a crafted URI with encoded path traversal sequences that bypass Caddy's path normalization.
Affected caddy-waf < 3.0.0 (Caddy < 2.11.2)
Resolved In Caddy 2.11.2+ (included in caddy-waf v3.0.0)

CVE-2026-27588

Field Value
CVE ID CVE-2026-27588
CVSS 8.8 HIGH
Vector AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N
CWE CWE-178 (Case Sensitivity)
Description The Host matcher becomes case-sensitive for large host lists (>100 entries), enabling host-based route/auth bypass. An attacker can use a case-variant Host header to reach routes that should be protected.
Affected caddy-waf < 3.0.0 (Caddy < 2.11.3)
Resolved In Caddy 2.11.3+ (included in caddy-waf v3.0.0)

CVE-2026-30851

Field Value
CVE ID CVE-2026-30851
CVSS 8.8 HIGH
Vector AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:N
CWE CWE-444 (Inconsistent Interpretation)
Description Authentication bypass via request smuggling in path matching. An attacker can bypass authentication on protected routes by exploiting inconsistent path parsing between Caddy's route matching and the upstream handler.
Affected caddy-waf < 3.0.0 (Caddy < 2.11.1)
Resolved In Caddy 2.11.1+ (included in caddy-waf v3.0.0)

CVE-2026-52845

Field Value
CVE ID CVE-2026-52845
CVSS 8.1 HIGH
Vector AV:N/AC:L/PR:L/UI:N/S:U/C:H/I:H/A:N
CWE CWE-287 + CWE-290 + CWE-444
Description forward_auth copy_headers deletes the exact client-supplied identity header before copying the trusted value from the auth gateway. When the request goes through php_fastcgi, Caddy normalizes headers into CGI variables (replacing - with _). An underscore alias survives the delete step and becomes the same PHP/FastCGI variable, allowing a client to inject or override identity/group headers.
Affected caddy-waf < 3.0.0 (Caddy < 2.11.4)
Resolved In Caddy 2.11.4+ (included in caddy-waf v3.0.0)

CVE-2026-45135

Field Value
CVE ID CVE-2026-45135
CVSS 8.1 HIGH
Vector AV:N/AC:H/PR:N/UI:N/S:U/C:H/I:H/A:H
CWE CWE-20 (Improper Input Validation)
Description Unsafe Unicode handling in the FastCGI splitPos function (misuse of x/text search.IgnoreCase with non-ASCII bytes) can treat non-PHP files as scripts. If an attacker can place content on a file served via FastCGI (e.g. uploads), this can lead to remote code execution.
Affected caddy-waf < 3.0.0 (Caddy 2.7.0 - 2.11.2)
Resolved In Caddy 2.11.3+ (included in caddy-waf v3.0.0)
Note No FastCGI backend is used in the default deployment (reverse-proxy only). Documented for transparency.

CVE-2026-27586

Field Value
CVE ID CVE-2026-27586
CVSS 7.5 HIGH
Vector AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:H/A:N
CWE CWE-295 (Certificate Validation)
Description TLS client authentication silently fails open when the CA certificate file is missing or malformed. Connections from clients without a valid certificate are accepted when they should be rejected.
Affected caddy-waf < 3.0.0 (Caddy < 2.11.3)
Resolved In Caddy 2.11.3+ (included in caddy-waf v3.0.0)

CVE-2026-52844

Field Value
CVE ID CVE-2026-52844
CVSS 7.5 HIGH
Vector AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:N/A:N
CWE CWE-22 (Path Traversal)
Description On Windows only: Caddy path matchers treat /private\secret.txt as outside /private/, but file_server resolves the same request path as private\secret.txt on disk. An unauthenticated remote client can bypass Caddy path-scoped auth/deny routes.
Affected caddy-waf < 3.0.0 (Caddy < 2.11.4) on Windows only
Resolved In Caddy 2.11.4+ (included in caddy-waf v3.0.0)
Note Linux/container deployments are not affected. Documented for transparency.

CVE-2026-30852

Field Value
CVE ID CVE-2026-30852
CVSS 7.5 HIGH
Vector AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:N/A:N
CWE CWE-74 + CWE-200
Description The vars_regexp matcher double-expands user-controlled input through Caddy's replacer. A request header containing placeholder syntax (e.g. {env.DATABASE_URL} or {file./etc/passwd}) is expanded a second time, leaking environment variables, file contents, and system information in response headers.
Affected caddy-waf < 3.0.0 (Caddy >= 2.7.5, < 2.11.2)
Resolved In Caddy 2.11.2+ (included in caddy-waf v3.0.0)
Note Requires the vars_regexp matcher in the Caddyfile; not used in the default deployment. Documented for transparency.

CVE-2026-27585

Field Value
CVE ID CVE-2026-27585
CVSS 6.5 MEDIUM
Vector AV:N/AC:L/PR:N/UI:N/S:U/C:L/I:L/A:N
CWE CWE-20 (Improper Input Validation)
Description Improper sanitization of glob characters in the file matcher may lead to bypassing path-based security protections.
Affected caddy-waf < 3.0.0 (Caddy < 2.11.3)
Resolved In Caddy 2.11.3+ (included in caddy-waf v3.0.0)

CVE-2026-27589

Field Value
CVE ID CVE-2026-27589
CVSS 6.1 MEDIUM
Vector AV:L/AC:L/PR:N/UI:R/S:C/C:L/I:L/A:L
CWE CWE-942 (CORS)
Description Cross-origin requests attempted with no-cors mode could cause some API requests to succeed. (Requires a malicious web page running locally to the production Caddy process.)
Affected caddy-waf < 3.0.0 (Caddy < 2.11.3)
Resolved In Caddy 2.11.3+ (included in caddy-waf v3.0.0)

CVE-2026-45692

Field Value
CVE ID CVE-2026-45692
CVSS 5.4 MEDIUM
Vector AV:N/AC:L/PR:L/UI:N/S:U/C:L/I:L/A:N
CWE CWE-187 (Partial String Comparison)
Description Remote admin authorization bypass in the /config API: array index normalization is matched before prefix matching, allowing a limited admin user to reach configuration paths outside the intended prefix.
Affected caddy-waf < 3.0.0 (Caddy >= 2.4.0, < 2.11.3)
Resolved In Caddy 2.11.3+ (included in caddy-waf v3.0.0)
Note Remote admin is not enabled in this project (admin listener is localhost-only). Documented for transparency.

CVE-2026-52846

Field Value
CVE ID CVE-2026-52846
CVSS 4.2 MEDIUM
Vector AV:N/AC:H/PR:N/UI:R/S:U/C:L/I:L/A:N
CWE CWE-116 (Improper Encoding or Escaping of Output)
Description The stripHTML template function can be bypassed with malformed HTML (e.g. <<>img src=x onerror=alert()>), allowing XSS when the sanitized output is rendered.
Affected caddy-waf < 3.0.0 (Caddy < 2.11.4)
Resolved In Caddy 2.11.4+ (included in caddy-waf v3.0.0)
Note The templates directive is not used in this deployment (reverse-proxy only) - not reachable.

GHSA-j8px-rmrx-76h9

Field Value
Advisory GHSA-j8px-rmrx-76h9 (no CVE assigned)
CVSS Moderate
Vector -
CWE CWE-178 (Case Sensitivity)
Description Three vulnerabilities patched in v2.11.4: rewrite placeholder re-expansion; unbounded body buffer DoS via {http.request.body} (OOM-kill under container memory limits); fileHidden() case-sensitivity bypass (casefold matching on macOS/Windows/Linux).
Affected caddy-waf < 3.0.0 (Caddy <= 2.11.3)
Resolved In Caddy 2.11.4+ (included in caddy-waf v3.0.0)

OWASP CRS - not affected

The following CVEs affect older OWASP CRS versions. caddy-waf v3.6.0+ ships CRS v4.30.0 and is not affected. Listed for transparency.

CVE CVSS Fixed In Description
CVE-2026-21876 9.3 CRITICAL CRS ≥ 4.22.0 Multipart charset bypass in rule 922110
CVE-2026-33691 6.8 MEDIUM CRS ≥ 4.25.0 File upload bypass with whitespace padding

Caddy advisories - not applicable

The following advisories do not affect this project. Listed for transparency.

Advisory Severity Description Why not applicable
GHSA-wwhq-w58m-w29c High (no CVE) Bypass of the CVE-2026-30852 fix - literal keys in vars_regexp (e.g. tenant_id) still double-expand and leak {env.*} / {file.*} placeholders Affects Caddy <= 2.11.2 only (no patched release); caddy-waf ships Caddy 2.11.7 - out of affected range
GHSA-gx7w-56w6-g48x Moderate Remote admin authorization bypass on PKI endpoints via prefix-based path matching Remote admin is not enabled in this project (admin listener is localhost-only) - not reachable. Re-verify before adopting roadmap item 6 (mTLS remote admin)

Active & Pending advisories

Advisory Component Severity Status & Assessment
CVE-2026-116587 github.com/go-jose/go-jose/v4 HIGH Mitigated: patched to v4.1.8 via xcaddy build --replace in Dockerfile (incorporating upstream fixes for GHSA-r39w-98wm-9pp6, GHSA-27pc-rm86-68pq, GHSA-p9j4-2j95-j4rv, GHSA-v6h2-qj3f-2h6v, GHSA-c67m-wr4h-2ccg).
CVE-2026-116587 github.com/go-jose/go-jose/v3 HIGH Unpatched upstream (v3.0.5 is latest; first_patched_version is null). Transitive dependency via smallstep/crypto in Caddy PKI. Untrusted JWKs are not parsed or accepted in standard WAF reverse-proxy deployment; temporarily suppressed in .trivyignore.

Resolved in x/net v0.62.0 (2026-11-07) — updating golang.org/x/net to v0.62.0 in the builder stage resolved 1 HIGH vulnerability detected by Trivy in usr/bin/caddy:

Advisory Component (before) Fixed by
CVE-2026-78661 golang.org/x/net v0.61.0 golang.org/x/net/html DoS via crafted HTML input golang.org/x/net v0.62.0 replacement in xcaddy build

Resolved in Go 1.27.2 & x/net v0.61.0 (2026-10-11) — compiling Caddy with GOTOOLCHAIN=go1.27.2 and updating golang.org/x/net to v0.61.0 in the builder stage resolved 4 HIGH vulnerabilities detected by Trivy in usr/bin/caddy:

Advisory Component (before) Fixed by
CVE-2026-78667 Go stdlib v1.27.1 net/http DoS via crafted HTTP Range headers Go 1.27.2 toolchain pin (GOTOOLCHAIN=go1.27.2)
CVE-2026-78669 Go stdlib v1.27.1 net/http/internal/http2 DoS via excessive HTTP/2 SETTINGS frames Go 1.27.2 toolchain pin (GOTOOLCHAIN=go1.27.2)
CVE-2026-97031 Go stdlib v1.27.1 crypto/tls DoS via multiple ECH outer extension references Go 1.27.2 toolchain pin (GOTOOLCHAIN=go1.27.2)
CVE-2026-78669 golang.org/x/net v0.59.0 HTTP/2 SETTINGS frame DoS golang.org/x/net v0.61.0 replacement in xcaddy build

Resolved in coraza-caddy v2.6.2 (2026-10-10) — upgrading CORAZA_CADDY_REF to v2.6.2 incorporates Coraza v3.8.1, resolving 6 upstream Coraza engine advisories:

Advisory Component (before) Fixed by
GHSA-6gcq-wc29-5xf2 (CVE-2026-107826) Coraza JSON body processor unbounded stack overflow (gjson.Valid) Coraza v3.8.1 (coraza-caddy v2.6.2)
GHSA-6r3q-mjv7-xr8m (CVE-2026-41510) Coraza silent argument drop at SecArgumentsLimit parameter flooding bypass Coraza v3.8.1 (coraza-caddy v2.6.2)
GHSA-5gj4-9gm7-2fx2 Coraza body processor JSON key collision vulnerability Coraza v3.8.1 (coraza-caddy v2.6.2)
GHSA-w253-m66g-rx24 Coraza file descriptor leak during request processing Coraza v3.8.1 (coraza-caddy v2.6.2)
GHSA-3wr7-993q-jrff Coraza JSON processor resource exhaustion (DoS) Coraza v3.8.1 (coraza-caddy v2.6.2)
GHSA-g4qm-m288-5cp9 (CVE-2026-107835) Coraza cookie parser confusion via untrimmed ASCII control characters Coraza v3.8.1 (coraza-caddy v2.6.2)

Resolved in Caddy 2.11.7 (2026-10-05) — upgrading the Caddy base image to v2.11.7 resolved GHSA-6365-7ppr-5r92:

Advisory Component (before) Fixed in
GHSA-6365-7ppr-5r92 Caddy forward_auth + reverse_proxy Caddy 2.11.6+ (#7859)

Resolved in coraza-caddy v2.6.1 (2026-09-21) — upgrading CORAZA_CADDY_REF to v2.6.1 lifted google.golang.org/grpc to v1.83.2, completely resolving both findings in the compiled binary without requiring .trivyignore suppressions:

Advisory Component (before) Fixed by
CVE-2026-84304 google.golang.org/grpc v1.82.1 (embedded in Caddy binary) grpc v1.83.2 (coraza-caddy v2.6.1)
CVE-2026-84445 google.golang.org/grpc v1.82.1 (embedded in Caddy binary) grpc v1.83.2 (coraza-caddy v2.6.1)

Resolved in v3.5.2 (2026-09-09) — the coraza-caddy v2.6.0 rebuild lifted the affected Go dependencies, so Trivy no longer reports these findings; their .trivyignore suppressions and rows below were removed:

Advisory Component (before) Fixed by
CVE-2026-56852 golang.org/x/text v0.37.0 (embedded in Caddy binary) x/text v0.39.0 (rebuilt binary)
GHSA-hrxh-6v49-42gf google.golang.org/grpc v1.81.0 (embedded in Caddy binary) grpc v1.82.1 (coraza-caddy v2.6.0)
CVE-2026-46600 golang.org/x/net v0.55.0 (embedded in Caddy binary) x/net v0.56.0 (rebuilt binary)
CVE-2026-56854 golang.org/x/crypto v0.52.0 (embedded in Caddy binary) x/crypto v0.55.0 (rebuilt binary)

Timeline

Date Event
2026-02-09 Caddy 2.11.1 released - fixes CVE-2026-30851, CVE-2026-27590
2026-02-24 Caddy 2.11.2 released - fixes CVE-2026-27587
2026-05-12 Caddy 2.11.3 released - fixes CVE-2026-27588, CVE-2026-27586, CVE-2026-27585, CVE-2026-27589
2026-05-13 Caddy advisories published - CVE-2026-45135, CVE-2026-45692, GHSA-wwhq-w58m-w29c, GHSA-gx7w-56w6-g48x
2026-06-02 Caddy 2.11.4 released - fixes CVE-2026-52845, CVE-2026-52844
2026-06-23 CVE-2026-52845 and CVE-2026-52844 published to NVD
2026-06-23 CVE-2026-45692 and CVE-2026-52846 published to NVD
2026-07-01 caddy-waf v3.0.0 released with Caddy 2.11.4
2026-07-02 OWASP CRS v4.28.0 released (included)
2026-07-10 GHSA-6365-7ppr-5r92 and GHSA-j8px-rmrx-76h9 published
2026-08-11 caddy-waf v3.3.0 released - tool bumps (hadolint 2.15.1, go-ftw 2.5.0, Trivy v0.73.0), full apk upgrade, JSON-form HEALTHCHECK, version alignment
2026-08-11 caddy-waf v3.3.1 released - HEALTHCHECK via admin /metrics (curl), resource limits (mem 512m, 1 CPU), JSON-file log rotation (50m × 5)
2026-08-14 caddy-waf v3.3.2 released - WAF active by default (DetectionOnly), dual-arch scanning, bare-boot regression gate (make test-boot), systemd Caddyfile variant tracked
2026-08-24 caddy-waf v3.4.0 released - OWASP CRS 4.29.0 (anti-evasion 932 + FP fixes), Trivy v0.74.0, integration suite 20 cases (OWASP Top 10 2025)
2026-09-09 caddy-waf v3.5.2 released - coraza-caddy v2.6.0 (WebSocket+WAF fixes, grpc v1.82.1), digest-pinned Caddy base, CI/CD hardening (SHA256-verified tools, least-privilege workflow); v3.5.0/v3.5.1 tags burned before publishing
2026-09-21 caddy-waf v3.5.4 released - coraza-caddy v2.6.1 (flush/hijack fixes, grpc v1.83.2 resolves CVE-2026-84304 and CVE-2026-84445, empty .trivyignore)
2026-10-02 Coraza v3.8.1 released - fixes GHSA-6gcq-wc29-5xf2, GHSA-6r3q-mjv7-xr8m, GHSA-5gj4-9gm7-2fx2, GHSA-w253-m66g-rx24, GHSA-3wr7-993q-jrff, GHSA-g4qm-m288-5cp9
2026-10-03 Caddy 2.11.6 released - fixes GHSA-6365-7ppr-5r92
2026-10-05 Caddy 2.11.7 released - fixes HTTP/2 reverse_proxy panic and stream drop regressions
2026-10-05 OWASP CRS v4.30.0 released
2026-10-05 caddy-waf v3.6.0 released - Caddy 2.11.7, OWASP CRS v4.30.0, coraza-caddy v2.6.1, active rate limiting, CSP baseline
2026-10-10 coraza-caddy v2.6.2 released and integrated into caddy-waf (Coraza v3.8.1)
2026-10-11 caddy-waf v3.6.1 released - coraza-caddy v2.6.2 (Coraza v3.8.1 resolves 6 GHSAs), Go 1.27.2 toolchain, test-security gate
2026-10-28 Routine tooling & toolchain upgrade - Go 1.27.3, Trivy v0.76.1, go-ftw v2.6.2; mitigated CVE-2026-116587 (go-jose/v4 to v4.1.6, suppressed unpatched v3)
2026-11-04 caddy-waf v3.6.3 released - Upgraded go-jose/v4 to v4.1.8 (mitigating 5 upstream security advisories)
2026-11-07 caddy-waf v3.6.4 released - Upgraded golang.org/x/net to v0.62.0 (mitigating CVE-2026-78661)

References

There aren't any published security advisories