Gotator

Gotator é uma ferramenta para gerar wordlists de DNS através de permutações.

🛠️ Instalação

Se você quiser fazer modificações localmente e compilá-lo, siga as instruções abaixo:

> git clone https://github.com/Josue87/gotator.git
> cd gotator
> go build

Se você está interessado apenas em usar o programa:

> go install github.com/Josue87/gotator@latest

🐳 Docker opção:

> git clone https://github.com/Josue87/gotator.git
> cd gotator
> docker build -t gotator . 
# Uso 
> docker run gotator -sub subdomains.txt  [...]

Nota Se você estiver usando a versão 1.16 ou superior e tiver algum erro, execute o seguinte comando:

> go env -w GO111MODULE="auto"

Para atualizar a versão, adicione o parâmetro -u ao comando de instalação.

✨ Funcionalidades

Gotator possui as seguintes funcionalidades para permutação:

• Verifica domínio e TLD analisando ccSLDs para evitar sair do escopo (example.com, example.com.mx, etc.).
• Permuta números para cima e para baixo [-numbers ], por exemplo:
  • O subdomínio alvo é 10 e a flag numbers está definida para 3 [-numbers 3], como resultado teremos entre 7 e 13.
  • O subdomínio alvo é dev1 e a flag numbers está definida para 3 [-numbers 3], veremos dev0, dev1, dev2, dev3 e dev4 (evitando números negativos).
  • O subdomínio alvo é test10-demo2 e a flag numbers está definida para 1 [-numbers 1], entre os resultados veremos test11-demo2.example.com, test9-demo2.example.com, test10-demo3.example.com ou test10-demo1.example.com. (Apenas um número muda por vez).
• Gotator tem 3 níveis de profundidade [-depth ]:
  • Se depth estiver definido como 1 (modo padrão), para permutar a palavra test em , obteremos .

🗒 Opções

As flags que podem ser usadas para executar a ferramenta:

👾 Uso

gotator -sub domains.txt -perm permutations.txt -depth 2 -numbers 5 > output.txt

Para filtrar o resultado e remover possíveis duplicatas:

gotator -sub domains.txt -perm permutations.txt -depth 3 -numbers 10 -md | uniq > output2.txt

Substitua uniq por sort -u do comando anterior se quiser ordená-los. (Não recomendado devido ao tempo)

Nota: Se você estiver compilando localmente, não se esqueça do ./ na frente do seu binário!

🚀 Exemplos

Nota: Os exemplos podem corresponder a versões anteriores (onde -mindup e adv não eram usados).

Temos as seguintes listas:

No primeiro exemplo, mutamos no subdomínio especificado

No exemplo a seguir, instruímos Gotator a extrair possíveis domínios dos subdomínios com -md:

Você pode ver que example.com é levado em consideração. Agora um exemplo com uma lista de permutações contendo test100demo e damos o argumento -numbers 3:

É possível ver uma profundidade de mutação maior e também especificar o parâmetro prefixes (que adiciona uma pequena lista de mutação).

O último exemplo mostra apenas parte da saída.

Finalmente, um exemplo com modo silencioso e diferentes profundidades com redirecionamento de saída para um arquivo.

👉 Aviso Legal

Esta ferramenta pode gerar arquivos de tamanho enorme e algumas duplicatas, recomendamos filtrar a saída com uniq ou sort -u e tomar cuidado com a flag depth devido ao tamanho da saída (é fácil gerar arquivos > 10 GB). Lembre-se de que a saída canalizada para outras ferramentas exige que a ferramenta processe toda a saída de uma só vez (sort, uniq).

• Exemplos:

# Filtrar saída por tamanho
gotator -sub subs.txt -perm perm.txt -depth 2 -numbers 5 -md | head -c 1G > output1G.txt

# Filtrar saída por linhas
gotator -sub subs.txt -perm perm.txt -depth 3 -mindup -numbers 20 | head -n 100000 > output100Klines.txt

# Linhas únicas ordenadas
gotator -sub subs.txt -perm perm.txt -depth 2 -mindup -numbers 10 -prefixes | sort -u > outputSortUnique.txt

# Linhas únicas (remove apenas linhas duplicadas consecutivas)
gotator -sub subs.txt -perm perm.txt -depth 3 -mindup | uniq > outputUnique.txt

# Linhas únicas
gotator -sub subs.txt -perm perm.txt -depth 3 -mindup -adv | anew > outputAnew.txt

# Linhas únicas ordenadas com limite de tamanho
gotator -sub subs.txt -perm perm.txt -prefixes -adv | head -c 1G | sort -u > output1GSortedUnique.txt

Nota: Exemplos foram dados usando sort -u, isso irá diminuir a geração de resultados. Não há necessidade de ordenar os resultados, é recomendado usar anew.

Aviso: Esta ferramenta gera muita informação de saída, é recomendado usar a flag mindup para reduzir o número de linhas.