маскот ffuf

ffuf - Фаззь быстрее, дурак!

Быстрый веб-фаззер, написанный на Go.

Установка

Скачайте готовый бинарный файл со страницы релизов, распакуйте и запускайте!

или
Если вы на Windows и используете Scoop, ffuf можно установить с помощью: scoop install ffuf

или
Если вы на Windows и используете Winget, ffuf можно установить с помощью: winget install ffuf.ffuf

или
Если вы на macOS и используете homebrew, ffuf можно установить с помощью: brew install ffuf

или
Если у вас установлен свежий компилятор Go: go install github.com/ffuf/ffuf/v2@latest (эта же команда работает и для обновления)

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

Ffuf требует Go 1.20 или новее.
Сборка go из чекаута показывает git-<date>-<commit> вместо тега. Локальная сборка не является официальным релизом, даже если вы находитесь на теге; встроенная в Go информация о сборке содержит коммит, но не имя тега — поэтому мы показываем точный коммит, из которого была выполнена сборка. Авторитетными версионированными бинарными файлами являются те, что находятся на странице релизов.

Примеры использования

Примеры использования ниже демонстрируют лишь простейшие задачи, которые можно выполнить с помощью ffuf.

Более подробная документация, охватывающая множество функций с большим количеством примеров, доступна в вики ffuf по адресу https://github.com/ffuf/ffuf/wiki

За более обширной документацией с примерами из реальной жизни и советами обязательно загляните в отличное руководство: «Everything you need to know about FFUF» от Майкла Скелтона (@codingo).

Вы также можете потренироваться в сканировании ffuf против живого хоста с разными уроками и сценариями использования: либо локально, используя docker-контейнер https://github.com/adamtlangley/ffufme, либо против живой размещённой версии на http://ffuf.me, созданной Адамом Лэнгли @adamtlangley.

Типичное обнаружение директорий

Используя ключевое слово FUZZ в конце URL (-u):

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

Обнаружение виртуальных хостов (без DNS-записей)

Предполагая, что размер ответа виртуального хоста по умолчанию составляет 4242 байта, мы можем отфильтровать все ответы такого размера (-fs 4242), фаззя заголовок Host:

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

Фаззинг GET-параметров

Фаззинг имён GET-параметров очень похож на обнаружение директорий и работает путём определения ключевого слова FUZZ как части URL. Здесь также предполагается, что неверное имя GET-параметра даёт ответ размером 4242 байта.

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

Если имя параметра известно, значения можно фаззить тем же способом. В этом примере предполагается, что неверное значение параметра возвращает HTTP-код ответа 401.

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

Фаззинг POST-данных

Это очень простая операция, снова с использованием ключевого слова FUZZ. В этом примере фаззится только часть POST-запроса. Мы снова отфильтровываем ответы с кодом 401.

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

Максимальное время выполнения

Если вы не хотите, чтобы ffuf работал бесконечно, используйте -maxtime. Это останавливает весь процесс по истечении заданного времени (в секундах).

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

При работе с рекурсией вы можете управлять максимальным временем для каждой задачи с помощью -maxtime-job. Это остановит текущую задачу по истечении заданного времени (в секундах) и продолжит со следующей. Новые задачи создаются, когда функция рекурсии обнаруживает поддиректорию.

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

Также можно комбинировать оба флага, ограничивая как максимальное время выполнения для каждой задачи, так и общее время выполнения. Если вы не используете рекурсию, оба флага ведут себя одинаково.

Использование внешнего мутатора для создания тест-кейсов

В этом примере мы будем фаззить JSON-данные, отправляемые через POST. В качестве мутатора используется Radamsa.

При использовании --input-cmd ffuf отображает совпадения по их позиции. Это же значение позиции будет доступно вызываемой команде как переменная окружения $FFUF_NUM. Мы будем использовать это значение позиции в качестве сида для мутатора. Файлы example1.txt и example2.txt содержат корректные JSON-нагрузки. Мы сопоставляем все ответы, но отфильтровываем код ответа 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

Конечно, вызывать мутатор для каждой нагрузки не очень эффективно, поэтому мы можем также предварительно сгенерировать нагрузки, всё ещё используя Radamsa в качестве примера:

# 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

Конфигурационные файлы

При запуске ffuf сначала проверяет, существует ли файл конфигурации по умолчанию. Путь по умолчанию для файла ffufrc — $XDG_CONFIG_HOME/ffuf/ffufrc. Вы можете настроить в этом файле одну или несколько опций, и они будут применяться к каждой последующей задаче ffuf. Пример файла ffufrc можно найти здесь.

