mascotte ffuf

ffuf - Fuzz Faster U Fool

Un fuzzer web rapide écrit en Go.

Installation

Téléchargez un binaire précompilé depuis la page des releases, décompressez-le et exécutez-le !

ou
Si vous êtes sous Windows avec Scoop, ffuf peut être installé avec : scoop install ffuf

ou
Si vous êtes sous Windows avec Winget, ffuf peut être installé avec : winget install ffuf.ffuf

ou
Si vous êtes sous macOS avec homebrew, ffuf peut être installé avec : brew install ffuf

ou
Si vous avez un compilateur Go récent installé : go install github.com/ffuf/ffuf/v2@latest (la même commande fonctionne pour la mise à jour)

ou
git clone https://github.com/ffuf/ffuf ; cd ffuf ; go get ; go build

Ffuf dépend de Go 1.20 ou supérieur.
Une compilation Go à partir d'un checkout affiche git-<date>-<commit> plutôt que le tag. Une compilation locale n'est pas une release officielle, même lorsque vous êtes sur un tag, et les informations de compilation intégrées de Go nous donnent le commit mais pas le nom du tag — nous affichons donc le commit exact à partir duquel il a été compilé. Les binaires versionnés faisant autorité sont ceux de la page des releases.

Exemples d'utilisation

Les exemples d'utilisation ci-dessous montrent les tâches les plus simples que vous pouvez accomplir avec ffuf.

Une documentation plus détaillée qui parcourt de nombreuses fonctionnalités avec beaucoup d'exemples est disponible dans le wiki ffuf à l'adresse https://github.com/ffuf/ffuf/wiki

Pour une documentation plus complète, avec des exemples d'utilisation réels et des astuces, n'hésitez pas à consulter l'excellent guide : « Everything you need to know about FFUF » de Michael Skelton (@codingo).

Vous pouvez également vous entraîner à vos scans ffuf contre un hôte en ligne avec différentes leçons et cas d'utilisation, soit localement en utilisant le conteneur docker https://github.com/adamtlangley/ffufme, soit contre la version hébergée en ligne à l'adresse http://ffuf.me créée par Adam Langley @adamtlangley.

Découverte typique de répertoires

En utilisant le mot-clé FUZZ à la fin de l'URL (-u) :

ffuf -w /path/to/wordlist -u https://target/FUZZ

Découverte de virtual hosts (sans enregistrements DNS)

En supposant que la taille de réponse du virtualhost par défaut est de 4242 octets, nous pouvons filtrer toutes les réponses de cette taille (-fs 4242) tout en fuzzant l'en-tête Host :

ffuf -w /path/to/vhost/wordlist -u https://target -H "Host: FUZZ" -fs 4242

Fuzzing de paramètres GET

Le fuzzing des noms de paramètres GET est très similaire à la découverte de répertoires, et fonctionne en définissant le mot-clé FUZZ comme une partie de l'URL. Cela suppose également une taille de réponse de 4242 octets pour un nom de paramètre GET invalide.

ffuf -w /path/to/paramnames.txt -u https://target/script.php?FUZZ=test_value -fs 4242

Si le nom du paramètre est connu, les valeurs peuvent être fuzzées de la même manière. Cet exemple suppose qu'une valeur de paramètre incorrecte renvoie le code de réponse HTTP 401.

ffuf -w /path/to/values.txt -u https://target/script.php?valid_name=FUZZ -fc 401

Fuzzing de données POST

C'est une opération très simple, encore une fois en utilisant le mot-clé FUZZ. Cet exemple ne fuzze qu'une partie de la requête POST. Nous filtrons à nouveau les réponses 401.

ffuf -w /path/to/postdata.txt -X POST -d "username=admin\&password=FUZZ" -u https://target/login.php -fc 401

Temps d'exécution maximal

Si vous ne voulez pas que ffuf s'exécute indéfiniment, vous pouvez utiliser -maxtime. Cela arrête tout le processus après un temps donné (en secondes).

ffuf -w /path/to/wordlist -u https://target/FUZZ -maxtime 60

Lorsque vous travaillez avec la récursivité, vous pouvez contrôler le maxtime par tâche en utilisant -maxtime-job. Cela arrêtera la tâche en cours après un temps donné (en secondes) puis passera à la suivante. De nouvelles tâches sont créées lorsque la fonctionnalité de récursivité détecte un sous-répertoire.

ffuf -w /path/to/wordlist -u https://target/FUZZ -maxtime-job 60 -recursion -recursion-depth 2

Il est également possible de combiner les deux drapeaux pour limiter à la fois le temps d'exécution maximal par tâche et le temps d'exécution global. Si vous n'utilisez pas la récursivité, les deux drapeaux se comportent de la même manière.

Utilisation d'un mutateur externe pour générer des cas de test

Pour cet exemple, nous allons fuzzer des données JSON envoyées via POST. Radamsa est utilisé comme mutateur.

Lorsque --input-cmd est utilisé, ffuf affichera les correspondances selon leur position. Cette même valeur de position sera disponible pour le programme appelé comme variable d'environnement $FFUF_NUM. Nous utiliserons cette valeur de position comme graine pour le mutateur. Les fichiers example1.txt et example2.txt contiennent des payloads JSON valides. Nous matchons toutes les réponses, mais nous filtrons le code de réponse 400 - Bad request :

ffuf --input-cmd 'radamsa --seed $FFUF_NUM example1.txt example2.txt' -H "Content-Type: application/json" -X POST -u https://ffuf.io.fi/FUZZ -mc all -fc 400

Il n'est bien sûr pas très efficace d'appeler le mutateur pour chaque payload, nous pouvons donc aussi pré-générer les payloads, en utilisant toujours Radamsa comme exemple :

# Generate 1000 example payloads
radamsa -n 1000 -o %n.txt example1.txt example2.txt

# This results into files 1.txt ... 1000.txt
# Now we can just read the payload data in a loop from file for ffuf

ffuf --input-cmd 'cat $FFUF_NUM.txt' -H "Content-Type: application/json" -X POST -u https://ffuf.io.fi/ -mc all -fc 400

Fichiers de configuration

Lors de l'exécution de ffuf, il vérifie d'abord si un fichier de configuration par défaut existe. Le chemin par défaut pour un fichier ffufrc est $XDG_CONFIG_HOME/ffuf/ffufrc. Vous pouvez configurer une ou plusieurs options dans ce fichier, et elles seront appliquées à chaque tâche ffuf ultérieure. Un exemple de fichier ffufrc peut être trouvé ici.

ffuf v2.2.1