Passive Reconnaissance Guide
Passive reconnaissance gathers information about a target without sending intrusive traffic. These operations use DNS resolution, TLS inspection, and HTTP header analysis.
Enumerates DNS records for a domain.
scope = eggsec .Scope .allow_hosts (["example.com" ])
client = eggsec .Client (scope , mode = "manual" )
dns = client .recon_dns ("example.com" )
dns = eggsec .recon_dns ("example.com" )
future = eggsec .async_recon_dns ("example.com" )
for r in future :
if r is not None :
dns = r
Field
Type
Description
domain
str
Queried domain
a_records
list[str]
IPv4 addresses
aaaa_records
list[str]
IPv6 addresses
cname_records
list[str]
Canonical names
mx_records
list[MxRecord]
Mail exchange records
txt_records
list[str]
Text records
ns_records
list[str]
Name servers
caa_records
list[str]
Certificate authority records
soa_record
SoaRecord | None
Start of authority
Field
Type
Description
preference
int
MX priority
exchange
str
Mail server hostname
Field
Type
Description
mname
str
Primary name server
rname
str
Responsible person
serial
int
Serial number
refresh
int
Refresh interval (seconds)
retry
int
Retry interval (seconds)
expire
int
Expiration time (seconds)
minimum
int
Minimum TTL (seconds)
Analyzes TLS/SSL configuration for a host.
tls = client .inspect_tls ("example.com" )
tls = eggsec .inspect_tls ("example.com" )
Field
Type
Description
has_ssl
bool
TLS available
certificate
TlsCertificateInfo | None
Certificate details
supported_versions
list[str]
TLS versions (e.g. "TLSv1.3")
cipher_suites
list[str]
Supported cipher suites
issues
list[SslIssue]
Security issues found
Field
Type
Description
subject
str
Certificate subject
issuer
str
Certificate authority
valid_from
str
Not valid before
valid_until
str
Not valid after
serial_number
str
Serial number
signature_algorithm
str
Signature algorithm
public_key_algorithm
str
Public key type
key_size
int
Key size in bits
is_expired
bool
Expired flag
days_until_expiry
int
Days until expiration
subject_alternative_names
list[str]
SANs
Field
Type
Description
severity
str
Issue severity
code
str
Issue code
description
str
Human-readable description
Identifies web technologies from HTTP responses.
tech = client .detect_technology ("https://example.com" )
tech = eggsec .detect_technology ("https://example.com" )
Field
Type
Description
url
str
Scanned URL
status_code
int
HTTP status code
tech_stack
TechStack
Detected technologies
Field
Type
Description
servers
list[str]
Web servers (e.g. "nginx")
frameworks
list[str]
Frameworks (e.g. "Django")
languages
list[str]
Programming languages
databases
list[str]
Database technologies
cdns
list[str]
CDN providers
cms
list[str]
Content management systems
javascript
list[str]
JavaScript libraries
other
list[str]
Other detected technologies
All recon results can be incorporated into reports:
report = eggsec .Report ({"title" : "Recon Report" })
dns = eggsec .recon_dns ("example.com" )
for ip in dns .a_records :
report .add_finding (eggsec .Finding (
title = f"A record: { ip } " ,
severity = eggsec .Severity .INFO ,
))
tls = eggsec .inspect_tls ("example.com" )
if tls .has_ssl and tls .certificate .is_expired :
report .add_finding (eggsec .Finding (
title = "Expired certificate" ,
severity = eggsec .Severity .HIGH ,
))
report .write_json ("recon.json" )