Skip to content

ppiankov/dnsspectre

Repository files navigation

dnsspectre

CI Go Report Card ANCC

dnsspectre — DNS hygiene and subdomain takeover detection. Part of SpectreHub.

What it is

  • Scans DNS zones for dangling records pointing to deleted resources
  • Detects subdomain takeover vectors (CNAME, NS, MX targets)
  • Checks for missing CAA records
  • Supports Route53, Cloud DNS, Azure DNS, and Cloudflare
  • Outputs text, JSON, SARIF, and SpectreHub formats

What it is NOT

  • Not a DNS monitoring service — point-in-time scanner
  • Not a penetration testing tool — detects risk, does not exploit
  • Not a DNS manager — reports findings, never modifies records
  • Not a certificate manager — flags missing CAA, does not issue certs

Quick start

Homebrew

brew tap ppiankov/tap
brew install dnsspectre

From source

git clone https://github.com/ppiankov/dnsspectre.git
cd dnsspectre
make build

Usage

dnsspectre scan --provider route53 --format json

CLI commands

Command Description
dnsspectre scan Scan DNS zones for dangling records and takeover risk
dnsspectre init Generate config file and provider credentials
dnsspectre version Print version

SpectreHub integration

dnsspectre feeds DNS hygiene findings into SpectreHub for unified visibility across your infrastructure.

spectrehub collect --tool dnsspectre

Safety

dnsspectre operates in read-only mode. It inspects and reports — never modifies, deletes, or alters your DNS records.

Documentation

Document Contents
CLI Reference Full command reference, flags, and configuration

License

MIT — see LICENSE.


Built by Obsta Labs

About

No description or website provided.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors