https://github.com/lijiejie/swagger-exp

A Swagger API Exploit
https://github.com/lijiejie/swagger-exp

Last synced: 1 day ago
JSON representation

A Swagger API Exploit

• Host: GitHub
• URL: https://github.com/lijiejie/swagger-exp
• Owner: lijiejie
• Created: 2021-03-23T06:46:21.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2024-06-07T10:24:50.000Z (8 months ago)
• Last Synced: 2025-01-10T15:12:24.040Z (9 days ago)
• Language: JavaScript
• Size: 623 KB
• Stars: 1,213
• Watchers: 19
• Forks: 131
• Open Issues: 10
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-hacking-lists - lijiejie/swagger-exp - A Swagger API Exploit (JavaScript)

README

        
# **Swagger API Exploit 1.2**

这是一个 Swagger REST API 信息泄露利用工具。 主要功能有：

* 遍历所有API接口，自动填充参数

* 尝试 GET / POST 所有接口，返回 Response Code / Content-Type / Content-Length ，用于分析接口是否可以未授权访问利用

* 分析接口是否存在敏感参数，例如url参数，容易引入外网的SSRF漏洞

* 检测 API认证绕过漏洞

* 在本地监听一个Web Server，打开Swagger UI界面，供分析接口使用

* 使用Chrome打开本地Web服务器，并禁用CORS，解决部分API接口无法跨域请求的问题

* 当工具检测到HTTP认证绕过漏洞时，本地服务器拦截API文档，修改path，以便直接在Swagger UI中进行测试

## ChangeLog

* [2024-06-07] 增加支持 OpenAPI 3.0

* [2022-08-08] Fix chromeSwagger permission error

* [2021-04-04] 支持 Python3 

## 扫描器改进建议

* 分析json文档，将发现的URL，自动添加到爬虫中

## Usage

需要介入分析 api_summary.txt 文件中的内容

* 扫描所有API集，打开Swagger UI

  > python swagger-exp.py http://site.com/swagger-resources/

* 扫描一个API集，打开Swagger UI

  > python swagger-exp.py http://site.com/v2/api-docs

* 只打开Swagger UI，不扫描接口

  > python swagger-exp.py

## 工具截图

![](screenshot.png)

![](screenshot2.png)