acidvegas/czds
acidvegas/czds
1
Fork 0
Code Issues Pull Requests Activity

Updated README with statistics & renamed czdz.py to czds.py (oop)

Browse Source
This commit is contained in:
Dionysus 2023-12-13 17:54:46 -05:00
parent 4c0d884074
commit 1b90b6e099
Signed by: acidvegas
GPG Key ID: EF4B922DB85DC9DE
2 changed files with 8 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
README.md
View File

@ -3,7 +3,11 @@
The [ICANN Centralized Zone Data Service](https://czds.icann.org) *(CZDS)* allows *approved* users to request and download DNS zone files in bulk, provided they represent a legitimate company or academic institution and their intended use is legal and ethical. Once ICANN approves the request, this tool streamlines the retrieval of extensive domain name system data, facilitating research and security analysis in the realm of internet infrastructure. The [ICANN Centralized Zone Data Service](https://czds.icann.org) *(CZDS)* allows *approved* users to request and download DNS zone files in bulk, provided they represent a legitimate company or academic institution and their intended use is legal and ethical. Once ICANN approves the request, this tool streamlines the retrieval of extensive domain name system data, facilitating research and security analysis in the realm of internet infrastructure.
## Zone Information ## Zone Information
Zone files are updated once every 24 hours, specifically from 00:00 UTC to 06:00 UTC. Access to these zones is granted in increments, and the total time for approval across all zones may extend to a month or longer. It is typical for more than 90% of requested zones to receive approval. Access to certain zone files may require additional application forms with the TLD organization. Please be aware that access to certain zones is time-bound, expiring at the beginning of the following year, or up to a decade after the initial approval has been confirmed. At the time of writing this repository, the CZDS offers access to 1,150 zones. Zone files are updated once every 24 hours, specifically from 00:00 UTC to 06:00 UTC. Access to these zones is granted in increments, and the total time for approval across all zones may extend to a month or longer. It is typical for more than 90% of requested zones to receive approval. Access to certain zone files may require additional application forms with the TLD organization. Please be aware that access to certain zones is time-bound, expiring at the beginning of the following year, or up to a decade after the initial approval has been confirmed.
At the time of writing this repository, the CZDS offers access to 1,150 zones in total.
1,076 have been approved, 58 are still pending *(after 3 months)*, 10 have been revoked because the TLDs are longer active, and 6 have been denied.
## Usage ## Usage
### Authentication ### Authentication
@ -25,9 +29,7 @@ python czds.py [--username <username> --password <password>] [--concurrency <int
``` ```
## Respects ## Respects
While ICANN does have an official [czds-api-client-python](https://github.com/icann/czds-api-client-python) repository, I rewrote it from scratch to be more streamline & included a POSIX version for portability. While ICANN does have an official [czds-api-client-python](https://github.com/icann/czds-api-client-python) repository, I rewrote it from scratch to be more streamline & included a POSIX version for portability. Either way, big props to ICANN for allowing me to use the CZDS for research purposes!
Either way, big props to ICANN for allowing me to use the CZDS for research purposes!
___ ___

2
czdz.py → czds.py
View File

@ -13,11 +13,13 @@ import getpass
import logging import logging
import os import os
try: try:
import requests import requests
except ImportError: except ImportError:
raise ImportError('Missing dependency: requests (pip install requests)') raise ImportError('Missing dependency: requests (pip install requests)')
def authenticate(username: str, password: str) -> str: def authenticate(username: str, password: str) -> str:
''' '''
Authenticate with ICANN's API and return the access token. Authenticate with ICANN's API and return the access token.