Repository navigation
Vulnerator AI 1.3.0
What's new
Opt-in scope-guard for kali_run / kali_exec. A deterministic (code, not prompt) layer that validates the DESTINATION of each raw-shell action before executing it. It lives inside the Kali MCP, in front of the two raw-shell runners; it does not touch the cloud tools (Prowler/Pacu/IAM) or the browser MCP.
How it works
- Opt-in. With no
scope.jsonpresent (path viaSCOPE_FILE, default/scope/scope.json), behavior is identical to before — no gate. The guard activates only when the file exists and containsenabled: true. - Fail-closed when active. Hermes must declare the new optional
targetsargument (the IP/host/URL the command touches). Any destination outside the allowed scope — or indeny— blocks the whole execution with a structuredSCOPE_VIOLATIONerror without running. Iftargetsis not declared while the scope is active, the call is blocked. - Validation. IP-against-CIDR plus literal hostname match (no DNS) with optional ports;
denytakes priority overallow. A best-effort parse of the command is an extra belt that can only block, never approve. - Auditable. Each violation is logged into the engagement findings store as a
discardedSCOPE_VIOLATIONrecord. - Kill-switch.
SCOPE_ENFORCE=0force-disables the guard even if the file saysenabled: true.
Zero new dependencies (stdlib json/ipaddress/urllib.parse). New scope.example.json template, a commented bind-mount in docker-compose.yml, and a README section document how to turn it on.
Default behavior (no scope.json) is unchanged.
Full Changelog: v1.2.0...v1.3.0