漏洞检测工具：Swagger UI敏感信息泄露

Swagger UI敏感信息泄露

漏洞定义

Swagger UI是一个交互式的、可视化的RESTful API文档工具，它允许开发人员快速浏览、测试API接口。Swagger UI通过读取由Swagger（也称为OpenAPI）规范定义的API描述文件（如swagger.json或swagger.yaml），自动生成易于理解的API文档，极大地简化了API的使用和测试过程。

漏洞危害

当Swagger UI的配置存在缺陷，如未设置访问控制、未启用严格的授权认证或直接在UI中展示敏感信息时，就可能导致敏感信息泄露。这种泄露是指未经授权的用户能够访问到原本应该受到保护的API文档和其中的敏感信息。

漏洞检测

访问Swagger UI未授权访问路径，可以通过BP抓包，然后再通过BP对该接口路径进行爆破

/api
/api-docs
/api-docs/swagger.json

检测脚本

原理

使用域名拼接Swagger UI未授权访问路径（http://www.test.com/api-docs/swagger.json），然后模拟浏览器进行访问。若状态码200且页面长度大于0，则可能存在信息泄露，需要人工对检测结果进行最终的验证 。

用法

python scanner.py urls.txt的文件路径

注意：检测结果不可避免的存在一些误报，需要人工对检测结果进行最终的验证 

代码

api.txt

api-docs/swagger.json
actuator
actuator/./env
actuator/auditLog
actuator/auditevents
actuator/autoconfig
actuator/beans
actuator/caches
actuator/conditions
actuator/configurationMetadata
actuator/configprops
actuator/dump
actuator/env
actuator/events
actuator/exportRegisteredServices
actuator/features
actuator/flyway
actuator/health
actuator/healthcheck
actuator/httptrace
actuator/hystrix.stream
actuator/info
actuator/integrationgraph
actuator/jolokia
actuator/logfile
actuator/loggers
actuator/loggingConfig
actuator/liquibase
actuator/metrics
actuator/mappings
actuator/scheduledtasks
actuator/swagger-ui.html
actuator/prometheus
actuator/refresh
actuator/registeredServices
actuator/releaseAttributes
actuator/resolveAttributes
actuator/scheduledtasks
actuator/sessions
actuator/springWebflow
actuator/sso
actuator/ssoSessions
actuator/statistics
actuator/status
actuator/threaddump
actuator/trace
actuator/env.css
artemis-portal/artemis/env
artemis/api
artemis/api/env
auditevents
autoconfig
api
api.html
api/actuator
api/doc
api/index.html
api/swaggerui
api/swagger-ui.html
api/swagger
api/swagger/ui
api/v2/api-docs
api/v2;%0A/api-docs
api/v2;%252Ftest/api-docs
api-docs
beans
caches
cloudfoundryapplication
conditions
configprops
distv2/index.html
docs
doc.html
druid
druid/index.html
druid/login.html
druid/websession.html
dubbo-provider/distv2/index.html
dump
decision/login
entity/all
env
env.css
env/(name)
eureka
flyway
functionRouter
gateway/actuator
gateway/actuator/auditevents
gateway/actuator/beans
gateway/actuator/conditions
gateway/actuator/configprops
gateway/actuator/env
gateway/actuator/health
gateway/actuator/httptrace
gateway/actuator/hystrix.stream
gateway/actuator/info
gateway/actuator/jolokia
gateway/actuator/logfile
gateway/actuator/loggers
gateway/actuator/mappings
gateway/actuator/metrics
gateway/actuator/scheduledtasks
gateway/actuator/swagger-ui.html
gateway/actuator/threaddump
gateway/actuator/trace
gateway/routes
health
httptrace
hystrix
info
integrationgraph
jolokia
jolokia/list
jeecg/swagger-ui
jeecg/swagger/
libs/swaggerui
liquibase
list
logfile
loggers
liquibase
metrics
mappings
monitor
nacos
prod-api/actuator
prometheus
portal/conf/config.properties
portal/env/
refresh
scheduledtasks
sessions
spring-security-oauth-resource/swagger-ui.html
spring-security-rest/api/swagger-ui.html
static/swagger.json
sw/swagger-ui.html
swagger
swagger/codes
swagger/doc.json
swagger/index.html
swagger/static/index.html
swagger/swagger-ui.html
Swagger/ui/index
swagger/ui
swagger/v1/swagger.json
swagger/v2/swagger.json
swagger-dubbo/api-docs
swagger-resources
swagger-resources/configuration/ui
swagger-resources/configuration/security
swagger-ui
swagger-ui.html
swagger-ui.html;
swagger-ui/html
swagger-ui/index.html
system/druid/index.html
system/druid/webseesion.html
threaddump
template/swagger-ui.html
trace
users
user/swagger-ui.html
version
v1/api-docs/
v2/api-docs/
v3/api-docs/
v1/swagger-resources
v2/swagger-resources
v3/swagger-resources
v1.1/swagger-ui.html
v1.1;%0A/api-docs
v1.2/swagger-ui.html
v1.2;%0A/api-docs
v1.3/swagger-ui.html
v1.3;%0A/api-docs
v1.4/swagger-ui.html
v1.4;%0A/api-docs
v1.5/swagger-ui.html
v1.5;%0A/api-docs
v1.6/swagger-ui.html
v1.6;%0A/api-docs
v1.7/swagger-ui.html
v1.7;%0A/api-docs
v1.8/swagger-ui.html
v1.8;%0A/api-docs
v1.9/swagger-ui.html
v1.9;%0A/api-docs
v2.0/swagger-ui.html
v2.0;%0A/api-docs
v2.1/swagger-ui.html
v2.1;%0A/api-docs
v2.2/swagger-ui.html
v2.2;%0A/api-docs
v2.3/swagger-ui.html
v2.3;%0A/api-docs
v1/swagger.json
v2/swagger.json
v3/swagger.json
v2;%0A/api-docs
v3;%0A/api-docs
v2;%252Ftest/api-docs
v3;%252Ftest/api-docs
webpage/system/druid/websession.html
webpage/system/druid/index.html
webroot/decision/login
webjars/springfox-swagger-ui/swagger-ui-standalone-preset.js
webjars/springfox-swagger-ui/swagger-ui-standalone-preset.js?v=2.9.2
webjars/springfox-swagger-ui/springfox.js
webjars/springfox-swagger-ui/springfox.js?v=2.9.2
webjars/springfox-swagger-ui/swagger-ui-bundle.js
webjars/springfox-swagger-ui/swagger-ui-bundle.js?v=2.9.2
%20/swagger-ui.html

