AI 代理的访问控制。设定 Claude Code、Codex、Gemini、Cursor 以及任何 MCP 服务器被允许执行的操作,在风险操作运行前进行审查,并记录每一项操作。
面向 AI 代理的访问控制
你的 AI 代理可以访问 Slack、GitHub、电子邮件和你的数据库。
node9 决定它们可以对每一项做什么。
凭据隔离 · 机密与 PII · 破坏性 git、SQL 和 shell 操作被拦截待审 · MCP 工具固定 · 网络出口允许列表 · 循环中断器 · 跨十二个代理的统一记录
适用于 Claude Code · Codex CLI · Antigravity (agy) · GitHub Copilot CLI · Gemini CLI · Cursor · Windsurf · VSCode · Claude Desktop · Opencode · Pi · Hermes Agent · 任何 MCP 服务器。
| 查看 | 在每次拉取请求时扫描仓库,或检查本机。无需安装任何东西。 | 扫描每次拉取请求 |
| 防护 | 将 node9 置于代理发起的每次工具调用之前:允许、阻止或为你拦截待审。 | 防护你的代理 |
| 证明 | 为团队运行的每个代理和每台机器生成一份 OWASP Agentic Top 10 报告。 | 向团队证明 |
本仓库同时也是 GitHub Action node9 Agent Security。 它读取提交到仓库中的代理配置(工作流、代理设置、MCP 服务器、指令文件),并报告拉取请求可能对你造成哪些不利影响。不会运行任何内容,不会安装任何代理,也无需账户和密钥:作业令牌就足够了。
添加一个文件,.github/workflows/agent-security.yml:
name: node9 agent-security
on: pull_request
permissions:
contents: read
pull-requests: write
checks: write
jobs:
scan:
runs-on: ubuntu-latest
steps:
- uses: node9-ai/node9-proxy@v2
with:
fail-on: high # never | medium | high | critical
fail-on-scope: introduced # judge only what this PR added or made worse
每个拉取请求随后会得到:
| 陌生人可操控的工作流 | 将 issue 或拉取请求的文本交给持有密钥或可执行命令的 agent 的工作流,或在 fork 的代码中运行该 agent 的工作流 |
| Agent 设置 | 覆盖凭据或任意命令的允许规则、获取远程代码的钩子、误提交的本地设置 |
| MCP 服务器与插件 | 安装最新版本的服务器、写入配置中的凭据 |
| 可触及的密钥 | 工作流中的 agent 可读取的密钥,以及它可能泄露这些密钥的方式 |
| 指令文件与技能 | 隐藏字符、指示 agent 放弃其指令、获取并服从某个页面或向外发送数据的文本 |
在任何人可提交 agent 会读取的 issue 的仓库中,评论如下:
🛡️ node9 agent-security · 🔴 高危:需要采取行动
任何人都能让此仓库的 AI agent 以其权限行事
陌生人提交了一个包含给 agent 指令的 issue。agent 会以此 仓库的权限遵循这些指令。
我们在
.github/workflows/triage.yml:13中看到:
- 任何人都能启动该 agent(
allowed_non_write_users: "*")。- 它会读取拉取请求或 issue 的文本。
- 它可以运行任意命令(
Bash)。✅ 如何修复:
- 仅允许具有写权限的人启动它:移除
allowed_non_write_users: "*"。- 仅向 agent 提供该任务所需的工具。
还发现:
- 🟡 MCP 服务器
files每次都会安装最新版本(.mcp.json)
| 输入 | 默认值 | |
|---|---|---|
fail-on | never | 导致检查失败的严重级别:never 表示仅评论而不设门禁,medium、high 或 critical。 |
fail-on-scope | all | introduced 仅评判拉取请求新增或加剧的问题,因此已有发现的仓库可以立即启用门禁。 |
comment | true | 在拉取请求上发布评论。 |
annotate | true | 在差异上标注发现的问题。 |
node9-version | latest | 执行扫描的 node9-ai 版本。固定该版本以获得可复现的运行结果。 |
node9-upload-key | 空 | 可选。将每次推送扫描发送到你的 node9 工作区,从而按仓库保留历史记录。留空则不发送任何内容。 |
telemetry | true | 每次运行的匿名使用计数:扫描器版本、操作系统、最严重级别、扫描是否完成,以及仓库数字 ID 的哈希值(node9 仅在计数内部保留该哈希)。绝不包含仓库名称、路径、发现的问题或任何代码。 |
在 pull_request_target 下,该 Action 不会执行扫描,并会明确说明这一点:因为在该事件下它读取的是基础分支,而非拉取请求。完整参考见
仓库扫描文档。
无需工作流、无需安装、无需账户。scan-repo 会发送与该 Action 相同的匿名使用计数(不含仓库名称、不含代码);设置 NODE9_NO_TELEMETRY=1 可将其关闭。
npx node9-ai scan-repo owner/repo # the same scan as the Action, on any public repository
npx node9-ai posture # scores this machine 0-100: what a compromised agent could read, reach and run
npx node9-ai scan # every past agent session on this machine
node9.ai/scan 上的托管扫描会在浏览器中完成第一项检查。
node9 scan scorecard