Более подробное описание расположения файлов конфигурации можно найти в вики: https://github.com/ffuf/ffuf/wiki/Configuration

Опции конфигурации, указанные в командной строке, переопределяют опции, загруженные из файла ffufrc по умолчанию. Примечание: это не относится к флагам CLI, которые можно указывать более одного раза. Одним из таких примеров является флаг -H (заголовок). В этом случае значения -H, указанные в командной строке, будут добавлены к значениям из файла конфигурации.

Кроме того, если вы хотите использовать несколько файлов конфигурации для разных сценариев, вы можете сделать это, указав путь к файлу конфигурации с помощью флага командной строки -config, который принимает путь к файлу конфигурации в качестве параметра.

Использование

Чтобы задать тест-кейс для ffuf, используйте ключевое слово FUZZ в любом месте URL (-u), заголовков (-H) или POST-данных (-d).

Fuzz Faster U Fool - v2.1.0

HTTP OPTIONS:
  -H                  Header `"Name: Value"`, separated by colon. Multiple -H flags are accepted.
  -X                  HTTP method to use
  -b                  Cookie data `"NAME1=VALUE1; NAME2=VALUE2"` for copy as curl functionality.
  -cc                 Client cert for authentication. Client key needs to be defined as well for this to work
  -ck                 Client key for authentication. Client certificate needs to be defined as well for this to work
  -d                  POST data
  -http2              Use HTTP2 protocol (default: false)
  -ignore-body        Do not fetch the response content. (default: false)
  -r                  Follow redirects (default: false)
  -raw                Do not encode URI (default: false)
  -recursion          Scan recursively. Only FUZZ keyword is supported, and URL (-u) has to end in it. (default: false)
  -recursion-depth    Maximum recursion depth. (default: 0)
  -recursion-strategy Recursion strategy: "default" for a redirect based, and "greedy" to recurse on all matches (default: default)
  -replay-proxy       Replay matched requests using this proxy.
  -sni                Target TLS SNI, does not support FUZZ keyword
  -timeout            HTTP request timeout in seconds. (default: 10)
  -u                  Target URL
  -x                  Proxy URL (SOCKS5 or HTTP). For example: http://127.0.0.1:8080 or socks5://127.0.0.1:8080

GENERAL OPTIONS:
  -V                  Show version information. (default: false)
  -ac                 Automatically calibrate filtering options (default: false)
  -acc                Custom auto-calibration string. Can be used multiple times. Implies -ac
  -ach                Per host autocalibration (default: false)
  -ack                Autocalibration keyword (default: FUZZ)
  -acs                Custom auto-calibration strategies. Can be used multiple times. Implies -ac
  -c                  Colorize output. (default: false)
  -config             Load configuration from a file
  -json               JSON output, printing newline-delimited JSON records (default: false)
  -maxtime            Maximum running time in seconds for entire process. (default: 0)
  -maxtime-job        Maximum running time in seconds per job. (default: 0)
  -noninteractive     Disable the interactive console functionality (default: false)
  -p                  Seconds of `delay` between requests, or a range of random delay. For example "0.1" or "0.1-2.0"
  -rate               Rate of requests per second (default: 0)
  -s                  Do not print additional information (silent mode) (default: false)
  -sa                 Stop on all error cases. Implies -sf and -se. (default: false)
  -scraperfile        Custom scraper file path
  -scrapers           Active scraper groups (default: all)
  -se                 Stop on spurious errors (default: false)
  -search             Search for a FFUFHASH payload from ffuf history
  -sf                 Stop when > 95% of responses return 403 Forbidden (default: false)
  -t                  Number of concurrent threads. (default: 40)
  -v                  Verbose output, printing full URL and redirect location (if any) with the results. (default: false)

MATCHER OPTIONS:
  -mc                 Match HTTP status codes, or "all" for everything. (default: 200-299,301,302,307,401,403,405,500)
  -ml                 Match amount of lines in response
  -mmode              Matcher set operator. Either of: and, or (default: or)
  -mr                 Match regexp
  -ms                 Match HTTP response size
  -mt                 Match how many milliseconds to the first response byte, either greater or less than. EG: >100 or <100
  -mw                 Match amount of words in response

FILTER OPTIONS:
  -fc                 Filter HTTP status codes from response. Comma separated list of codes and ranges
  -fl                 Filter by amount of lines in response. Comma separated list of line counts and ranges
  -fmode              Filter set operator. Either of: and, or (default: or)
  -fr                 Filter regexp
  -fs                 Filter HTTP response size. Comma separated list of sizes and ranges
  -ft                 Filter by number of milliseconds to the first response byte, either greater or less than. EG: >100 or <100
  -fw                 Filter by amount of words in response. Comma separated list of word counts and ranges

