engagement-mgr — Engagement Manager — это веб-приложение для отслеживания проектов в области наступательной безопасности. Оно отличается современным интерфейсом, созданным с использованием Next.js, Prisma и PostgreSQL. | Kitploit

Рабочее пространство для написания: откройте ссылку Write & review находки для редактирования Markdown и безопасного предпросмотра. Приватные черновики сохраняются после 15 секунд бездействия или по требованию; они хранятся на сервере, а не в локальном хранилище браузера. Восстановите черновик явно после повторного открытия. Конфликтующие сохранения сохраняют текст редактора и требуют сравнения с текущей ревизией. Текстовые ревизии можно просматривать и восстанавливать; восстановление не восстанавливает удалённые доказательства.
Многоразовые шаблоны: поиск утверждённых формулировок по названию, категории или серьёзности. Пользователи могут предлагать шаблоны; администраторы отбирают и утверждают их. Применение шаблона создаёт независимую находку проекта с пустыми наблюдениями, затронутыми хостами и доказательствами, предотвращая случайное повторное использование доказательств другого проекта.
Доказательства: загрузите или вставьте до четырёх изображений PNG/JPEG одновременно, добавьте подписи и редактируйте подпись/порядок в рабочем пространстве для написания. Изображения декодируются, очищаются от метаданных, масштабируются до максимум 2000 × 2000 пикселей и сохраняются как PNG. Храните оригинальные криминалистические доказательства отдельно, если требуются исходные байты или метаданные.
Проверка: отправляйте полные находки из статуса Draft/Changes Requested в Ready. Назначенный рецензент или администратор, отличный от текущего автора, может одобрить или запросить изменения. Администраторы назначают рецензентов. Изменения текста, доказательств и восстановленных ревизий сбрасывают одобрение. Очередь проверки, комментарии, чек-лист готовности и история ревизий поддерживают передачу работы.
PDF-отчёты: выберите проект в разделе Reports, напишите его резюме для руководства, выберите/упорядочьте находки и сохраните настройки. Черновики PDF визуально помечены. Только администраторы могут выпустить финальный PDF, и каждая выбранная находка должна быть одобрена и пройти проверки готовности. Каждая выпущенная версия хранит свой PDF, явный снимок содержимого и дайджест SHA-256; последующие изменения не пересоздают его. Удаление родительского проекта по-прежнему удаляет его отчёты через существующий жизненный цикл.
Импорт сканеров: просмотрите экспорт, выберите находки, затем подтвердите. Импорт никогда не выполняет сканирование и не связывается с целями. Серверное отпечатывание пропускает совпадающие находки в том же проекте; все новые записи начинаются как Draft и должны быть проверены оператором.

Семейство сканера/экспорта	Принимаемый экспорт
Burp Suite	Issues XML, включая инертную внутреннюю схему DTD
Nessus / Tenable	Nessus v2 XML (`.nessus`)
Nmap	XML; открытые порты и их вывод скриптов становятся информационными наблюдениями, а не выведенными уязвимостями
OpenVAS / Greenbone	Собственный XML-отчёт или GMP `get_reports_response`
OWASP ZAP	Традиционный JSON-отчёт с сайтами и оповещениями
Nuclei	JSON Lines (`-jsonl`)
Qualys	XML результата сканирования (структура `SCAN/IP`), а не отдельный формат API обнаружения хостов
Semgrep / CodeQL и другие производители SARIF	SARIF JSON runs, rules и results

`npm test` использует неизолированный режим тестирования Node с `tsx`, чтобы отдельные тестовые случаи TypeScript действительно выполнялись, а не просто сообщался успех подпроцесса файла. Сохраняйте явные итоговые значения утверждений видимыми в CI.

