Skip to main content

Check subdomains for subdomain takeovers and other DNS tomfoolery

Project description

BadDNS

Check subdomains for subdomain takeovers and other DNS tomfoolery

Ruff License tests codecov Pypi Downloads

BadDNS is a standalone tool and BBOT module for detecting domain/subdomain takeovers of all kinds, including other DNS issues like NSEC walks and Subdomain Takeovers.

Check out the introductory blog on the BLS substack!

Installation

We have a pypi package, so you can just do pip install baddns to make use of the library.

Or use pipx: pipx install git+https://github.com/blacklanternsecurity/baddns

Usage

After installing with pip, you can just run baddns from the command line.

usage: baddns [-h] [-n CUSTOM_NAMESERVERS] [-c CUSTOM_SIGNATURES] [-l] [-s] [-m MODULES] [-d] [-D] [target]

Check subdomains for subdomain takeovers and other DNS tomfoolery

positional arguments:
  target                subdomain to analyze

options:
  -h, --help            show this help message and exit
  -n CUSTOM_NAMESERVERS, --custom-nameservers CUSTOM_NAMESERVERS
                        Provide a list of custom nameservers separated by comma.
  -c CUSTOM_SIGNATURES, --custom-signatures CUSTOM_SIGNATURES
                        Use an alternate directory for loading signatures
  -l, --list-modules    List available modules and their descriptions.
  -s, --silent          Only show results, no other output (JSON format)
  -m MODULES, --modules MODULES
                        Comma separated list of module names to use. Ex: module1,module2,module3
  -d, --debug           Enable debug logging
  -D, --direct          Enable direct mode

Modules

Name Description
cname Check for dangling CNAME records and interrogate them for subdomain takeover opportunities
ns Check for dangling NS records, and interrogate them for takeover opportunities
mx Check for dangling MX records and assess their base domains for availability
nsec Enumerate subdomains by NSEC-walking
references Check HTML content for links or other references that contain a hijackable domain
txt Check TXT record contents for hijackable domains
zonetransfer Attempt a DNS zone transfer
dmarc Check for missing or misconfigured DMARC records
mta-sts Check for MTA-STS misconfigurations and dangling mta-sts subdomains
wildcard Check for wildcard DNS records that could enable domain-wide subdomain takeover
spf Check for missing or misconfigured SPF records and hijackable include/redirect domains

Examples

  • Simple check
baddns subdomaintocheck.example.com
  • Specify Module(s)
baddns -m CNAME subdomaintocheck.example.com
baddns -m CNAME,NS subdomaintocheck.example.com
  • List available Modules
baddns -l
  • Custom Nameservers
baddns -n 1.1.1.1 subdomaintocheck.example.com

Documentation

Please visit our full documentation for many more details, including information about specific BadDNS modules.

Acknowledgements

BadDNS Signatures are sourced primarily from Nuclei Templates and from dnsReaper by Punk Security, although many have been modified or updated in BadDNS. Much of the research contained in the signatures was originally discussed on the issues page of can-i-take-over-xyz.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

baddns-2.0.452.tar.gz (61.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

baddns-2.0.452-py3-none-any.whl (117.1 kB view details)

Uploaded Python 3

File details

Details for the file baddns-2.0.452.tar.gz.

File metadata

  • Download URL: baddns-2.0.452.tar.gz
  • Upload date:
  • Size: 61.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for baddns-2.0.452.tar.gz
Algorithm Hash digest
SHA256 193e3ff866986ddb626ec563991c3ea760985ca74f7ed59c0f3770c9f5543d9d
MD5 a5d19a6ed5883999c550fedf091b5878
BLAKE2b-256 77321d82b8781bd9285fabb4a03f342bfc8e27f219665af5dd184fc97bf9694a

See more details on using hashes here.

File details

Details for the file baddns-2.0.452-py3-none-any.whl.

File metadata

  • Download URL: baddns-2.0.452-py3-none-any.whl
  • Upload date:
  • Size: 117.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for baddns-2.0.452-py3-none-any.whl
Algorithm Hash digest
SHA256 54e38e2b661de981f95454abea8b17a6bb3d1d5ff1e046738c319cfd7cfc018d
MD5 aeb1efdde64ec410ae442ae85f9ad794
BLAKE2b-256 d6cb7ed49be7f8802adfcb57710548ed28239d899eaf5db7a49e57df8600385f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page