官方公众号企业安全新浪微博
FreeBuf.COM网络安全行业门户，每日发布专业的安全资讯、技术剖析。
FreeBuf+小程序
swaggerHole：针对swaggerHub的公共API安全扫描工具
Alpha_h4ck- 关注
0
1
2
3
4
5
6
7
8
9
0
1
2
3
4
5
6
7
8
9
0
1
2
3
4
5
6
7
8
9
0
1
2
3
4
5
6
7
8
9
0
1
2
3
4
5
6
7
8
9
0
1
2
3
4
5
6
7
8
9
swaggerHole：针对swaggerHub的公共API安全扫描工具
关于swaggerHole
swaggerHole是一款针对swaggerHub的API安全扫描工具，该工具基于纯Python 3开发，可以帮助广大研究人员检索swaggerHub上公共API的相关敏感信息，整个任务过程均以自动化形式实现，且具备多线程特性和管道模式。
工具要求
Python 3
pip3
类Linux操作系统的安装命令如下：
sudo apt install python3
sudo apt install python3-pip
工具安装
pip安装
该项目目前已托管至PyPI，可以直接使用下列命令安装swaggerHole：
pip3 install swaggerhole
源码安装
除此之外，广大研究人员还可以直接使用下列命令将该项目源码克隆至本地：
git clone https://github.com/Liodeus/swaggerHole.git
然后切换到项目目录下，运行工具安装脚本即可：
cd swaggerHole pip3 install .
工具使用
下图所示为swaggerHole的工具帮助和参数选项：
使用命令样例：
swaggerhole [-h] [-s SEARCH] [-o OUT] [-t THREADS] [-j] [-q] [-du] [-de]
参数解析
-h, --help：显示工具帮助信息和退出； -s SEARCH, --search SEARCH：搜索语句； -o OUT, --out OUT：设置输出目录； -t THREADS, --threads THREADS：设置要使用的运行线程数量 (默认为25) -j, --json：使用JSON格式输出； -q, --quiet：静默模式，移除Banner； -du, --deactivate_url：不激活URL过滤功能（会增加假阳性）； -de, --deactivate_email：不激活email过滤功能（会增加假阳性）；
工具使用演示
搜索目标域名相关的API敏感信息
swaggerHole -s test.com echo test.com | swaggerHole
搜索目标域名相关的API敏感信息（输出JSON数据）
swaggerHole -s test.com --json echo test.com | swaggerHole --json
搜索目标域名相关的API敏感信息（速度提升）
swaggerHole -s test.com -t 100 echo test.com | swaggerHole -t 100
工具输出
常规输出
Finding_Type - Finding - [Swagger_Name][Date_Last_Update][Line:Number]
JSON输出
{"Finding_Type": Finding, "File": File_path, "Date": Date_Last_Update, "Line": Number}许可证协议
本项目的开发与发布遵循GPL-3.0开源许可协议。
项目地址
swaggerHole：【GitHub传送门】
参考资料
免责声明
1.一般免责声明：本文所提供的技术信息仅供参考，不构成任何专业建议。读者应根据自身情况谨慎使用且应遵守《中华人民共和国网络安全法》，作者及发布平台不对因使用本文信息而导致的任何直接或间接责任或损失负责。
2. 适用性声明：文中技术内容可能不适用于所有情况或系统，在实际应用前请充分测试和评估。若因使用不当造成的任何问题，相关方不承担责任。
3. 更新声明：技术发展迅速，文章内容可能存在滞后性。读者需自行判断信息的时效性，因依据过时内容产生的后果，作者及发布平台不承担责任。
本文为 Alpha_h4ck 独立观点，未经授权禁止转载。
如需授权、对文章有疑问或需删除稿件，请联系 FreeBuf 客服小蜜蜂（微信：freebee1024）
如需授权、对文章有疑问或需删除稿件，请联系 FreeBuf 客服小蜜蜂（微信：freebee1024）
被以下专辑收录，发现更多精彩内容
+ 收入我的专辑
+ 加入我的收藏
相关推荐
Alpha_h4ck LV.10
好好学习，天天向上
- 2359 文章数
- 1021 关注者
Tetragon：一款基于eBPF的运行时环境安全监控工具
2025-01-21
DroneXtract：一款针对无人机的网络安全数字取证工具
2025-01-21
CNAPPgoat：一款针对云环境的安全实践靶场
2025-01-21
文章目录