Exploit Mapper

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

Возможности

Импорт из нескольких форматов: поддержка отчетов об уязвимостях в форматах CSV и Excel от различных сканеров (Nessus, Qualys, Arctic Wolf, OpenVAS и других)
Автоматическое определение колонок: интеллектуальное сопоставление названий колонок, характерных для конкретного сканера, со стандартными полями
Обогащение данными об эксплойтах: автоматический поиск по каталогу CISA KEV (известных эксплуатируемых уязвимостей) и Exploit-DB
Движок оценки рисков: контекстные оценки рисков на основе CVSS, наличия эксплойтов и критичности активов
Ручное добавление уязвимостей (несистемные): возможность вручную добавить уязвимости, которые сканер не может обнаружить; например, использование TLS v1 для приложения XYZ
Интерактивная панель управления: индикатор риска в реальном времени, разбивка по уровням серьезности и анализ тенденций
Управление устройствами: отслеживание уязвимостей по хостам/устройствам с информацией об ОС и критичности
Отслеживание устранения: рабочий процесс статусов, назначение и отслеживание исправлений
Аутентификация пользователей: управление доступом на основе ролей (администратор, пользователь, наблюдатель)
Безопасная архитектура: проверка файлов в соответствии с OWASP, хеширование паролей PBKDF2, управление сессиями

*** Использование процесса обогащения CVE при первой загрузке замедляет процесс загрузки; он будет пытаться обогатить только те загруженные уязвимости, которые отмечены как эксплуатируемые в ваших сканах, но время может значительно варьироваться в зависимости от размера загружаемого файла.*** Загрузки

Панель управления

Панель управления предоставляет обзор состояния вашей безопасности с первого взгляда:

Общий индикатор оценки риска
Диаграммы распределения серьезности
Основные эксплуатируемые уязвимости
Отслеживание прогресса устранения

Список уязвимостей

Просмотр, фильтрация и сортировка уязвимостей по:

Серьезности, оценке риска, CVSS
Наличию эксплойта
Статусу CISA KEV
Хосту/устройству
Статусу (Открыто, В работе, Решено)

Список уязвимостей

Детали уязвимости

Подробное представление, включающее:

Рекомендации сканера
Требуемые действия CISA KEV
Сценарии атак
Связанные результаты на разных устройствах
Рабочий процесс устранения

Детали уязвимости

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

Node.js >= 18.0.0
npm >= 9.0.0
Git (для клонирования репозитория)
Современный веб-браузер (Chrome, Firefox, Edge, Safari)

Установка предварительных требований

Windows

Вариант A: Использование установщика

Загрузите Node.js LTS с https://nodejs.org
Запустите установщик и следуйте инструкциям
Убедитесь, что опция "Добавить в PATH" отмечена во время установки
Откройте новое окно командной строки или PowerShell и проверьте:
```
node --version
npm --version
```

Вариант B: Использование стабильной версии Node (рекомендуется)

Загрузите nvm-windows https://github.com/coreybutler/nvm-windows
Запустите установщик и следуйте инструкциям

nvm install 22.12.0
nvm use 22.12.0

Вариант C: Использование winget (Менеджер пакетов Windows)

winget install OpenJS.NodeJS.LTS
winget install Git.Git

Вариант D: Использование Chocolatey

choco install nodejs-lts
choco install git

macOS

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

brew install node
brew install git

Или загрузите установщик с https://nodejs.org

Проверьте установку:

node --version
npm --version

Linux (Ubuntu/Debian)

# Использование репозитория NodeSource для последней LTS
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs git

# Проверка
node --version
npm --version

Установка

1. Клонирование репозитория

macOS / Linux:

git clone https://github.com/jrokz2315/exploit-mapper.git
cd exploit-mapper

Windows (Командная строка):

git clone https://github.com/jrokz2315/exploit-mapper.git
cd exploit-mapper

Windows (PowerShell):

git clone https://github.com/jrokz2315/exploit-mapper.git
cd exploit-mapper

2. Установка зависимостей

Все платформы:

npm run install:all

Или установите вручную:

macOS / Linux:

npm install
cd server && npm install
cd ../client && npm install
cd ..

Windows (Командная строка):

npm install
cd server && npm install
cd ..\client && npm install
cd ..

Windows (PowerShell):

npm install
cd server; npm install
cd ..\client; npm install
cd ..

