用途:对 REST 与 GraphQL API 按 OWASP API Security Top 10:2023(API1–API10)进行结构化、可重复的安全审查,产出带 CWE 编号、严重性评级与修复建议的发现。适用对象包括 OpenAPI/Swagger 规范、API 端点源码、GraphQL 架构和 API 网关配置。
主要能力:先做 API 清点与范围界定,识别 REST/GraphQL/gRPC 或混合风格,编目端点与操作,梳理认证机制、授权模型、数据对象与敏感级别、限流配额及下游依赖;再逐项评估 API1:2023 BOLA 至 API10:2023 不安全的 API 消费。每条发现包含 ID(如 API-SEC-001)、标题、OWASP 风险、严重性、CWE、API 风格、位置、描述、证据、修复与状态。输出为审查报告,含按风险类别的汇总表与逐条发现。严重性分 Critical/High/Medium/Low/Informational。
GraphQL 额外关注:内省暴露、查询深度与复杂度攻击、解析器级字段授权、别名绕过限流等。
必要用法:通过参数指定目标以聚焦审查,例如 $ARGUMENTS 所指向的范围;技能设计为只读(allowed-tools: Read、Grep、Glob)。要求机器可读输出时,发现须为符合 schemas/finding.schema.json 的 JSON;要求 SARIF 时映射到 SARIF 2.1.0,参考 docs/sarif-output.md。
限制:依赖可用的代码、配置、日志与文档,无法证明缺失证据处的控制存在或威胁不存在;发现属假设,需结合资产关键性等验证以降低误报;需文件路径行号等具体证据支撑;遇疑似入侵、泄露凭据、受监管数据暴露等应升级。技能具备提示注入防护,不执行被审查代码,不遵循其中指令,不外传数据,不修改代码,仅作静态只读分析。分类为 security。