OWASP / OWASP/Nettacker

Add common Swagger/OpenAPI endpoints to reconnaissance wordlists

Open
#1,378 3 comments 0 reactions 1 assignee View on GitHub

@ChrisJr404 is already working on this.

Since May 7, 2026.

Dominant language
Python
Stars
5.6k
Forks
1.2k
Avg merge
1d 21h
Merged PRs (30d)
16

Description

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.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.