Примечание (Windows): Если возникнут ошибки с better-sqlite3, возможно, потребуется установить инструменты сборки Windows:
npm install --global windows-build-tools
Или установите Visual Studio Build Tools с рабочей нагрузкой "Разработка классических приложений на C++" с https://visualstudio.microsoft.com/visual-cpp-build-tools/

3. Запуск приложения

Режим разработки (с горячей перезагрузкой) — все платформы:

npm run dev

Это запускает как серверную часть (порт 3000), так и клиентский сервер разработки (порт 5173).

Производственный режим — все платформы:

# Сборка клиента
npm run build

# Запуск сервера
npm start

4. Доступ к приложению

Откройте браузер и перейдите по адресу:

Разработка: http://localhost:5173
Продакшн: http://localhost:3000

5. Вход по умолчанию

При первом запуске создается учетная запись администратора по умолчанию:

Имя пользователя: admin
Пароль: Admin123!

При первом входе в систему вам будет предложено изменить этот пароль.

Структура проекта

exploit-mapper/
├── client/                 # React фронтенд
│   ├── src/
│   │   ├── components/     # Переиспользуемые UI-компоненты
│   │   ├── pages/          # Компоненты страниц
│   │   └── App.jsx         # Главный компонент приложения
│   ├── package.json
│   └── vite.config.js
├── server/                 # Express бэкенд
│   ├── src/
│   │   ├── db/             # Схема базы данных и подключение
│   │   ├── middleware/     # Промежуточное ПО аутентификации
│   │   ├── routes/         # Маршруты API
│   │   └── services/       # Бизнес-логика
│   ├── data/               # База данных SQLite (в gitignore)
│   ├── uploads/            # Временное хранилище загрузок (в gitignore)
│   └── package.json
├── package.json            # Корневой package.json со скриптами
├── .gitignore
├── LICENSE
├── CONTRIBUTING.md
└── README.md

Конечные точки API

Аутентификация

Панель управления

Уязвимости

Устройства

Загрузка

Отчеты

Метод	Конечная точка	Описание
`GET`	`/api/reports`	Список загруженных отчетов
`GET`	`/api/reports/:id/export`	Экспорт отчета

Поддерживаемые форматы сканеров

Exploit Mapper автоматически определяет и сопоставляет столбцы из различных сканеров уязвимостей:

Сопоставление столбцов

Парсер автоматически сопоставляет распространенные названия столбцов:

Оценка рисков

Индивидуальная оценка риска уязвимости

Оценка риска = Оценка CVSS + Корректировки

Корректировки:
  +0,5 если в CISA KEV (активно эксплуатируется)
  +0,3 если доступен публичный эксплойт

Общая оценка риска организации

Общий = (Макс. риск x 30%) + (Средн. риск x 40%) + (Средн. эксплуат. x 20%) + (Плотность x 10%)

При наличии CISA KEV: умножение на 1,05

Конфигурация

Переменные окружения

Создайте файл .env в каталоге server/ (опционально — см. server/.env.example):

PORT=3000
NODE_ENV=production
SESSION_SECRET=your-secret-key

База данных

Exploit Mapper использует SQLite для хранения без необходимости настройки. База данных автоматически создается в server/data/exploit-mapper.db при первом запуске.

Вопросы безопасности

Пароли хешируются с использованием PBKDF2 с 100 000 итераций и SHA-512
Токены сессии представляют собой криптографически стойкие 256-битные случайные значения
Загрузки файлов проверяются по типу, размеру (макс. 500 МБ) и магическим байтам
SQL-запросы используют параметризованные выражения повсеместно
CORS настроен только для источника фронтенда
Учетная запись администратора по умолчанию требует смены пароля при первом входе

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

Часто встречающиеся проблемы

Порт уже занят

Windows:

netstat -ano | findstr :3000
taskkill /PID <pid> /F

macOS / Linux:

lsof -i :3000
kill -9 <pid>

Ошибки сборки better-sqlite3 в Windows

Для этого нативного модуля требуются инструменты сборки C++:

:: Вариант 1: Установка через npm
npm install --global windows-build-tools

:: Вариант 2: Установка Visual Studio Build Tools
:: Загрузите с https://visualstudio.microsoft.com/visual-cpp-build-tools/
:: Выберите рабочую нагрузку "Разработка классических приложений на C++"

После установки удалите node_modules и переустановите:

cd server
rmdir /s /q node_modules
npm install

База данных заблокирована

Убедитесь, что запущен только один экземпляр сервера. В Windows:

tasklist | findstr node
taskkill /IM node.exe /F

В macOS / Linux:

pkill -f "node.*index.js"

Ошибка загрузки

Проверьте размер файла (макс. 500 МБ)
Убедитесь, что файл имеет формат .csv, .xlsx или .xls
Проверьте, что файл содержит хотя бы столбец названия/имени
Проверьте консоль сервера на наличие подробных сообщений об ошибках

npm run dev не работает в Windows

Если `concurrently» не работает, попробуйте запустить сервер и клиент отдельно в двух окнах терминала:

Терминал 1 (Сервер):

cd server
npm run dev

Терминал 2 (Клиент):

cd client
npm run dev

Вклад в проект

Подробные рекомендации см. в CONTRIBUTING.md.

Сделайте форк репозитория
Создайте ветку для функции (git checkout -b feature/amazing-feature)
Зафиксируйте свои изменения (git commit -m 'Add amazing feature')
Отправьте изменения в ветку (git push origin feature/amazing-feature)
Откройте Pull Request

Лицензия

Этот проект лицензирован под лицензией MIT — подробности см. в файле LICENSE.

Благодарности

CISA KEV Catalog за информацию об эксплойтах
NVD за данные CVE
Exploit-DB за информацию об эксплойтах
Lucide Icons за набор иконок
Tailwind CSS за стилизацию
Recharts за визуализацию данных

`POST`	`/api/auth/login`	Вход пользователя
`POST`	`/api/auth/logout`	Выход пользователя
`GET`	`/api/auth/me`	Получить текущего пользователя
`POST`	`/api/auth/change-password`	Сменить пароль

`GET`	`/api/dashboard/summary`	Метрики панели управления
`GET`	`/api/dashboard/risk`	Разбивка по рискам
`GET`	`/api/dashboard/trends`	Исторические тенденции
`GET`	`/api/dashboard/executive-summary`	Сводка для руководства

`GET`	`/api/vulnerabilities`	Список (с фильтрацией/пагинацией)
`GET`	`/api/vulnerabilities/:id`	Детали уязвимости
`GET`	`/api/vulnerabilities/exploitable`	Только эксплуатируемые
`GET`	`/api/vulnerabilities/stats/summary`	Статистика
`PATCH`	`/api/vulnerabilities/:id`	Обновить статус
`PATCH`	`/api/vulnerabilities`	Массовое обновление
`POST`	`/api/vulnerabilities/manual`	Добавить ручную запись
`DELETE`	`/api/vulnerabilities/:id`	Удалить ручную запись

`GET`	`/api/devices`	Список устройств
`GET`	`/api/devices/:id`	Детали устройства
`PATCH`	`/api/devices/:id`	Обновить информацию об устройстве

`POST`	`/api/upload`	Загрузить отчет об уязвимостях
`GET`	`/api/upload/info`	Статистика загрузок
`DELETE`	`/api/upload/clear`	Очистить все данные

Exploit-Mapper

Популярное

Arctic Wolf	столбцы `risk_id`, `asset_category`
Nessus/Tenable	столбец `plugin_id`
Qualys	столбец `qid`
OpenVAS	столбец `nvt`
Nexpose/Rapid7	идентификатор `nexpose`
Generic CSV/Excel	интеллектуальное сопоставление названий столбцов

CVE	`cve`, `cves`, `cve_id`, `vulnerability_id`
Название	`name`, `title`, `vulnerability`, `plugin_name`
Описание	`description`, `synopsis`, `summary`
Решение	`solution`, `remediation`, `fix`, `recommendation`
Серьезность	`severity`, `risk_severity`, `risk_level`
Оценка CVSS	`cvss`, `cvss_score`, `cvssv3_score`
Хост	`hostname`, `asset_name`, `host_name`, `fqdn`
IP-адрес	`ip_address`, `host_ip`, `asset_ip`

Максимальная оценка риска	30%	Наивысший риск отдельной уязвимости
Средняя оценка риска	40%	Среднее по всем уязвимостям
Средний риск эксплуатируемых	20%	Среднее только по эксплуатируемым уязвимостям
Фактор плотности	10%	`log10(общее_количество_уязвимостей + 1) x 3` (макс. 10)