This policy covers vulnerabilities in this project's own code — the helper scripts,
install.sh / install_tools.sh, templates, and tooling shipped in this repository.
It does not cover third-party systems you test with the toolkit. Findings against
external targets belong to that target's owner and their disclosure process, governed by
your engagement authorization and TERMS.md — do not report those here.
If you find a security issue in this repository's code (e.g. a command-injection bug in a
helper script, an unsafe default in install.sh, a scope-guard bypass in
scope_guard.py, or a credential-handling flaw):
- Do not open a public issue for it.
- Report privately via GitHub Security Advisories ("Report a vulnerability" on the repo's Security tab), or contact the maintainer listed in the repository profile.
- Include: affected file/version, impact, and minimal reproduction steps.
We aim to acknowledge reports within a few days and to fix confirmed issues promptly. Coordinated disclosure is appreciated — please give us a reasonable window before any public write-up.
Because this is offensive tooling, bugs that weaken a safety control are treated as high severity, for example:
- a
scope_guard.pymatching flaw that lets an out-of-scope host be classified in-scope, - a
validate_findings.pybug that passes an ungrounded/false-positive finding, - a
safe_subprocess.pyflaw that lets a shell string through, leaks the parent environment to a child, or runs git against an untrusted repo without the hook/prompt/config hardening, - credential leakage from
http_creds.pyor any script logging a secret in clear text.
Please flag these explicitly so we can prioritize them.
- Vulnerabilities in third-party tools the framework invokes (nmap, ffuf, impacket, etc.) — report those upstream.
- Findings produced by using the framework against your engagement targets.