engagement-mgr — O Engagement Manager é uma aplicação web para rastrear engajamentos de segurança ofensiva. Ele apresenta uma interface moderna, construída com Next.js, Prisma e PostgreSQL. | Kitploit

Espaço de trabalho de escrita: abra o link Write & review de um achado para edição em Markdown e uma pré-visualização segura. Rascunhos privados são salvos após 15 segundos de inatividade ou sob demanda; eles são armazenados no servidor, não no armazenamento local do navegador. Recupere um rascunho explicitamente após reabri-lo. Salvamentos conflitantes preservam o texto do editor e exigem comparação com a revisão atual. Revisões de texto podem ser inspecionadas e restauradas; restaurar não restaura evidências excluídas.
Modelos reutilizáveis: pesquise texto aprovado por título, categoria ou severidade. Usuários podem propor modelos; administradores os curam e aprovam. Aplicar um modelo cria um achado de engajamento independente com observações vazias, hosts afetados e evidências, evitando a reutilização acidental da prova de outro engajamento.
Evidências: faça upload ou cole até quatro imagens PNG/JPEG juntas, adicione legendas e edite legenda/ordem no espaço de trabalho de escrita. As imagens são decodificadas, têm metadados removidos, são redimensionadas para no máximo 2000 × 2000 pixels e salvas como PNG. Mantenha evidências forenses originais separadamente se os bytes originais ou metadados forem necessários.
Revisão: envie achados completos de Draft/Changes Requested para Ready. Um revisor designado ou administrador, diferente do autor atual, pode aprovar ou solicitar alterações. Administradores designam revisores. Alterações de texto, evidências e revisões restauradas limpam a aprovação. A fila de revisão, comentários, checklist de prontidão e histórico de revisões apoiam a transferência.
Relatórios PDF: escolha um engajamento em Reports, escreva seu resumo executivo, selecione/ordene achados e salve as configurações. Rascunhos de PDF são visivelmente marcados. Apenas administradores podem emitir um PDF final, e cada achado selecionado deve estar aprovado e passar nas verificações de prontidão. Cada versão emitida armazena seu PDF, snapshot de conteúdo explícito e digest SHA-256; edições posteriores não o regeneram. Excluir o engajamento pai ainda exclui seus relatórios através do ciclo de vida existente.
Importações de scanner: pré-visualize uma exportação, selecione achados e confirme. Importações nunca executam varreduras ou contatam alvos. A impressão digital do lado do servidor ignora achados correspondentes no mesmo engajamento; todos os novos registros começam como Draft e devem ser verificados por um operador.

Família de scanner/exportação	Exportação aceita
Burp Suite	Issues XML, incluindo o DTD de esquema interno inerte
Nessus / Tenable	Nessus v2 XML (`.nessus`)
Nmap	XML; portas abertas e sua saída de script tornam-se observações informativas, não vulnerabilidades inferidas
OpenVAS / Greenbone	Relatório XML nativo ou GMP `get_reports_response`
OWASP ZAP	Relatório JSON tradicional com sites e alertas
Nuclei	JSON Lines (`-jsonl`)
Qualys	XML de resultado de varredura (estrutura `SCAN/IP`), não o formato separado da API de detecção de hosts
Semgrep / CodeQL e outros produtores SARIF	Execuções, regras e resultados SARIF JSON

`npm test` usa o modo de teste não isolado do Node com `tsx` para que os casos de teste TypeScript individuais sejam executados, em vez de apenas relatar o sucesso do subprocesso do arquivo. Mantenha os totais de asserções explícitos visíveis no CI.

As regressões de banco de dados e navegador exigem um **banco de dados local dedicado chamado `reporting_tests`**, com as migrações aplicadas. Elas criam e excluem suas próprias linhas de fixture; nunca aponte esses testes para um banco de dados de aplicação. Defina `REPORTING_TEST_DATABASE_URL` para esse banco de dados de teste e, em seguida, execute:```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` fornece `pg_dump`, `pg_restore` e `psql`; `zip` cria arquivos de backup. A extração de restauração é tratada pela aplicação com validação estrita de entradas e tamanho.