Регрессионные тесты базы данных и браузера требуют **выделенной локальной базы данных с именем `reporting_tests`** с применёнными миграциями. Они создают и удаляют свои собственные строки фикстур; никогда не направляйте эти тесты на базу данных приложения. Установите `REPORTING_TEST_DATABASE_URL` на эту тестовую базу данных, затем выполните:```bash
DATABASE_URL="$REPORTING_TEST_DATABASE_URL" npx prisma migrate deploy
npm run test:reporting
npx playwright install chromium
npm run test:browser

`postgresql-client` предоставляет `pg_dump`, `pg_restore` и `psql`; `zip` создаёт архивы резервных копий. Извлечение при восстановлении обрабатывается приложением со строгой проверкой записей и размера.

Установка пакетов не всегда оставляет PostgreSQL запущенным. Запустите и включите службу перед созданием ролей или запуском приложения:```bash
sudo systemctl enable --now postgresql
sudo systemctl status postgresql --no-pager

| Переменная | Обязательна | Примечания |
|----------|----------|-------|
| `DATABASE_URL` | Да | Строка подключения к PostgreSQL. Prisma использует параметр запроса `schema=public`. Резервное копирование и восстановление используют временный файл pgpass, доступный только владельцу, чтобы пароль не попадал в аргументы подпроцесса. |
| `JWT_SECRET` | Да в production | Должен содержать не менее **32 символов**. Приложение отказывается запускаться в production без него. Его ротация делает недействительными все существующие сессии. |
| `TRUST_PROXY` | Нет | Установите в `1` (или `true`) только если приложение находится за обратным прокси, который **перезаписывает** `X-Forwarded-For` / `X-Real-IP` и `X-Forwarded-Host`. Проверки источника входа используют `X-Forwarded-Host`, когда он присутствует в этом режиме; он должен содержать один публичный хост, включая нестандартный порт при его использовании. В противном случае прокси должен сохранять публичный заголовок `Host`. Это обязательная топология production для точных ограничений входа по источнику. Если параметр не задан, заголовки игнорируются для предотвращения подмены, а вход использует более высокий общий резервный лимит на одну минуту, чтобы один клиент не мог вызвать глобальную блокировку на 15 минут. |
| `ALLOWED_DEV_ORIGINS` | Нет | **Только для разработки.** Дополнительные имена хостов, которым разрешено загружать ресурсы `/_next` (через запятую). Текущие LAN IPv4-адреса сервера разрешены автоматически. Используйте это для стабильного DNS-имени. Сборки production игнорируют этот параметр. |

Сгенерируйте надёжный секрет:```bash
openssl rand -base64 32

### Продакшн

Используйте выделенного пользователя базы данных с **минимальными привилегиями** — не предоставляйте права `CREATEDB` или суперпользователя:```bash
sudo -u postgres createuser --pwprompt em_app
sudo -u postgres createdb --owner=em_app engagement_manager

Скрипт устанавливает необходимые компоненты, запускает и включает службу PostgreSQL, запрашивает имя пользователя и пароль базы данных, записывает `.env` с правами `chmod 600`, создаёт роль и базу данных PostgreSQL, применяет миграции и заполняет учётную запись администратора по умолчанию. В production-режиме также выполняется `npm run build` и выводится только команда запуска production. Он не устанавливает Node.js из удалённого shell-скрипта; сначала установите поддерживаемую версию Node.js.

Для headless- или CI-использования:```bash
sudo install -d -m 700 -o "$USER" /secure
openssl rand -base64 24 > /secure/db-password
chmod 600 /secure/db-password
./setup.sh -y --db-user=em_admin --db-pass-file=/secure/db-password

Установите зависимости Node.js: ```bash npm ci
Запустите миграции базы данных для создания таблиц: ```bash npx prisma migrate dev
Заполните базу данных, чтобы создать учётную запись администратора по умолчанию: ```bash npx prisma db seed

Оставьте это окно открытым. Используйте адрес Local или Network, который он выводит.

Чтобы запустить его самостоятельно: PostgreSQL должен быть запущен (`sudo systemctl start postgresql` при необходимости). Затем запустите сервер разработки:```bash
npm run dev

`npm run dev` и `npm start` привязываются к `0.0.0.0`, поэтому Network URL работает в локальной сети. Рассматривайте доступ по локальной сети как лабораторный, только в доверенной сети. Режим разработки не усилен для публичного интернета.

Если вы открываете приложение по **имени хоста** (не по IP) и удалённый браузер показывает пустую белую страницу, добавьте это имя в `.env` и перезапустите:```bash
ALLOWED_DEV_ORIGINS=dev.office.example

