CVE-2026-29186: TechDocs Mkdocs Configuration Key Enables Arbitrary Code Execution
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.
Published Mar 5, 2026 · Updated Mar 9, 2026
Affected packages
@backstage/plugin-techdocs-node
- Ecosystem
- npm
- Affected
- <= 1.14.2
- Fixed in
- 1.14.3
- Check
npm ls @backstage/plugin-techdocs-node
Advisory details
From the GitHub Advisory Database (CC BY 4.0).
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:
- Use Docker mode with restricted access: Configure TechDocs with
runIn: dockerinstead ofrunIn: local. This provides container isolation, though it does not fully mitigate the risk. - Restrict repository access: Limit who can modify
mkdocs.ymlfiles in repositories that TechDocs processes. Only allow trusted contributors. - Manual review: Implement PR review requirements for changes to
mkdocs.ymlfiles to detect malicious hooks configurations before they are merged. - 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
References
- https://github.com/backstage/backstage/security/advisories/GHSA-928r-fm4v-mvrw
- https://backstage.io/docs/features/techdocs/architecture
- https://www.mkdocs.org/about/release-notes/#version-14-2022-09-27
- https://www.mkdocs.org/user-guide/configuration/#hooks
- https://nvd.nist.gov/vuln/detail/CVE-2026-29186
- https://github.com/advisories/GHSA-928r-fm4v-mvrw
How this page is made: the data panel comes from the GitHub Advisory Database, CISA’s KEV catalog, the NVD and FIRST EPSS, and updates twice a day. No analysis has been written for this entry yet. Methodology
More npm vulnerabilities
All npm entriesCVE-2026-106455
Backstage: Improper validation of MkDocs plugin configuration in TechDocs
high7.7Oct 7, 2026CVE-2026-106505
Backstage: Bypass of MkDocs configuration sanitizer in TechDocs backend
high7.7Oct 7, 2026CVE-2026-106508
Backstage has potential file exposure through local TechDocs publisher
medium5.3Oct 7, 2026CVE-2026-106509
Backstage: Improper validation of MkDocs theme configuration in TechDocs
high7.7Oct 7, 2026CVE-2026-106510
Backstage: Remote code execution via crafted markdown_extensions in TechDocs mkdocs.yml
high7.7Oct 7, 2026CVE-2026-106557
Backstage has improper input validation in TechDocs Markdown extension configuration
high7.7Oct 7, 2026