A instalação dos pacotes nem sempre deixa o PostgreSQL em execução. Inicie e habilite o serviço antes de criar funções ou iniciar a aplicação:```bash
sudo systemctl enable --now postgresql
sudo systemctl status postgresql --no-pager

| Variável | Obrigatória | Notas |
|----------|----------|-------|
| `DATABASE_URL` | Sim | String de conexão PostgreSQL. O Prisma usa o parâmetro de consulta `schema=public`. O backup e a restauração usam um arquivo pgpass temporário somente para o proprietário, para que a senha não seja colocada em argumentos de subprocesso. |
| `JWT_SECRET` | Sim em produção | Deve ter pelo menos **32 caracteres**. A aplicação recusa-se a iniciar em produção sem ele. A rotação deste valor invalida todas as sessões existentes. |
| `TRUST_PROXY` | Não | Defina como `1` (ou `true`) apenas quando a aplicação estiver atrás de um proxy reverso que **sobrescreve** `X-Forwarded-For` / `X-Real-IP` e `X-Forwarded-Host`. As verificações de origem de login usam `X-Forwarded-Host` quando presente neste modo; deve conter um host público, incluindo uma porta não padrão quando utilizada. Caso contrário, o proxy deve preservar o cabeçalho `Host` público. Esta é a topologia de produção necessária para limites precisos de login por origem. Quando não definido, os cabeçalhos são ignorados para evitar falsificação e o login usa um orçamento de fallback compartilhado de um minuto mais elevado, para que um cliente não possa impor um bloqueio global de 15 minutos. |
| `ALLOWED_DEV_ORIGINS` | Não | **Apenas em desenvolvimento.** Nomes de host adicionais autorizados a carregar recursos `/_next` (separados por vírgulas). Os endereços IPv4 atuais da LAN do servidor são permitidos automaticamente. Use isto para um nome DNS estável. As compilações de produção ignoram isto. |

Gere um segredo forte:```bash
openssl rand -base64 32

### Produção

Use um usuário de banco de dados dedicado com **privilégio mínimo** — não conceda `CREATEDB` nem direitos de superusuário:```bash
sudo -u postgres createuser --pwprompt em_app
sudo -u postgres createdb --owner=em_app engagement_manager

O script instala os pré-requisitos, inicia e habilita o serviço PostgreSQL, solicita um nome de usuário e senha do banco de dados, grava um `.env` com `chmod 600`, cria a role e o banco de dados PostgreSQL, aplica as migrações e popula a conta de administrador padrão. O modo de produção também conclui o `npm run build` e imprime apenas o comando de inicialização de produção. Ele não instala o Node.js a partir de um script de shell remoto; instale primeiro uma versão suportada do Node.js.

Para uso headless ou em 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

Instale as dependências do Node.js: ```bash npm ci
Execute as migrações do banco de dados para criar as tabelas: ```bash npx prisma migrate dev
Popule o banco de dados para criar a conta de Administrador padrão: ```bash npx prisma db seed

Deixe essa janela aberta. Use o endereço Local ou Network que ela exibe.

Para iniciá-lo você mesmo: o PostgreSQL precisa estar em execução (`sudo systemctl start postgresql` se necessário). Em seguida, inicie o servidor de desenvolvimento:```bash
npm run dev

`npm run dev` e `npm start` vinculam a `0.0.0.0` para que a URL de Rede funcione na LAN. Trate o acesso à LAN como exclusivo para laboratório em uma rede confiável. O modo de desenvolvimento não está reforçado para a internet pública.

Se você abrir o aplicativo por **hostname** (não IP) e o navegador remoto exibir uma página branca em branco, adicione esse nome ao `.env` e reinicie:```bash
ALLOWED_DEV_ORIGINS=dev.office.example

Clone o repositório e instale as dependências: ```bash npm ci
Crie .env com valores de produção (DATABASE_URL, JWT_SECRET ≥ 32 caracteres).
Aplique as migrações do banco de dados: ```bash npm run db:migrate
Execute as verificações pré-implantação: ```bash npm run audit npm run typecheck npm run build
Inicie a aplicação com NODE_ENV=production: ```bash NODE_ENV=production npm run start

Caminho	Conteúdo
`engagement-manager-backup/database.dump`	Despejo completo do PostgreSQL em formato personalizado (esquema, tabelas, dados, enums, relações) do `pg_dump`
`engagement-manager-backup/uploads/`	Ficheiros de captura de ecrã de achados referenciados na base de dados