Клонируйте репозиторий и установите зависимости: ```bash npm ci
Создайте .env с production-значениями (DATABASE_URL, JWT_SECRET ≥ 32 символов).
Примените миграции базы данных: ```bash npm run db:migrate
Запустите проверки перед развёртыванием: ```bash npm run audit npm run typecheck npm run build
Запустите приложение с NODE_ENV=production: ```bash NODE_ENV=production npm run start

Путь	Содержимое
`engagement-manager-backup/database.dump`	Полный дамп PostgreSQL в пользовательском формате (схема, таблицы, данные, перечисления, связи) из `pg_dump`
`engagement-manager-backup/uploads/`	Файлы скриншотов находок, на которые ссылается база данных

Restore принимает только .zip, созданный функцией Backup, и заменяет текущую базу данных и папку uploads/. Восстановление через браузер ограничено 8 МБ, чтобы распаковка не могла монополизировать веб-процесс. Для архива большего размера остановите приложение и выполните npm run db:restore -- /absolute/path/to/em-backup.zip от имени пользователя приложения. Офлайн-команда загружает .env из рабочего каталога и требует непустой DATABASE_URL в .env или в окружении. Она принимает обычные файлы размером до 500 МБ и пропускает каждую запись архива через её лимит расширенного размера. Восстановление базы данных выполняется в одной транзакции; количество записей архива, пути, коэффициенты сжатия и расширенные размеры проверяются перед установкой файлов. Резервное копирование, восстановление, сброс и изменения файлов скриншотов используют общую эксклюзивную блокировку обслуживания, чтобы фиксации базы данных и замены в файловой системе не могли пересекаться. Требует вашего пароля администратора для подтверждения.
Reset стирает все данные приложения, восстанавливает цвет выделения по умолчанию (красный) и заново создаёт admin. Требует ввести RESET и повторно ввести текущий пароль подтверждающего администратора. Этот пароль становится временным паролем воссозданной учётной записи и должен быть изменён при первом входе.

Войдите как пользователь Admin.
Откройте Admin и нажмите Backup (в разделе Database).
Сохраните .zip и скопируйте его на новый сервер (например, с помощью scp или rsync): ```bash scp em-backup-2026-06-02-1430.zip user@new-server:/path/to/

Установите Предварительные требования и клонируйте репозиторий.
Создайте .env с DATABASE_URL и JWT_SECRET (см. Конфигурация окружения).
Создайте пустую базу данных PostgreSQL и пользователя (см. Настройка базы данных).
Установите зависимости: npm ci.
Запустите миграции и заполнение один раз, чтобы Администратор мог войти. Восстановление заменит эти начальные данные резервной копией.
Соберите и запустите приложение в production-режиме (см. Развёртывание в production): ```bash npm run build NODE_ENV=production npm run start
Войдите как admin, используя файл initial-admin-credentials.txt, доступный только владельцу, смените временный пароль и удалите файл с учётными данными.
Откройте Admin (/dashboard/users), нажмите Restore (в разделе Database), выберите .zip-файл со старого сервера, введите пароль администратора и подтвердите.
Перезапустите приложение, если оно уже было запущено, чтобы оно подхватило восстановленные данные.

User: id, username, passwordHash, role (Admin, User), lastPasswordChange, lastLogin, sessions, createdAt, updatedAt.
Session: id, userId, expiresAt, createdAt — серверные записи делают каждую подписанную сессию входа индивидуально отзываемой при выходе.
LoginRateLimit: key, count, resetAt — атомарные резервирования попыток входа по источнику и подтверждения пароля. Проверка пароля также имеет ограничение на параллелизм.
ApplicationSetting: единственная запись настроек приложения с highlightColor (Red, Blue, Teal, Green, Purple или Amber) и updatedAt.
Engagement: id, codeName, clientId, chargeCode, status (Prep, Recon, Testing, Reporting, Complete), focus, type (AI, Code_Review, Firewall, Multi, Pentest, Phishing, Physical, Purple_Team, Red_Team, USB_Drop, Vishing, Web_App, Wireless), location (Internal, External), startPrep, endPrep, startRecon, endRecon, startTesting, endTesting, startReporting, , , , , , , (M:N), / (M:N с Contact), , , , .
Client: id, company (столбец БД: companyName), address, city, state, zip, phone (столбец БД: phoneNumber), website, notes, contacts, engagements, createdAt, updatedAt.
Contact: id, clientId, name, title, email, phone (столбец БД: phoneNumber), notes, assignedEngagements, trustedEngagements, createdAt, updatedAt.
Finding: id, engagementId (опционально), title, category, severity, background, remediation, supportingData (столбец БД: supportingLinks), screenshots, engagementContext, createdAt, updatedAt.
EngagementFindingContext: id, engagementId, findingId, observation, affectedHosts, createdAt, updatedAt.
Screenshot: id, findingId, filePath, description, createdAt.
Operator: id, name, title, email, phoneNumber, discord, github, notes, engagements (M:N), createdAt, updatedAt.

