XnoleXDocs

Reconnaissance

XnoleX uses four security tools to discover and map your target's attack surface. Each tool runs as a subprocess with structured output parsing.

Subdomain Discovery

subfinder performs passive subdomain enumeration by querying multiple public sources (Certificate Transparency logs, DNS datasets, search engines). It discovers subdomains without sending any traffic to the target.

subfinder execution
subfinder -d <domain> -silent -timeout 60
Timeout: 180 seconds total process timeout.
Output: One subdomain per line, filtered to lines containing a dot.
DNS resolution: Each discovered subdomain is immediately resolved using dig.
DNS resolution
dig +short <subdomain>

dig resolves each subdomain to its IP address. Only the first A-record IP is stored. Resolution failures result in an empty IP field.

Port Scanning

nmap performs host discovery to find additional subdomains and verify which hosts are alive.

nmap execution
nmap -sn --open -T4 --max-retries 1 <domain>
-sn: Ping scan only (no port scan). Discovers live hosts.
--open: Only show hosts that responded.
-T4: Aggressive timing template for faster execution.
--max-retries 1: Limit retries to speed up scanning.
Timeout: 120 seconds total process timeout.

nmap output is parsed for "Nmap scan report for" lines. Hostnames are extracted and deduplicated against subfinder results. IP addresses are captured from parenthesized notation (e.g., "host.example.com (192.168.1.1)").

HTTP Service Discovery

httpx-pd probes all discovered subdomains and the root domain for live HTTP services. It collects response status codes, page titles, and technology fingerprints.

httpx execution
httpx-pd -silent -status-code -title \
  -tech-detect -follow-redirects \
  -timeout 15 -retries 1
-status-code: Display HTTP response status codes.
-title: Extract page titles from HTML responses.
-tech-detect: Identify technologies used (frameworks, CMS, servers).
-follow-redirects: Follow HTTP redirects to the final destination.
-timeout 15: 15-second timeout per request.
-retries 1: One retry on failure.
Timeout: 300 seconds total process timeout.

Output lines are parsed to extract URLs and status codes. Lines matching (https?://[^\s]+) [(\d+)] are captured with their status code. HTTP methods default to GET.

Data Correlation

Results from all tools are correlated into a unified data model. Subdomains discovered by subfinder and nmap are merged and deduplicated by name. Each subdomain is mapped to its resolved IP address, discovered endpoints, and identified technologies.

Merge logic: nmap results are added only if the subdomain name is not already in the subfinder results.
Input to httpx: All merged subdomain names plus the root domain.
Input to nuclei: The root domain plus all discovered endpoint URLs (max 50).

Stored Results

Reconnaissance results are stored in two database tables:

subdomains table

Schema
subdomains
  ├── id          UUID (primary key)
  ├── scan_id     UUID (foreign key to scans)
  ├── name        TEXT (e.g., "api.example.com")
  ├── ip_address  TEXT (e.g., "192.168.1.1")
  └── status      TEXT ("active")

endpoints table

Schema
endpoints
  ├── id          UUID (primary key)
  ├── scan_id     UUID (foreign key to scans)
  ├── url         TEXT (e.g., "https://api.example.com/health")
  ├── method      TEXT (e.g., "GET")
  └── status_code INTEGER (e.g., 200)

Installed Tools

The following tools are installed on the XnoleX scanning infrastructure:

Tool
Version
Purpose
subfinder
v2.6.7
Passive subdomain enumeration
httpx-pd
v1.6.10
HTTP service probing
nmap
v7.99
Host discovery
nuclei
latest
Vulnerability scanning
dig
system
DNS resolution
Note
All tools run as isolated subprocesses with a maximum process timeout of 5 minutes per tool. If a tool exceeds its timeout, it is terminated and the scan continues with partial results.