SuperAPI AI 工具集

agentic-security-scanner

安全与审计

查看项目

更新于 10-15 15:45

技能介绍

用途

agentic-security-scanner 是构建在 AI 驱动开发工作流之上的安全扫描器,来自 ara.so 的 Security Skills 合集。其目标是把安全扫描融入智能体式(agentic)开发流程,用通俗语言给出漏洞发现、损失预估与自动修复能力,并覆盖 8 种语言。

主要能力

  • 12 类安全扫描:SAST、SCA、密钥(secrets)、IaC、LLM 安全、MCP 智能体工具审计、认证/授权、流水线完整性、容器、部署配置、供应链与趋势追踪。
  • 通俗英文发现结果:不使用 CVE 术语,展示风险后果(stakes)、预估损失金额与具体修复方式。
  • 带预览的自动修复:单命令修复,具备备份与回滚能力。
  • 合规报告:支持 NIST AI 600-1、OWASP ASVS、OWASP LLM Top 10、EU AI Act。
  • 优先级排序:基于 CISA KEV + EPSS,聚焦正在被实际利用的漏洞。
  • 函数级可达性:判断依赖漏洞是否真正影响你的代码。
  • 实时保镖(bodyguard):在磁盘写入前拦截不安全的 AI 生成代码。

使用方式

以 Claude Code 插件安装:

/plugin marketplace add https://github.com/Clear-Capabilities/agentic-security /plugin install agentic-security@clearcapabilities

随后重启 Claude Code 或运行 /reload-plugins。也可作为 CLI 工具使用:

npx @clear-capabilities/agentic-security-scanner secure .

更新插件:

/plugin marketplace update clearcapabilities /plugin install agentic-security@clearcapabilities

核心命令包括路由命令 /agentic-security:secure(可加 --tour、--help、--daily)、扫描命令 /agentic-security:scan(支持 --mode diff、watch、baseline、archaeology,以及 --since-baseline)、分诊命令 /agentic-security:triage(支持 show、explain、validate、red-team、query 模式)、修复命令 /agentic-security:fix(支持按 id、按严重级别、--all、--mode pr、--mode rotate-secret、--mode vault、--mode harden)、一键命令 /agentic-security:find-and-fix-everything。合规与报告使用 /agentic-security:compliance(--report nist/asvs/llm/eu-ai-act,或 --walkthrough)。姿态查看使用 /agentic-security:posture(status、report-card、trend、threat)。供应链使用 /agentic-security:supply(check、sbom、cve-alerts、license)。

安装 Git 钩子(保镖模式):/agentic-security:setup --mode hooks,可拦截通过字符串拼接的 SQL 注入、硬编码 API 密钥与密钥、对用户输入使用 eval()、命令注入模式与弱加密用法。CI/CD 集成:/agentic-security:setup --mode ci。破坏性操作防护:/agentic-security:setup --mode destructive-guard。

配置通过项目根目录的 .agentic-security/config.json 完成,可设置 exclude 列表、severity_threshold、enable_flow_analysis、enable_reachability、修复相关的 auto_backup/preview_before_apply/create_pr、合规框架列表与自定义控制项、bodyguard 开关与 block_on_critical/allow_override、以及 Slack 通知等。环境变量包括 SLACK_WEBHOOK_URL、STRIPE_API_KEY、AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、GITHUB_TOKEN 等。

典型场景

  • 首次扫描既有项目:先用 --mode baseline 建立基线,查看严重问题,再逐一修复。
  • 修复硬编码密钥:命令可轮换密钥、在 .env.example 中加入占位符、并在已配置时更新 CI/CD 密钥。
  • 修复 SQL 注入:将字符串拼接查询改为参数化查询。
  • Webhook 签名校验:为未校验签名的 webhook 增加签名验证。
  • CI 预部署检查:在 GitHub Actions 中以 diff 模式扫描,并对严重问题失败阻断。
  • 每日安全巡检:以 --daily 运行并用 curl 推送报告到 Slack。
  • 依赖漏洞检查:结合可达性筛选真正有影响的漏洞,生成 SPDX 格式 SBOM。

常见模式与排障

  • 遗留代码库接入:先设基线,只对新增严重问题失败,逐步降低基线。
  • 提交前审查:扫描暂存改动,自动修复安全项,严重问题阻止提交。
  • 合规审计准备:生成各框架报告与证据走查文档。
  • 误报偏高:启用 flow analysis、用 validate 模式确认、在 .agentic-security/suppressions.json 中抑制。
  • 漏报:使用 archaeology 深度扫描或 AI 辅助重扫。
  • 修复错误:--revert 回滚,备份位于 .agentic-security/backups/。
  • 大仓库性能:排除构建产物、仅扫描改动文件、关闭可达性分析。
  • 保镖误拦有效代码:可临时禁用或在配置中允许覆盖。

集成与许可

可导出 SARIF 供 GitHub Code Scanning 使用,也可导入 DefectDojo。跨仓库分析与风险金额估算通过 /agentic-security:labs 的 cross-repo、risk-dollars 模式进行。许可证为 PolyForm Internal Use(用于保护自有代码,不得转售)。

限制

资料未提供价格与收费信息,也未明确说明除上述 8 种语言外各语言的具体覆盖清单、各命令在不同平台上的行为差异,以及各预估损失金额的计算依据与准确性边界,这些暂未提供。