Inicie sessão como um utilizador Admin.
Abra Admin e clique em Backup (em Database).
Guarde o .zip e copie-o para o novo servidor (por exemplo com scp ou rsync): ```bash scp em-backup-2026-06-02-1430.zip user@new-server:/path/to/

Instale os Pré-requisitos e clone o repositório.
Crie o .env com DATABASE_URL e JWT_SECRET (consulte Configuração de Ambiente).
Crie um banco de dados PostgreSQL vazio e um usuário (consulte Configuração do Banco de Dados).
Instale as dependências: npm ci.
Execute as migrações e o seed uma vez para que um Admin possa fazer login. A restauração substitui esses dados de bootstrap pelo backup.
Compile e inicie o aplicativo em modo de produção (consulte Implantação em Produção): ```bash npm run build NODE_ENV=production npm run start
Faça login como admin usando o initial-admin-credentials.txt exclusivo do proprietário, altere a palavra-passe temporária e elimine o ficheiro de credenciais.
Abra Admin (/dashboard/users), clique em Restore (em Database), selecione o .zip do servidor antigo, introduza a sua palavra-passe de administrador e confirme.
Reinicie a aplicação se já estiver em execução para que esta carregue os dados restaurados.

Abra prisma/schema.prisma e adicione o campo ao modelo pretendido: ```prisma model Engagement { id String @id @default(uuid()) codeName String focus String? // new field ... }
Toda alteração em prisma/schema.prisma deve ser seguida de: ```bash npx prisma migrate dev --name describe_your_change

Autenticação e Contas: A conta admin padrão é gerada via seed do Prisma. Os papéis Admin têm acesso total de criação/edição/exclusão a todos os registros. Os papéis User podem criar, editar e excluir findings e screenshots; todas as outras entidades (engagements, clients, contacts, operators) são somente leitura para usuários. Cada página do dashboard atualiza a sessão em relação ao banco de dados antes de ler dados confidenciais. Apenas admins podem acessar a página Admin (/dashboard/users), gerenciar contas, alterar a cor de destaque de toda a aplicação e fazer backup, restaurar ou redefinir o banco de dados. Backup, restauração e redefinição exigem reconfirmação de senha. A criação de um backup é uma Server Action; o download pelo navegador usa GET /api/db/backup?file=… com a sessão de Admin e uma concessão assinada de cinco minutos em um cookie HttpOnly.
Gerenciamento de Sessão: As sessões usam JWTs do jose armazenados em cookies HttpOnly, SameSite=Lax e uma linha Session correspondente no lado do servidor que o logout revoga. A expiração do cookie é intencionalmente omitida para manter o comportamento de sessão do navegador; tanto o token assinado quanto o registro no banco de dados expiram após um dia. A admissão transacional retém no máximo dez sessões ativas por conta.
Segurança da Aplicação:
- O Next.js Edge Proxy (src/proxy.ts) impõe verificações de sessão e rotação de senha a cada 90 dias em todas as rotas protegidas.
- As Next.js Server Actions reduzem o risco de CSRF com proteções de mesma origem integradas.
- O Prisma mitiga automaticamente a injeção de SQL parametrizando todas as consultas.
- O React mitiga XSS escapando automaticamente elementos HTML na renderização.
- As screenshots são armazenadas com permissões somente do proprietário e cotas agregadas/por finding limitadas. A exclusão usa marcadores pendentes recuperáveis; a inicialização do dashboard, uploads e backups reconciliam arquivos em disco com referências do banco de dados, com falhas de limpeza registradas na saída de auditoria, erros detalhados nos logs do servidor e um aviso exibido aos administradores. A reconciliação falha do dashboard tenta novamente no máximo uma vez por minuto por processo; uploads e backups ainda validam o armazenamento imediatamente. A rota autenticada /api/uploads previne IDOR e retorna respostas no-store.

endReporting

outbrief

objectives

targets

exclusions

notes

operators

contacts

trustedAgents

findings

findingContexts

createdAt

updatedAt

engagement-mgr

Mais Populares

Escrevendo achados e produzindo relatórios PDF

Segurança de relatórios e implantação

Verificação```bash

Pré-requisitos

Configuração do Ambiente

Configuração do Banco de Dados

Desenvolvimento

Instalação

Configuração automatizada (Ubuntu)

Notas de atualização para configuração reforçada e backups

Configuração manual

Executando a Aplicação

Implantação em Produção

Requisitos

Passos de implantação

Lista de verificação para produção

Credenciais Predefinidas

Migração de servidor (Backup / Restore / Reset)

Plano de Implementação e Arquitetura

Stack Tecnológica

Esquema da Base de Dados

Adicionar Novos Campos

Arquitetura de Segurança