scanner.py

import sys
import requests
import pandas as pd
from typing import List, Dict, Any

scan_results: List[Dict[str, Any]] = []

def read_file(file_path):
    try:
        with open(file_path, 'r', encoding='utf-8') as file:  # 指定编码为utf-8
            lines = file.readlines()
        # 去除每行末尾的换行符和空行
        lines = [line.strip() for line in lines if line.strip()]
        return lines
    except FileNotFoundError:
        print(f"错误: {file_path} 文件不存在！")
        sys.exit(1)  # 退出程序并返回错误码1
    except IOError:
        print(f"错误: {file_path} 文件读取失败！")
        sys.exit(1)  # 退出程序并返回错误码1


def export_to_excel(data, file_name):
    df = pd.DataFrame(data)
    try:
        # 将DataFrame写入Excel文件，不包括索引
        df.to_excel(file_name, index=False)
        print(f"结果已写入文件： {file_name}")
    except IOError:
        print(f"结果写入出错： {file_name}.")


# 检查目标URL是否存在Swagger UI信息泄露，并返回相关信息
def check_swagger_ui(url):
    # 从api.txt文件中读取需要扫描的所有api
    api = read_file('api.txt')

    for a in api:
        full_url = url +'/'+ a #拼接成新的url
        try:
            # 发送GET请求到目标URL
            response = requests.get(full_url, timeout=5)
            status_code = response.status_code  # 获取状态码
            content_length = len(response.content)  # 获取页面长度（字节数）
            # 请求成功并且内容不为空
            if status_code == 200 and content_length > 0:
                print("True ：",full_url,"\t\t长度：",content_length)
                scan_results.append({'url': full_url, '状态':status_code,'漏洞': True,'长度': content_length})
            else:
                print("False：", full_url)
        except requests.RequestException as e:
            print("False：", full_url)


if __name__ == "__main__":
    # 如果提供了命令行参数，则使用它作为文件路径，否则使用默认路径
    if len(sys.argv) > 1:
        urls_path = sys.argv[1]
    else:
        # 默认文件路径，假设它与脚本在同一目录中
        urls_path = 'urls.txt'

    # 从urls.txt文件中读取需要扫描的所有url
    urls = read_file(urls_path)

    # 依次遍历需要扫描的url
    for url in urls:
        check_swagger_ui(url)

    # 将检测结果集导出为xlsx文档
    export_to_excel(scan_results, 'result.xlsx')