Skip to content

Add common Swagger/OpenAPI endpoints to reconnaissance wordlists #1378

@notReallySouvik

Description

@notReallySouvik

Description

While exploring the modules, I noticed that Swagger/OpenAPI is currently only detected through passive technology fingerprinting in web_technologies.yaml (for example detecting swagger-ui-bundle.js).

However, many applications expose Swagger/OpenAPI documentation through predictable endpoints that are commonly used during reconnaissance, such as:

  • /swagger-ui.html
  • /swagger
  • /swagger-ui/
  • /api-docs
  • /v3/api-docs
  • /swagger.json
  • /openapi.json

These endpoints can sometimes expose full API schemas and unauthenticated routes.

Proposal

Add these common Swagger/OpenAPI paths to the payload wordlists used by modules such as:

  • dir_scan
  • config_scan

This would allow the scanner to actively probe for exposed API documentation endpoints instead of relying only on passive fingerprinting.

Benefits

  • Expands API reconnaissance coverage
  • Helps identify exposed API documentation
  • May reveal unauthenticated API endpoints during recon

Implementation

This should be a relatively small change by extending the relevant wordlists with the endpoints listed above.

If this approach looks good, I’d be happy to work on implementing it.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions