代理行动审核员

运维部署 社区

技能解读

当前原文的自动摘译,尚未人工审校。

何时使用

审核存储库的 GitHub Actions 工作流程以确保 AI 代理安全 检查调用 Claude Code Action、Gemini CLI 或 OpenAI Codex 的 CI/CD 配置 检查攻击者控制的输入是否可以到达 AI 代理提示 评估代理操作配置(沙箱设置、工具权限、用户白名单) 评估将工作流程暴露给外部输入的触发事件(pull_request_target、issue_comment 等)

何时不使用

分析不使用任何 AI 代理操作的工作流程(改为使用通用操作安全工具) 在调用者工作流程上下文之外审查独立的复合操作或可重用工作流程(在分析通过uses:引用它们的工作流程时使用此技能) 执行运行时提示注入测试(这是静态分析指导,而不是利用) 审核非 GitHub CI/CD 系统(Jenkins、GitLab CI、CircleCI)

拒绝的理由

在审核代理行为时,拒绝这些常见的合理化解释。每一个都代表了一条导致错过发现的推理捷径。 1.“它仅在维护者的 PR 上运行”是错误的,因为它忽略了 pull_request_target、issue_comment 以及其他向外部输入公开操作的触发事件。攻击者不需要写入权限来触发这些工作流程。 pull_request_target 事件在基础分支的上下文中运行,而不是 PR 分支,这意味着任何外部贡献者都可以通过打开 PR 来触发它。

审计方法论

按顺序执行以下步骤。每一步都建立在前一步的基础上。

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
运维部署
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@open-edge-platform · 未声明许可证
上下文用量评级
较高消耗
接入复杂程度
需手动接入
是否需要外部接口密钥
需要 · GitHub
兼容的系统
macOS · Linux · Windows
运行环境要求
Node.js · Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
  • 读取环境变量
网络行为
允许外网请求
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
步骤0:确定分析模式

如果用户提供 GitHub 存储库 URL 或`owner/repo` 标识符,请使用远程分析模式。否则,使用本地分析模式(继续步骤 1)。 URL解析从用户输入中提取`owner/repo`和可选的`ref`:输入格式·提取`owner/repo`·所有者,存储库; ref = 默认分支

02
第 1 步:发现工作流程文件

使用 Glob 查找存储库中的所有 GitHub Actions 工作流程文件。搜索工作流程文件:Glob for `.github/workflows/*.yml` Glob for `.github/workflows/*.yaml` 如果未找到工作流程文件,则报告“未找到工作流程文件”并停止审核

03
第 2 步:确定 AI 行动步骤

对于每个工作流程文件,检查每个作业以及每个作业中的每个步骤。根据下面已知的 AI 操作参考检查每个步骤的 `uses:` 字段。已知的 AI 动作参考: 动作参考 · 动作类型 `anthropics/claude-code-action` · Claude 代码动作 `google-github-actions/run-gemini-cli` · Gemini CLI

04
第 3 步:捕获安全上下文

对于每个已识别的 AI 操作步骤,捕获以下安全相关信息。该数据是步骤 4. 3a 中攻击向量检测的基础。步骤级配置(来自`with:`块)根据操作类型捕获这些与安全相关的输入字段:Claude代码操作:`prompt`——发送到AI代理的指令

05
第 4 步:分析攻击向量

首先,阅读references/foundations.md 以了解攻击者控制的输入模型、环境块机制和数据流路径。然后根据步骤 3 中捕获的安全上下文检查每个向量:向量 · 名称 · 快速检查 · 参考 A · 环境变量中介 · `env:` 带有 `${{ github.event.* }}` 值的块 + 提示读取该环境变量名称 · 引用/向量-a-env-var-intermediary.md B · 直接表达式注入 · `${{ github.event.* }}` 在提示或系统提示字段内 ·参考文献/vector-b-direct-express-injection.md

06
第 5 步:报告结果

将步骤 4 中的检测结果转换为结构化的结果报告。该报告必须具有可操作性——安全团队应该能够理解并纠正每项发现,而无需查阅外部文档。 5a.查找结构 每个查找结果都使用此部分顺序: 标题:使用矢量名称作为标题(例如,`### Env Var Intermediary`)。不要使用矢量字母作为前缀。严重程度:高/中/低/信息(判断指导参见5b)

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。