INPUT OPTIONS:
  -D                  DirSearch wordlist compatibility mode. Used in conjunction with -e flag. (default: false)
  -e                  Comma separated list of extensions. Extends FUZZ keyword.
  -enc                Encoders for keywords, eg. 'FUZZ:urlencode b64encode'
  -ic                 Ignore wordlist comments (default: false)
  -input-cmd          Command producing the input. --input-num is required when using this input method. Overrides -w.
  -input-num          Number of inputs to test. Used in conjunction with --input-cmd. (default: 100)
  -input-shell        Shell to be used for running command
  -mode               Multi-wordlist operation mode. Available modes: clusterbomb, pitchfork, sniper (default: clusterbomb)
  -request            File containing the raw http request
  -request-proto      Protocol to use along with raw request (default: https)
  -w                  Wordlist file path and (optional) keyword separated by colon. eg. '/path/to/wordlist:KEYWORD'

OUTPUT OPTIONS:
  -debug-log          Write all of the internal logging to the specified file.
  -o                  Write output to file
  -od                 Directory path to store matched results to.
  -of                 Output file format. Available formats: json, ejson, html, md, csv, ecsv (or, 'all' for all formats) (default: json)
  -or                 Don't create the output file if we don't have results (default: false)

EXAMPLE USAGE:
  Fuzz file paths from wordlist.txt, match all responses but filter out those with content-size 42.
  Colored, verbose output.
    ffuf -w wordlist.txt -u https://example.org/FUZZ -mc all -fs 42 -c -v

  Fuzz Host-header, match HTTP 200 responses.
    ffuf -w hosts.txt -u https://example.org/ -H "Host: FUZZ" -mc 200

  Fuzz POST JSON data. Match all responses not containing text "error".
    ffuf -w entries.txt -u https://example.org/ -X POST -H "Content-Type: application/json" \
      -d '{"name": "FUZZ", "anotherkey": "anothervalue"}' -fr "error"

  Fuzz multiple locations. Match only responses reflecting the value of "VAL" keyword. Colored.
    ffuf -w params.txt:PARAM -w values.txt:VAL -u https://example.org/?PARAM=VAL -mr "VAL" -c

  More information and examples: https://github.com/ffuf/ffuf

Интерактивный режим

При нажатии ENTER во время выполнения ffuf процесс приостанавливается, и пользователь попадает в интерактивный режим, похожий на оболочку:

entering interactive mode
type "help" for a list of commands, or ENTER to resume.
> help

available commands:
 afc  [value]             - append to status code filter 
 fc   [value]             - (re)configure status code filter 
 afl  [value]             - append to line count filter 
 fl   [value]             - (re)configure line count filter 
 afw  [value]             - append to word count filter 
 fw   [value]             - (re)configure word count filter 
 afs  [value]             - append to size filter 
 fs   [value]             - (re)configure size filter 
 aft  [value]             - append to time filter 
 ft   [value]             - (re)configure time filter 
 rate [value]             - adjust rate of requests per second (active: 0)
 queueshow                - show job queue
 queuedel [number]        - delete a job in the queue
 queueskip                - advance to the next queued job
 restart                  - restart and resume the current ffuf job
 resume                   - resume current ffuf job (or: ENTER) 
 show                     - show results for the current job
 savejson [filename]      - save current matches to a file
 help                     - you are looking at it
>

В этом режиме можно перенастроить фильтры, управлять очередью и сохранить текущее состояние на диск.

При (пер)настройке фильтров они применяются задним числом, и все ложноположительные совпадения из памяти, которые были бы отфильтрованы вновь добавленными фильтрами, удаляются.

Новое состояние совпадений можно вывести с помощью команды show, которая выводит все совпадения так, как если бы они были найдены ffuf.

Поскольку «отрицательные» совпадения не сохраняются в памяти, ослабление фильтров, к сожалению, не может вернуть потерянные совпадения. В таком сценарии пользователь может использовать команду restart, которая сбрасывает состояние и запускает текущую задачу с начала.

Участие в разработке

Сообщения об ошибках, запросы функций и пул-реквесты приветствуются. Начните с CONTRIBUTING.md, а раздел вики «Contributing» содержит документацию по архитектуре и тестированию.

Лицензия

ffuf выпущен под лицензией MIT. См. LICENSE.

ffuf v2.2.1

Категории