SuperAPI AI 工具集

attack-surface

编程与开发

查看项目

更新于 10-16 08:47

技能介绍

用途:对代码库做攻击面测绘,发现并清点外部数据进入应用的所有入口,生成按暴露程度和信任边界排序的目录,覆盖路由、API、输入处理器与外部接口,并支持输出为文本、JSON 或 Markdown。

主要能力:按旗标控制行为。--scope 默认 full,本技能建议全库可见;缩小的范围会产出不完整清单并给出警告。--depth quick 仅提取框架路由;standard 额外读取处理器以分类输入类型与认证要求;deep 继续追踪入口到内部 sinks 并映射信任边界穿越;expert 在此基础上按可利用性排序、识别影子/未文档化端点并做 DREAD 评分。--severity 不直接适用,仅用于过滤输出中的暴露排序。--format 默认 text,json 用于机器可读清单,md 用于 wiki 导出。

工作流:先确定范围并解析为文件列表,优先在路由文件、控制器目录、API 定义、中间件、OpenAPI/Swagger、GraphQL schema、gRPC proto、CLI 入口、WebSocket 处理器中查找;再识别框架与语言以确定路由注册模式(如 Express/Koa/Fastify、Django、Flask、Spring、Rails、Next.js/Nuxt、ASP.NET、Go net/http、FastAPI、gRPC、GraphQL);随后提取入口点,包括 HTTP 路由、API 端点、表单处理、文件上传、WebSocket、CLI 参数、消息队列消费者、定时任务、Webhook 接收、SSE;再对每个入口点分类认证、授权、输入类型、校验、限流、网络暴露与协议;按暴露等级排序:CRITICAL 为面向互联网、无认证、接受用户输入且接触敏感数据或系统资源;HIGH 为面向互联网且有认证但处理敏感数据,或未认证且输入校验有限;MEDIUM 为已认证且校验完善,或内部无认证端点;LOW 为内部已认证、输入面有限或对非敏感数据的只读操作。deep 与 expert 下追踪 HIGH/CRITICAL 入口到达的 sinks;expert 下寻找未受认证保护的调试/管理路由、动态注册路由、测试/预发配置中可能在生产生效的端点、已废弃但仍路由的 API 版本、未认证暴露的 Swagger UI。

输出:产出清单而非漏洞发现,但入口点明显缺少安全控制时以标准 schema 输出发现,ID 前缀为 SURF。输出含清单表与摘要(总入口数、面向互联网数、未认证数、内部数、各暴露等级数量)。仅依据公开资料,未提供具体安装命令、价格或平台信息。