GitHub Advisoryadvisory · npm
GHSA-928r-fm4v-mvrw TechDocs Mkdocs Configuration Key Enables Arbitrary Code Execution
HIGH
Official page ↗
- Aliases
- CVE-2026-29186
- Ecosystem
- npm
- Packages
- @backstage/plugin-techdocs-node
- Severity
- High
- CVSS vector
- CVSS:3.1/AV:N/AC:H/PR:L/UI:N/S:C/C:H/I:L/A:L
- Weaknesses
- CWE-434, CWE-74
- Reviewed
- 2026-03-05
Affected packages
• npm @backstage/plugin-techdocs-node: < 1.14.3 → fixed in 1.14.3
Description
Impact
This is a configuration bypass vulnerability that enables arbitrary code execution. The `@backstage/plugin-techdocs-node` package uses an allowlist to filter dangerous MkDocs configuration keys during the documentation build process.
A gap in this allowlist allows attackers to craft an `mkdocs.yml` that causes arbitrary Python code execution, completely bypassing TechDocs' security controls.
Patches
Patched in `@backstage/plugin-techdocs-node` version 1.14.3
Workarounds
If users cannot upgrade immediately:
1. Use Docker mode with restricted access: Configure TechDocs with `runIn: docker` instead of `runIn: local`. This provides container isolation, though it does not fully mitigate the risk.
2. Restrict repository access: Limit who can modify `mkdocs.yml` files in repositories that TechDocs processes. Only allow trusted contributors.
3. Manual review: Implement PR review requirements for changes to `mkdocs.yml` files to detect malicious hooks configurations before they are merged.
4. Downgrade MkDocs: Use MkDocs < 1.4.0 (e.g., 1.3.1) which does not support hooks. Note: This may limit access to newer MkDocs features.
Note: Building documentation in CI/CD pipelines using `@techdocs/cli` does not mitigate this vulnerability, as the CLI uses the same vulnerable `@backstage/plugin-techdocs-node` package.
Resources
MkDocs Hooks Documentation
MkDocs 1.4 Release Notes
TechDocs Architecture
Related
Alias · CVE (1)
- CVE-2026-29186 Backstage is an open framework for building developer portals. vulnerability
References
- https://github.com/backstage/backstage/security/advisories/GHSA-928r-fm4v-mvrw web
- https://nvd.nist.gov/vuln/detail/CVE-2026-29186 advisory
- https://backstage.io/docs/features/techdocs/architecture web
- https://github.com/backstage/backstage package
- https://www.mkdocs.org/about/release-notes/#version-14-2022-09-27 web
- https://www.mkdocs.org/user-guide/configuration/#hooks web