Gotator

Gotator est un outil pour générer des listes de mots DNS via des permutations.

🛠️ Installation

Si vous souhaitez effectuer des modifications localement et le compiler, suivez les instructions ci-dessous :

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

Si vous êtes uniquement intéressé par l'utilisation du programme :

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

🐳 Option Docker :

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

Remarque Si vous utilisez la version 1.16 ou supérieure et que vous rencontrez des erreurs, exécutez la commande suivante :

> go env -w GO111MODULE="auto"

Pour mettre à niveau la version, ajoutez le paramètre -u à la commande d'installation.

✨ Fonctionnalités

Gotator dispose des fonctionnalités suivantes pour la permutation :

• Vérifie le domaine et le TLD en analysant les ccSLD afin d'éviter de sortir du cadre (example.com, example.com.mx, etc.).
• Permute les nombres vers le haut et vers le bas [-numbers ], par exemple :
  • Le sous-domaine cible est 10 et le flag numbers est défini à 3 [-numbers 3], en résultat nous aurons entre 7 et 13.
  • Le sous-domaine cible est dev1 et le flag numbers est défini à 3 [-numbers 3], nous verrons dev0, dev1, dev2, dev3 et dev4 (en évitant les nombres négatifs).
  • Le sous-domaine cible est test10-demo2 et le flag numbers est défini à 1 [-numbers 1], parmi les résultats nous verrons test11-demo2.example.com, test9-demo2.example.com, test10-demo3.example.com ou test10-demo1.example.com. (Un seul nombre change à la fois).
• Gotator dispose de 3 niveaux de profondeur [-depth ] :
  • Si la profondeur est définie à 1 (mode par défaut), pour permuter le mot test sur , nous obtiendrons .

🗒 Options

Les flags qui peuvent être utilisés pour lancer l'outil :

👾 Utilisation

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

Pour filtrer le résultat et supprimer les doublons éventuels :

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

Remplacez uniq par sort -u dans la commande précédente si vous souhaitez les trier. (Déconseillé en raison du temps)

Remarque : Si vous compilez localement, n'oubliez pas le ./ devant votre binaire !

🚀 Exemples

Remarque : Les exemples peuvent correspondre à des versions antérieures (où -mindup et adv n'étaient pas utilisés).

Nous avons les listes suivantes :

Dans le premier exemple, nous mutons sur le sous-domaine spécifié

Dans l'exemple suivant, nous demandons à Gotator d'extraire les domaines possibles à partir des sous-domaines avec -md :

Vous pouvez voir que example.com est pris en compte. Maintenant un exemple avec une liste de permutations contenant test100demo et nous donnons l'argument -numbers 3 :

Il est possible de voir une plus grande profondeur de mutation et également de spécifier le paramètre prefixes (qui ajoute une petite liste de mutations).

Le dernier exemple montre uniquement une partie de la sortie.

Enfin, un exemple avec le mode silencieux et différentes profondeurs avec redirection de la sortie vers un fichier.

👉 Avertissement

Cet outil peut générer des fichiers de très grande taille et des doublons, nous vous encourageons à filtrer la sortie avec uniq ou sort -u et à faire attention au flag depth en raison de la taille de la sortie (il est facile de générer des fichiers > 10 GB). Gardez à l'esprit que la sortie canalisée vers d'autres outils nécessite que l'outil traite l'ensemble de la sortie en une seule fois (sort, uniq).

• Exemples :

# Filtrer la sortie par taille
gotator -sub subs.txt -perm perm.txt -depth 2 -numbers 5 -md | head -c 1G > output1G.txt

# Filtrer la sortie par lignes
gotator -sub subs.txt -perm perm.txt -depth 3 -mindup -numbers 20 | head -n 100000 > output100Klines.txt

# Trier les lignes uniques
gotator -sub subs.txt -perm perm.txt -depth 2 -mindup -numbers 10 -prefixes | sort -u > outputSortUnique.txt

# Lignes uniques (supprime uniquement les lignes en double qui se suivent) 
gotator -sub subs.txt -perm perm.txt -depth 3 -mindup | uniq > outputUnique.txt

# Lignes uniques 
gotator -sub subs.txt -perm perm.txt -depth 3 -mindup -adv | anew > outputAnew.txt

# Trier unique avec limite de taille
gotator -sub subs.txt -perm perm.txt -prefixes -adv | head -c 1G | sort -u > output1GSortedUnique.txt

Remarque : Des exemples ont été donnés en utilisant sort -u, ce qui ralentira la génération des résultats. Il n'est pas nécessaire de trier les résultats, il est recommandé d'utiliser anew.

Avis : Cet outil génère beaucoup d'informations en sortie, il est recommandé d'utiliser le flag mindup pour réduire le nombre de lignes.