Откройте prisma/schema.prisma и добавьте поле в нужную модель: ```prisma model Engagement { id String @id @default(uuid()) codeName String focus String? // new field ... }
Каждое изменение в prisma/schema.prisma должно сопровождаться: ```bash npx prisma migrate dev --name describe_your_change

Аутентификация и учётные записи: Учётная запись admin по умолчанию создаётся через Prisma seed. Роли Admin имеют полный доступ на создание/редактирование/удаление всех записей. Роли User могут создавать, редактировать и удалять находки и скриншоты; все остальные сущности (engagements, clients, contacts, operators) доступны пользователям только для чтения. Каждая страница панели управления обновляет сессию в базе данных перед чтением конфиденциальных данных. Только администраторы могут получить доступ к странице администратора (/dashboard/users), управлять учётными записями, изменять общеприкладной цвет подсветки, а также создавать резервные копии, восстанавливать или сбрасывать базу данных. Резервное копирование, восстановление и сброс требуют повторного подтверждения пароля. Создание резервной копии — это Server Action; загрузка в браузере использует GET /api/db/backup?file=… с сессией администратора и пятиминутным подписанным грантом в cookie HttpOnly.
Управление сессиями: Сессии используют JWT jose, хранящиеся в cookie HttpOnly, SameSite=Lax, и соответствующую серверную строку Session, которую отзывает выход из системы. Срок действия cookie намеренно не указан для сохранения поведения браузерной сессии; как подписанный токен, так и запись в базе данных истекают через один день. Транзакционный допуск сохраняет не более десяти активных сессий на учётную запись.
Безопасность приложения:
- Next.js Edge Proxy (src/proxy.ts) обеспечивает проверки сессии и 90-дневную ротацию пароля для всех защищённых маршрутов.
- Next.js Server Actions снижают риск CSRF благодаря встроенным защитам same-origin.
- Prisma автоматически смягчает SQL-инъекции путём параметризации всех запросов.
- React смягчает XSS путём автоматического экранирования HTML-элементов при рендеринге.
- Скриншоты хранятся с правами доступа только для владельца и ограниченными совокупными квотами и квотами на находку. Удаление использует восстанавливаемые маркеры ожидания; запуск панели управления, загрузки и резервные копии сверяют файлы на диске с ссылками в базе данных, при этом сбои очистки записываются в вывод аудита, подробные ошибки — в серверные логи, а администраторам показывается предупреждение. Неудачная сверка панели управления повторяется не более одного раза в минуту на процесс; загрузки и резервные копии по-прежнему проверяют хранилище немедленно. Аутентифицированный маршрут /api/uploads предотвращает IDOR и возвращает ответы no-store.

endReporting

outbrief

objectives

targets

exclusions

notes

operators

contacts

trustedAgents

findings

findingContexts

createdAt

updatedAt

engagement-mgr

Популярное

Написание находок и создание PDF-отчётов

Безопасность отчётности и развёртывание

Проверка```bash

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

Настройка окружения

Настройка базы данных

Разработка

Установка

Автоматическая настройка (Ubuntu)

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

Ручная настройка

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

Развёртывание в production

Требования

Шаги развёртывания

Контрольный список для продакшена

Учётные данные по умолчанию

Миграция сервера (Backup / Restore / Reset)

План реализации и архитектура

Технологический стек

Схема базы данных

Добавление новых полей

Архитектура безопасности