Skip to content

Add WhoisXMLAPI Subdomains Lookup plugin for subdomain enumeration - #1121

Open
kato83 wants to merge 1 commit into
owasp-amass:developfrom
kato83:feature/add-whoisxmlapi-plugin
Open

Add WhoisXMLAPI Subdomains Lookup plugin for subdomain enumeration#1121
kato83 wants to merge 1 commit into
owasp-amass:developfrom
kato83:feature/add-whoisxmlapi-plugin

Conversation

@kato83

@kato83 kato83 commented Apr 22, 2026

Copy link
Copy Markdown

Summary

Add the WhoisXMLAPI Subdomains Lookup API plugin for subdomain enumeration, ported to the current v5.1.1 plugin API.

Port the WhoisXMLAPI subdomain discovery plugin from v4.

Changes

engine/plugins/api/whoisxmlapi.go (new file)

New plugin implementing the WhoisXMLAPI Subdomains Lookup API:

  • Queries https://subdomains.whoisxmlapi.com/api/v1 with the configured API key
  • Discovers subdomains for in-scope FQDNs and feeds them back into the engine pipeline
  • Follows the same patterns as existing API plugins (SecurityTrails, VirusTotal, etc.):
    • Rate limiting via golang.org/x/time/rate (500ms interval)
    • TTL-based caching with support.AssetMonitoredWithinTTL
    • Scope validation with support.HasSLDInScope and e.Session.Scope().IsAssetInScope
    • API key read from datasource config (datasources.yaml)

engine/plugins/load.go

Register api.NewWhoisXMLAPI in the plugin load list.

Port the v4 WhoisXMLAPI vertical (subdomain lookup) functionality
as a v5 plugin using the Subdomains Lookup API.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant