首页/安全/漏洞与攻击面速查/Swagger/OpenAPI 文档暴露
本包目录(294 条)
漏洞基础与评分46 条
Web 漏洞原理与防护55 条
主机与服务风险面53 条扫描与验证方法50 条补丁与修复管理45 条暴露面收敛45 条

Swagger/OpenAPI 文档暴露

接口文档(Swagger UI、api-docs 路径)在生产环境公开会暴露全部接口、参数与内部字段;应改为内网访问、增加鉴权或按环境关闭。

漏洞与攻击面速查安全更新于 2026-10-12

常见路径自查

常见路径自查
/swagger-ui.html  /swagger-ui/index.html
/v2/api-docs  /v3/api-docs
/openapi.json  /docs
逐一请求,确认是否需要鉴权、是否可从公网访问

Spring 环境关闭示例

Spring 环境关闭示例
# application-prod.properties
springdoc.api-docs.enabled=false
springdoc.swagger-ui.enabled=false
# 或保留但加访问控制:仅内网网段可访问
文档是开发提效工具,不必一刀切关闭;评估用内网域名加鉴权的方式保留可用性。

易错点

  • 把文档改到随机路径当作防护:路径可从前端代码与网络记录中还原,本质仍是公开

数据来源与参考

  • springdoc-openapi 官方文档
  • OWASP API Security Top 10(API 资产无序管理)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