Генератор PDF-отчётов на основе Nuclei

Профессиональный инструмент автоматизации, предназначенный для устранения разрыва между техническим сканированием уязвимостей и отчётностью для руководства. Разработан Adi Mahluf (Tenroot Cyber Security).

🚀 Обзор

Этот проект предоставляет простой в использовании рабочий процесс «одной команды» для аудита веб-ресурсов. Он использует высокопроизводительный движок Nuclei для выявления уязвимостей и ошибок конфигурации, а затем автоматически преобразует необработанные результаты в отформатированный, готовый для клиента PDF-отчёт. Он специально разработан для архитекторов безопасности и команд реагирования на инциденты, которым необходимо предоставлять заинтересованным сторонам чёткие и практические данные.

🛠️ Предварительные требования

Чтобы инструмент работал корректно в различных средах, на вашей рабочей станции должны быть установлены следующие компоненты.

1. Движок Nuclei (v3.x+)

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

go install -v [github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest](https://github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest)

2. Python 3 и виртуальное окружение

Скрипт отчёта требует Python 3.10+ и библиотеку fpdf2 для современных возможностей PDF и поддержки Unicode.

Инструкции по настройке:

# Install venv tools if missing (Ubuntu/WSL)
sudo apt update && sudo apt install python3-venv python3-full -y
# Create and configure the environment
python3 -m venv venv
./venv/bin/pip install fpdf2

3. Вспомогательные инструменты

Необходимы для управления разрешениями скриптов и межплатформенной кодировкой.

sudo apt install dos2unix -y

📥 Установка

1. Клонируйте репозиторий:

git clone [https://github.com/YourUsername/Nuclei-PDF-Generator.git](https://github.com/YourUsername/Nuclei-PDF-Generator.git)
cd Nuclei-PDF-Generator

2. Исправьте кодировку и права доступа: Убедитесь, что скрипты имеют права на выполнение и используют окончания строк Unix.

chmod +x scan.sh
dos2unix scan.sh generate_report.py

3. Добавьте свой брендинг: Поместите логотип вашей компании в корневую папку проекта и назовите его точно logo.png.

##📑 Использование Запустите скрипт аудита, указав целевой домен. По умолчанию скрипт использует скрытый режим (с ограничением скорости), чтобы избежать блокировки межсетевыми экранами веб-приложений (WAF).

./scan.sh <domain_name> [--aggressive]

• Пример (скрытый): ./scan.sh tenroot.io
• Пример (агрессивный): ./scan.sh internal-site.local --aggressive

Инструмент сгенерирует файл с именем: Report_domain.com_YYYYMMDD-HHMM.pdf.

📋 Возможности отчёта

• Сводка по рискам для руководства: Общее количество находок, классифицированных от критических до информационных.
• Детальные находки: Технические описания каждой выявленной уязвимости или технологии, включая затронутый URL.
• Рекомендации по устранению: Практические пошаговые инструкции по смягчению последствий, взятые непосредственно из шаблонов Nuclei.

📷 Изображения

⚠️ Устранение неполадок

Отказ от ответственности: Этот инструмент предназначен только для авторизованного тестирования безопасности. Разработчик не несёт ответственности за неправомерное использование или ущерб, причинённый данным приложением.