CZDS

Cos'è CZDS?

Ogni dominio di primo livello (TLD) è gestito da un operatore di registro, che gestisce anche un elenco pubblicamente disponibile di domini di secondo livello (SLD) e i dettagli necessari per risolvere quei nomi di dominio in indirizzi Internet Protocol (IP).

I dati di zona dell'operatore di registro contengono la mappatura dei nomi di dominio, i nomi dei name server associati e gli indirizzi IP di tali name server. Questi dettagli vengono aggiornati dall'operatore di registro per i rispettivi TLD ogni volta che le informazioni cambiano o che un nome di dominio viene aggiunto o rimosso.

Ogni operatore di registro conserva i propri dati di zona in un file di testo chiamato Zone File, che viene aggiornato una volta ogni 24 ore.

Funzionalità

• Recupera i file Centralized Zone Transfer dai server DNS root ospitati da ICAAN e altre agenzie
• Scarica uno o tutti i file di zona e restituisci i dati in più formati: testo, json o un file (predefinito)
• Ora puoi recuperare i file di zona usando il multi-threading

Roadmap

Le seguenti sono alcune delle funzionalità che ho intenzione di aggiungere, ma mi farebbe piacere ascoltare anche le opinioni di tutti.

• Aggiungere la possibilità di cercare in base al dominio e/o TLD
  • Questo potrebbe includere l'uso di algoritmi come la distanza di Levenshtein, caratteri confusables/idna, ecc.
• Aggiungere la possibilità di ricavare le differenze tra i file di zona nel tempo
• Aggiungere la possibilità di recuperare altre informazioni contestuali esterne come WHOIS
• Aggiungere la possibilità di salvare/archiviare i dati in un database

Requisiti

• È necessario un account CZDS con ICAAN. Puoi registrarti qui
• Accesso a Internet

Installazione

Puoi installare CZDS tramite pip da PyPI:

$ pip install czds

Se stai usando poetry (consigliato) puoi aggiungerlo al tuo pacchetto usando

poetry add czds

Utilizzo

Di seguito è riportato il riferimento della riga di comando, ma puoi anche usare la versione attuale di czds per ottenere l'aiuto digitando 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

Contribuire

I contributi sono molto graditi. Per saperne di più, consulta la Guida per i contributori.

Sviluppo

Puoi clonare il repository e iniziare lo sviluppo usando

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

Se stai usando pyenv per gestire i tuoi ambienti, puoi impostare un'opzione di configurazione in poetry per usare la versione di python impostata da pyenv eseguendo questo comando:

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

Licenza

Distribuito secondo i termini della [licenza MIT][LICENSE.md], CZDS è un software libero e open source.

Sicurezza

Le problematiche di sicurezza sono una priorità assoluta per noi, ti preghiamo di consultare la nostra Policy di sicurezza.

Problemi

Se incontri problemi, ti preghiamo di aprire una segnalazione con una descrizione dettagliata.

Riconoscimenti

Questo progetto è stato generato dal template Hypermodern Python Cookiecutter di @MSAdministrator.