overprivileged_agent_toolCWE-250 OWASP ASI03
Overprivileged Agent Tool — a PullGuard finding type. Findings of this type appear in the PR comment, Step Summary, SARIF (GitHub Security tab / IDE viewers), and the HTML report, each with severity, location, and the remediation guidance below.
# Before (VULNERABLE): the model-chosen arg goes straight to the shell
@tool
def run_command(cmd: str) -> str:
return os.popen(cmd).read()
# After (SAFE): fixed allow-list — the model can only pick, not compose
ALLOWED = {"status": ["git", "status"], "log": ["git", "log", "-5"]}
@tool
def run_command(action: str) -> str:
argv = ALLOWED.get(action)
if argv is None:
raise ValueError(f"unknown action: {action}")
return subprocess.run(argv, capture_output=True, text=True).stdout Suppress a confirmed non-issue with a committed .pullguardignore
entry (pullguard ignore locally, or comment
/pullguard ignore <fingerprint> <reason> on the PR — the
fingerprint is printed in the PR comment’s Triage section). Entries support
expiresAt for time-boxed snoozes.
Security findings at major or critical severity — and any critical finding —
always surface: .pullguardignore cannot hide them. The reviewed
paths that keep them visible are acknowledged (reviewed, stays in reports)
and, for a confirmed false positive, a reasoned false_positive entry —
visible and audited, excluded only from the merge block.