SwaggerFuzzer
🌐 一款自动化 OpenAPI/Swagger 接口未授权访问测试工具
在现代接口安全测试中，自动化检测未授权访问漏洞已成为不可或缺的流程。SwaggerFuzzer 受启发于常见安全测试流程中对 Swagger 自动化利用的需求，适合搭配 BurpSuite 使用。是一款专为渗透测试人员打造的轻量级命令行工具，支持对 OpenAPI 3.0 / Swagger 接口文档进行解析、测试并生成详细报告，快速定位安全隐患。
🚀 工具介绍：SwaggerFuzzer
SwaggerFuzzer 是一个支持本地与远程 OpenAPI/Swagger 文档解析的自动化接口扫描工具，具备参数提取、模拟请求、响应记录、权限校验等功能，适用于 API 安全测试、渗透测试前的预审查等场景。
✨ 核心功能亮点
- 🔍 自动解析 OpenAPI 3.0/3.1 JSON 文档（支持远程和本地文件）
- 🧪 构造所有 API 请求，包括 Path、Query、Header、Body 各种参数
- ⚡ 支持多线程并发测试接口，提升 fuzz 速度
- 📄 自动根据 content-type 构造 JSON、表单、XML、文件上传、ZIP、PDF 等请求体
- 🕵️ 检测敏感响应（如状态码 200、5XX、422、400）
- 🖨️ 控制台彩色输出简洁摘要（带状态码高亮）
- 📦 CSV 文件保存接口调用结果，支持后续分析
- 🔌 支持代理抓包（例如通过 BurpSuite 拦截）
- 🔐 可添加自定义请求头（如 Authorization）
🚀 快速使用
python main.py -u http://example.com -f swagger.json
或者只使用远程地址：
python main.py -u http://example.com/swagger/v1/swagger.json
🧰 支持参数
| 参数 | 说明 | 示例 |
|---|---|---|
-u, --url |
必填，base URL 或完整 OpenAPI JSON 地址 | http://target.com |
-f, --file |
可选，OpenAPI JSON 本地路径或相对路径 | ./swagger.json |
-p, --proxy |
设置代理 | http://127.0.0.1:8080 |
-t, --threads |
多线程数量（默认1） | -t 5 |
-o, --output |
输出文件格式（当前仅支持 csv） | -o csv |
-d, --delay |
每个请求间隔秒数 | -d 0.5 |
--header |
自定义请求头（可重复） | --header="Authorization: Bearer xxx" |
📌 项目结构
.
├── SwaggerFuzzer.py # 主程序逻辑（加载 spec、构造请求、发送与记录）
├── util.py # 工具函数（header 解析、URL 拼接、加载 Swagger 文档）
├── requirements.txt # 依赖库
├── README.md # 使用说明
📥 获取与下载
工具开源于 GitHub，可访问以下地址获取源码与使用说明：
👉 GitHub 仓库地址：https://github.com/Secur1ty0/SwaggerFuzzer
欢迎 Star、Fork 并提交 issue 参与完善！