Skip to content

AAK-MARKETPLACE-002: Plugin permission set grants broad access

Severity
MEDIUM
Category
Supply Chain (supply-chain)
Scanner
agent_audit_kit/scanners/marketplace_manifest.py
Auto-fixable
No.
SARIF name
MarketplaceBroadPermissions

What it detects

A plugin's manifest grants access to filesystem, network, shell exec, or user-credential surfaces. Broad permissions should be opt-in after a clear user prompt.

How to fix

Trim permissions to the minimum the plugin needs. Review any 'fs:*' or 'shell:exec' entries.

To confirm the finding is gone, report only this rule:

agent-audit-kit scan . --rules AAK-MARKETPLACE-002

Limitations

Reads the permissions of each plugin entry in a marketplace.json, as a list of scope:action strings, one such string, or an object from scope to an action, a list of actions or true (every action), and reports a grant that covers fs:*, shell:exec, network:*, credentials:*, env:* or *:*: case is ignored, a * on either side stands for every scope or action, and a bare * is *:*. A narrower grant on one of those scopes (fs:write, credentials:read), a grant that covers none of the six (*:read reads every scope but is not one), a string with no colon (network), and permissions declared in a plugin's own .claude-plugin/plugin.json are not reported. A marketplace.json over 1 MB is not read, and AAK-MARKETPLACE-005 reports it as unreadable.

References


All rules. This page is generated from the rule registry when the documentation is built; to change it, change the rule in agent_audit_kit/rules/builtin.py. To give the rule a hand-written write-up, add docs/rules/AAK-MARKETPLACE-002.md: the page then shows that text, with the registry reference appended under it.