CZDS

What is CZDS?

Each Top Level Domain (TLD) is maintained by a registry operator, who also manages a publicly available list of Second Level Domains (SLDs) and the details needed to resolve those domain names to Internet Protocol (IP) addresses.

The registry operator’s zone data contains the mapping of domain names, associated name server names, and IP addresses for those name servers. These details are updated by the registry operator for its respective TLDs whenever information changes or a domain name is added or removed.

Each registry operator keeps its zone data in a text file called the Zone File which is updated once every 24 hours.

Features

• Retrieve Centralized Zone Transfer Files from root DNS servers hosted by ICAAN and other agencies
• Download one or all of the zone files and return data in multiple formats; text, json or a file (default)
• You can now retrieve zone files using multi-threading

Roadmap

The following are some of the features I am planning on adding but would love to hear everyones thoughts as well.

• Add ability to search based on domain and/or TLD
  • This may include using algorithms like Levenshtein distance, confusables/idna characters, etc.
• Add ability to derive differences between zone files over time
• Add ability to retrieve other contextual external information like WHOIS
• Add ability to save/store data into a database

Requirements

• You need a CZDS account with ICAAN. You can sign-up here
• Internet access

Installation

You can install CZDS via pip from PyPI:

$ pip install czds

If you are using poetry (recommended) you can add it to your package using

poetry add czds

Usage

Below is the command line reference but you can also use the current version of czds to retrieve the help by typing czds --help.

NAME
    czds - Main class for ICAAN CZDS.

SYNOPSIS
    czds GROUP | VALUE | --username=USERNAME --password=PASSWORD --save_directory=SAVE_DIRECTORY

DESCRIPTION
    Main class for ICAAN CZDS.

ARGUMENTS
    USERNAME
        Type: ~AnyStr
    PASSWORD
        Type: ~AnyStr
    SAVE_DIRECTORY
        Type: ~AnyStr

GROUPS
    GROUP is one of the following:

     BASE_HEADERS

     links

VALUES
    VALUE is one of the following:

     AUTH_URL

     BASE_URL

     OUTPUT_FORMAT

     PASSWORD

     SAVE_PATH

     THREAD_COUNT

     USERNAME

     connection

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

Developmemt

You can clone the repositry and begin development using

git clone https://github.com/MSAdministrator/czds.git
cd czds
poetry install

If you are using pyenv to manage your enviroments you can set a config option in poetry to use the set pyenv version of python by running this:

poetry config virtualenvs.prefer-active-python true
poetry install

License

Distributed under the terms of the [MIT license][LICENSE.md], CZDS is free and open source software.

Security

Security concerns are a top priority for us, please review our Security Policy.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This project was generated from @MSAdministrator's Hypermodern Python Cookiecutter template.