Gotator

Gotator es una herramienta para generar listas de palabras DNS mediante permutaciones.

🛠️ Instalación

Si deseas realizar modificaciones localmente y compilarlo, sigue las instrucciones a continuación:

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

Si solo estás interesado en usar el programa:

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

🐳 Opción Docker:

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

Nota Si estás usando la versión 1.16 o superior y tienes algún error, ejecuta el siguiente comando:

> go env -w GO111MODULE="auto"

Para actualizar la versión, añade el parámetro -u al comando de instalación.

✨ Características

Gotator tiene las siguientes características para permutación:

• Verifica el dominio y TLD analizando ccSLDs para evitar salir del alcance (example.com, example.com.mx, etc.).
• Permuta números hacia arriba y hacia abajo [-numbers ], por ejemplo:
  • El subdominio objetivo es 10 y el indicador numbers se establece en 3 [-numbers 3], como resultado tendremos entre 7 y 13.
  • El subdominio objetivo es dev1 y el indicador numbers se establece en 3 [-numbers 3], veremos dev0, dev1, dev2, dev3 y dev4 (evitando números negativos).
  • El subdominio objetivo es test10-demo2 y el indicador numbers se establece en 1 [-numbers 1], entre los resultados veremos test11-demo2.example.com, test9-demo2.example.com, test10-demo3.example.com o test10-demo1.example.com. (Solo un número cambia a la vez).
• Gotator tiene 3 niveles de profundidad [-depth ]:
  • Si la profundidad es 1 (modo predeterminado), al permutar la palabra test en , obtendremos .

🗒 Opciones

Los indicadores que se pueden usar para lanzar la herramienta:

👾 Uso

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

Para filtrar el resultado y eliminar posibles duplicados:

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

Cambia uniq por sort -u del comando anterior si quieres ordenarlos. (No recomendado por el tiempo)

Nota: Si estás compilando localmente, ¡no olvides el ./ delante de tu binario!

🚀 Ejemplos

Nota: Los ejemplos pueden corresponder a versiones anteriores (donde no se usaban -mindup ni adv).

Tenemos las siguientes listas:

En el primer ejemplo mutamos sobre el subdominio especificado

En el siguiente ejemplo le indicamos a Gotator que extraiga posibles dominios de los subdominios con -md:

Puedes ver que example.com se tiene en cuenta. Ahora un ejemplo con una lista de permutaciones que contiene test100demo y le damos el argumento -numbers 3:

Es posible ver una mayor profundidad de mutación y también especificar el parámetro prefixes (que añade una pequeña lista de mutación).

El último ejemplo muestra solo parte de la salida.

Finalmente, un ejemplo con modo silencioso y diferentes profundidades con redirección de salida a un archivo.

👉 Aviso legal

Esta herramienta puede generar archivos de gran tamaño y algunos duplicados, recomendamos filtrar la salida con uniq o sort -u y tener cuidado con el indicador depth debido al tamaño de la salida (es fácil generar archivos de más de 10 GB). Ten en cuenta que la salida por tubería a otras herramientas requiere que la herramienta procese toda la salida a la vez (sort, uniq).

• Ejemplos:

# Filtrar salida por tamaño
gotator -sub subs.txt -perm perm.txt -depth 2 -numbers 5 -md | head -c 1G > output1G.txt

# Filtrar salida por líneas
gotator -sub subs.txt -perm perm.txt -depth 3 -mindup -numbers 20 | head -n 100000 > output100Klines.txt

# Ordenar líneas únicas
gotator -sub subs.txt -perm perm.txt -depth 2 -mindup -numbers 10 -prefixes | sort -u > outputSortUnique.txt

# Líneas únicas (solo elimina líneas duplicadas consecutivas)
gotator -sub subs.txt -perm perm.txt -depth 3 -mindup | uniq > outputUnique.txt

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

# Ordenar único con límite de tamaño
gotator -sub subs.txt -perm perm.txt -prefixes -adv | head -c 1G | sort -u > output1GSortedUnique.txt

Nota: Se han dado ejemplos usando sort -u, eso ralentizará la generación de resultados. No es necesario ordenar los resultados, se recomienda usar anew.

Aviso: Esta herramienta genera mucha información de salida, se recomienda usar el indicador mindup para reducir el número de líneas.