CZDS

O que é CZDS?

Cada Domínio de Topo (TLD) é mantido por um operador de registro, que também gerencia uma lista publicamente disponível de Domínios de Segundo Nível (SLDs) e os detalhes necessários para resolver esses nomes de domínio em endereços de Protocolo de Internet (IP).

Os dados de zona do operador de registro contêm o mapeamento dos nomes de domínio, os nomes dos servidores de nomes associados e os endereços IP desses servidores de nomes. Esses detalhes são atualizados pelo operador de registro para seus respectivos TLDs sempre que as informações mudam ou um nome de domínio é adicionado ou removido.

Cada operador de registro mantém seus dados de zona em um arquivo de texto chamado Zone File, que é atualizado uma vez a cada 24 horas.

Funcionalidades

• Recuperar arquivos de Transferência de Zona Centralizada de servidores DNS raiz hospedados pela ICAAN e outras agências
• Baixar um ou todos os arquivos de zona e retornar os dados em múltiplos formatos; texto, json ou um arquivo (padrão)
• Agora você pode recuperar arquivos de zona usando multi-threading

Roadmap

A seguir estão alguns dos recursos que pretendo adicionar, mas adoraria ouvir a opinião de todos também.

• Adicionar capacidade de busca com base em domínio e/ou TLD
  • Isso pode incluir o uso de algoritmos como distância de Levenshtein, caracteres confusables/idna, etc.
• Adicionar capacidade de derivar diferenças entre arquivos de zona ao longo do tempo
• Adicionar capacidade de recuperar outras informações externas contextuais, como WHOIS
• Adicionar capacidade de salvar/armazenar dados em um banco de dados

Requisitos

• Você precisa de uma conta CZDS com a ICAAN. Você pode se registrar aqui
• Acesso à internet

Instalação

Você pode instalar o CZDS via pip a partir do PyPI:

$ pip install czds

Se você estiver usando poetry (recomendado), você pode adicioná-lo ao seu pacote usando

poetry add czds

Uso

Abaixo está a referência de linha de comando, mas você também pode usar a versão atual do czds para obter a ajuda 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

Contribuindo

Contribuições são muito bem-vindas. Para saber mais, consulte o Guia do Contribuidor.

Desenvolvimento

Você pode clonar o repositório e iniciar o desenvolvimento usando

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

Se você estiver usando pyenv para gerenciar seus ambientes, você pode definir uma opção de configuração no poetry para usar a versão do python definida pelo pyenv executando o seguinte:

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

Licença

Distribuído sob os termos da [licença MIT][LICENSE.md], CZDS é um software livre e de código aberto.

Segurança

Preocupações com segurança são uma prioridade máxima para nós; por favor, revise nossa Política de Segurança.

Problemas

Se você encontrar algum problema, por favor abra uma issue juntamente com uma descrição detalhada.

Créditos

Este projeto foi gerado a partir do template Hypermodern Python Cookiecutter do @MSAdministrator.