Integrações/Conectores
Phishing: Integração GoPhish
O que é
Integração completa com o GoPhish para gestão de campanhas de phishing simulado diretamente no EterShield.
Como configurar
Em Settings → Integrações → Gophish:
| Campo | Exemplo |
|---|---|
| URL | https://<o-seu-servidor-gophish>:3333 |
| API Key | Gerada no GoPhish → Account Settings |
Para receber eventos em tempo real, configurar o webhook no GoPhish apontando para:
POST https://etershield.etergrowth.com/api/v1/phishing/webhook
Header: X-Gophish-Signature: <hmac-sha256>
O segredo para o HMAC é definido na configuração do webhook do EterShield.
Endpoints de gestão
| Método | Endpoint | Descrição | Role mínimo |
|---|---|---|---|
| GET | /api/v1/phishing/campaigns |
Lista campanhas | VIEWER |
| POST | /api/v1/phishing/campaigns |
Criar campanha | MANAGER |
| GET | /api/v1/phishing/campaigns/[id] |
Detalhe de campanha | VIEWER |
| PATCH | /api/v1/phishing/campaigns/[id] |
Atualizar campanha | MANAGER |
| DELETE | /api/v1/phishing/campaigns/[id] |
Eliminar campanha | ADMIN |
| POST | /api/v1/phishing/campaigns/[id]/launch |
Lançar campanha no GoPhish | ADMIN/MANAGER |
Webhook de entrada (eventos GoPhish)
POST /api/v1/phishing/webhook
X-Gophish-Signature: sha256=<hmac>
Content-Type: application/json
O endpoint valida a assinatura HMAC-SHA256 (fail-closed, rejeita se a assinatura estiver ausente ou inválida). Eventos processados: clicked, reported.
Sincronização automática
O job scheduler phishing-sync (cada 30min) sincroniza o estado de campanhas ACTIVE com o GoPhish, atualizando métricas (emails enviados, clicados, reportados).
O que produz
Métricas de campanha disponíveis no módulo Sensibilização → Phishing do dashboard.
Em breveEsta página estará disponível em breve.