Skip to main content

A professional CLI toolkit for DNSSEC scanning and DNS forensic analysis.

Project description

๐Ÿ” DNSSEC CLI โ€” DNSSEC Scanner & Trust Chain Analyzer

A professional, developer-friendly command-line toolkit for DNSSEC scanning,
forensic DNS analysis, and trust chain validation.

Designed for security researchers, penetration testers, SREs, and data scientists
interested in DNS observability, DNSSEC validation, and domain integrity.


โญ Features

  • ๐Ÿš€ Full DNSSEC scanner (scan)
  • ๐Ÿ” Complete DNSSEC chain validation (validate)
  • ๐ŸŒณ DNSSEC trust tree visualization (tree)
  • ๐Ÿ”— Trust chain summary (chain)

๐Ÿ“ฆ Installation

From PyPI (recommended)

pip install dnssec-cli

From Source (GitHub)

git clone https://github.com/<TU-USUARIO>/dnssec-cli
cd dnssec-cli
pip install .

๐Ÿงฐ Commands

๐Ÿ” Scan a domain

dnssec-cli scan unam.mx

With validation:

dnssec-cli scan unam.mx --validate

JSON mode:

dnssec-cli scan unam.mx --json

๐Ÿ” Validate DNSSEC

dnssec-cli validate tec.mx

Example output:

โ””โ”€โ”€ unam.mx.
    โœ” DS OK (keytag 54058)
    โ””โ”€โ”€ mx.
        โœ” DS OK (keytag 12884)
        โ””โ”€โ”€ .
            โœ” Root trusted (ICANN KSK)

๐ŸŒณ Print Trust Tree

dnssec-cli tree semarnat.gob.mx

๐Ÿ”— Chain Summary

dnssec-cli chain dnssec-failed.org

Example:

dnssec-failed.org. โ†’ org. โ†’ . โ†’ BROKEN

๐Ÿง  Roadmap (Data Science + AI)

๐Ÿ“Š DNS Statistical Toolkit

  • TTL distribution metrics
  • Unstable DNS patterns
  • RRset churn analysis
  • Anomaly scoring

๐Ÿค– AI Models

  • DNSSEC risk scoring
  • Suspicious domain classifier
  • Predictive alerts for key rollover failures

๐ŸŒ Web Dashboard (Flask)

  • Visual DNSSEC tree
  • REST API
  • Reports and analytics

๐Ÿ“ Project Structure

dnssec-cli/
โ”‚
โ”œโ”€โ”€ dnssec_tool/
โ”‚   โ”œโ”€โ”€ cli.py
โ”‚   โ”œโ”€โ”€ dig.py
โ”‚   โ”œโ”€โ”€ parser.py
โ”‚   โ”œโ”€โ”€ validator.py
โ”‚   โ”œโ”€โ”€ resolver_chain.py
โ”‚   โ””โ”€โ”€ __init__.py
โ”‚
โ”œโ”€โ”€ README.md
โ”œโ”€โ”€ LICENSE
โ””โ”€โ”€ pyproject.toml

๐Ÿค Contributing

Pull requests welcome.


๐Ÿ“„ License

MIT License ยฉ 2025 โ€” Julio Briones


โญ Support

If you like this project, give it a โญ on GitHub!

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

dnssec_cli-1.1.0.tar.gz (13.9 kB view details)

Uploaded Source

Built Distribution

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

dnssec_cli-1.1.0-py3-none-any.whl (16.0 kB view details)

Uploaded Python 3

File details

Details for the file dnssec_cli-1.1.0.tar.gz.

File metadata

  • Download URL: dnssec_cli-1.1.0.tar.gz
  • Upload date:
  • Size: 13.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.3

File hashes

Hashes for dnssec_cli-1.1.0.tar.gz
Algorithm Hash digest
SHA256 af66badfa9b5c9b4d694702f76d7785976e7dbccd054061346db1e1bc6c95c98
MD5 9385ac04383430645f5827da842c394a
BLAKE2b-256 d97b999ee63be814a33ef5e58fd1096153971009b92d3bc9ca80b0c523375d3f

See more details on using hashes here.

File details

Details for the file dnssec_cli-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: dnssec_cli-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 16.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.3

File hashes

Hashes for dnssec_cli-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c67a442ce02787035fc541ae787b8e9d19564fb8e5013d8f0cd1b51cb9579a29
MD5 f1e46f5319450d98ca4f9bbab6bb95e9
BLAKE2b-256 edea0bc7ab7f6176b05935398f0528ff15cb6564757a83137024b89dc2f48f35

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