SuperAPI AI 工具集

agentic-actions-auditor

安全与审计

查看项目

更新于 10-16 23:14

技能介绍

用途

agentic-actions-auditor 是一项针对调用 AI 编码智能体的 GitHub Actions 工作流的静态安全分析技能。它用于审计仓库的 GitHub Actions 工作流中 AI 智能体的安全性,审查调用 Claude Code Action、Gemini CLI 或 OpenAI Codex 的 CI/CD 配置,检查攻击者可控输入是否能到达 AI 智能体提示,评估智能体操作配置(沙箱设置、工具权限、用户允许列表),评估暴露工作流于外部输入的触发事件,以及调查从 GitHub 事件上下文经过 env: 块到 AI 提示字段的数据流。

主要能力

该技能可以:

  • 在本地或从远程 GitHub 仓库发现工作流文件;
  • 识别 AI 操作步骤,通过匹配已知 AI 操作引用(anthropics/claude-code-action、google-github-actions/run-gemini-cli、google-gemini/gemini-cli-action、openai/codex-action、actions/ai-inference);
  • 跟随跨文件引用,解析复合操作和可复用工作流,发现其中可能隐藏的 AI 智能体(仅解析一层深度);
  • 捕获与安全相关的配置,包括步骤级的 with: 输入字段和整个工作流的触发事件、环境变量与权限;
  • 检测九类攻击向量:Env Var Intermediary、Direct Expression Injection、CLI Data Fetch、PR Target + Checkout、Error Log Injection、Subshell Expansion、Eval of AI Output、Dangerous Sandbox Configs、Wildcard Allowlists;
  • 生成结构化的发现报告,包含标题、严重性、文件、步骤、影响和证据。

使用方式

用户可以提供 GitHub 仓库 URL 或 owner/repo 标识符以进行远程分析,否则使用本地分析模式。远程分析使用 gh api 列出并获取 .github/workflows 目录下的 YAML 文件;本地分析使用 Glob 定位工作流文件。随后按顺序执行:发现工作流文件、识别 AI 操作步骤、捕获安全上下文、分析攻击向量、报告发现。跨文件解析、输入映射、远程获取等完整解析流程记录在 references/cross-file-resolution.md 中。

适用场景

  • 审计仓库的 GitHub Actions 工作流中的 AI 智能体安全;
  • 审查调用 AI 编码智能体的 CI/CD 配置;
  • 检查攻击者可控输入是否能到达 AI 智能体提示;
  • 评估智能体操作配置(沙箱设置、工具权限、用户允许列表);
  • 评估将工作流暴露于外部输入的触发事件(pull_request_target、issue_comment 等);
  • 调查从 GitHub 事件上下文经过 env: 块到 AI 提示字段的数据流。

限制

该技能不适用于:分析不使用任何 AI 智能体操作的工作流(应使用通用 Actions 安全工具);在调用方工作流上下文之外审查独立的复合操作或可复用工作流;执行运行时提示注入测试(本技能是静态分析指引,不是利用);审计非 GitHub 的 CI/CD 系统(Jenkins、GitLab CI、CircleCI);自动修复或修改工作流文件(本技能仅报告发现,不修改文件)。

关于参考文献

该技能引用上游文档的特定修订版本,归属 Trail of Bits,许可证为 CC-BY-SA-4.0。技能的详细攻击向量检测依赖 references/ 目录下的多个文件,包括 foundations.md 以及各向量的说明文件。

暂未提供的信息

关于该技能的具体收费、价格、平台支持范围、运行性能指标或效果评估等事实,现有资料暂未提供。

引用文档

以下为作者声明的引用来源,保留指定版本、署名和许可。

作者的来源声明