Brewdocs is an educational security lab. It contains a deliberate
path traversal (CWE-22) vulnerability: the article endpoint confines reads with
a start-of-path check — it requires the requested document to begin with the
articles/ section — but it never normalises the path. A value such as
articles/../../flag.txt starts with articles/ (so the check passes) yet the
embedded ../../ escapes the knowledge-base directory. Please do not report
the intended path traversal flaw as a security issue — it is the entire point of
the project and is documented in the README and SOLUTION.md.
If you find a problem that is not the intended lab vulnerability — for example, a supply-chain issue, a problem in the CI/CD configuration, or a way the container could harm the host — please open a private report via GitHub Security Advisories, or open an issue describing the concern.
- Run this only on systems you own, locally, isolated (Docker is recommended).
- Never expose this application to the public internet.
- Never use the techniques demonstrated here against systems without explicit, written authorization.