/   | __  __/ /_____  / __ \(_)____/ /_  __  _______/ /____  _____
                   / /| |/ / / / __/ __ \/ / / / / ___/ __ \/ / / / ___/ __/ _ \/ ___/
                  / ___ / /_/ / /_/ /_/ / /_/ / / /  / /_/ / /_/ (__  ) /_/  __/ /
                 /_/  |_\__,_/\__/\____/_____/_/_/  /_.___/\__,_/____/\__/\___/_/

### Автоматический запуск и сохранение сканирований ffuf для нескольких IP-адресов

## Содержание
  * [Быстрый запуск](#quick-run)
  * [ЧАВО](#faq)
    * [Зачем?](#why)
    * [Какое использование рекомендуется?](#what-is-the-recommended-usage)
    * [Какие данные требуются?](#what-data-does-this-need)
    * [Как работает этот скрипт?](#how-does-this-script-work)
    * [Эта программа не работает](#this-program-isnt-working)
  * [Использование](#usage)

## Быстрый запуск

## ЧАВО
### Зачем?
Ffuf — отличный инструмент для перебора каталогов, но запуск его на нескольких IP-адресах и портах — очень ручной процесс с большим количеством простоев между сканированиями. Этот скрипт пытается автоматизировать этот процесс и устраняет простои между сканированиями.

### Какое использование рекомендуется?
**Если атакуете несколько целей:**
* Запустите Nmap и найдите открытые порты
* Просмотрите результаты Nmap и создайте список IP:порт, по одному на строку
* Запустите AutoDirbuster для открытых портов
* AutoDirbuster определит, является ли служба HTTP-основанной

  * `python AutoDirbuster.py ip_port_list.txt -w my_wordlist.txt --combine`

**Если атакуете одну цель:**

* `python AutoDirbuster.py -u example.com:80 -w my_wordlist.txt`

**Полезные опции включают:**

| Опция            | Назначение                                                          |
|------------------|---------------------------------------------------------------------|
| --dns            | Разрешать IP-адреса в имена хостов                                   |
| --extensions     | Расширения файлов, используемые при сканировании                    |
| --rate           | Скорость запросов в секунду                                          |
| --timeout        | Установить значение тайм-аута для каждого хоста в минутах           |
| --match-codes    | Совпадение с указанными HTTP-кодами состояния                       |
| --combine        | Объединить все CSV-результаты в один файл после сканирования        |
| --quiet          | Подавить вывод stderr от ffuf (эквивалент 2>/dev/null)              |
| --custom-option  | Указать опцию ffuf, которая не поддерживается AutoDirbuster по умолчанию |

Укажите флаг `--help` для полного списка опций.

### Какие данные требуются?
Программа может принимать два источника данных:
1. Список IP:порт или имя_хоста:порт, по одному на строку

* `python AutoDirbuster.py ip_port_list.txt -w my_wordlist.txt`

2. Одна цель

* `python AutoDirbuster.py -u example.com:80 -w my_wordlist.txt`

### Как работает этот скрипт?
* Предоставляется список целей
* Отправляются HTTPS- и HTTP-запросы, чтобы определить, является ли служба HTTP-основанной и требует ли она TLS (сам HTTP-запрос служит проверкой связности — отдельное сканирование TCP-портов не требуется)
* Если HTTPS завершается ошибкой согласования TLS, перед откатом к обычному HTTP предпринимается попытка с нестрогим контекстом TLS
* Если служба HTTP, выполняется проверка, существует ли в той же директории предыдущий файл отчёта
  * Файлы отчётов имеют формат: `ffuf-report-{proto}_{target}_{port}`
* Ffuf запускается с помощью `subprocess.Popen()` в Python
* Следующий IP:порт проходит тот же процесс (запрос HTTP-службы, перебор каталогов)

### Эта программа не работает
Убедитесь в следующем:
* Установлены ли все зависимости, перечисленные в `requirements.txt`?
* Установлен ли `ffuf` и находится ли он в вашем системном пути?
  * Попробуйте выполнить `ffuf -V`
  * Инструкции по установке можно найти на [странице репозитория ffuf на GitHub](https://github.com/ffuf/ffuf)
* Возможно, вам понадобится Python 3.11+
  * Информацию о версии можно получить, выполнив `python -V`

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