Integrações
GET /integrations
Lista as integrações configuradas do tenant (tipo, estado, última sincronização, contagem de findings).
POST /integrations
Regista/atualiza uma integração (upsert).
Body:
{
"type": "MICROSOFT_365",
"name": "Tenant M365 produção",
"config": {},
"credentials": {}
}
type (IntegrationType) suporta: JIRA, SLACK, TEAMS, AWS, AZURE, GCP, QUALYS, TENABLE, CROWDSTRIKE, OKTA, AZURE_AD, WAZUH, ETERSCAN, PROWLER, GLPI, OPENCTI, GOOGLE_WORKSPACE, GITHUB, MICROSOFT_365, CNCS, SERVICENOW, ASANA, AUTHENTIK, FLEET, BACKUP_REPORT. O tipo FLEET (MDM Fleet, fonte de dispositivos do módulo de IT) tem cartão próprio em Definições → Integrações e é sincronizado pelo integrations-sync. É por este endpoint genérico que se ligam Microsoft 365/Azure AD, GCP, Google Workspace, AWS, Azure, Okta, GitHub e CNCS, não existem endpoints REST dedicados por fornecedor além dos casos abaixo.
ENTRA_PROVISIONING não é aceite por este endpoint. O Microsoft 365 em modo escrita (JML) só se configura pelo cartão próprio em Definições → Integrações (valida as permissões, exige administrador e audita). Um POST com type = ENTRA_PROVISIONING devolve 400 (Tipo não permitido pela API).
Autenticação do GET: chave de API ou sessão de browser. Com sessão (usada pelo formulário de testes de controlo) a resposta não inclui config (URLs e opções de cada integração); com chave de API inclui-o. O POST continua a exigir chave de API.
POST /integrations/:id/sync
Força sincronização de uma integração. Nesta versão só suporta integrações do tipo WAZUH (retorna 400 para qualquer outro tipo). Rate limit: 5 syncs/min.
POST /integrations/wazuh/findings · GET /integrations/wazuh/findings
Ingestão (POST) e consulta (GET) de findings do Wazuh-SCA-Bot. Autenticação diferente: headers x-etershield-key (o segredo de integração do Wazuh) + x-tenant-id, não x-api-key. O pedido é rejeitado se o segredo não estiver configurado.
Corpo validado de forma estrita, 400 com detalhe de campo em caso de payload inválido:
resultaceita"passed","failed","not_applicable"(underscore, forma normalizada enviada pelo produtor real) e"not applicable"(com espaço)synced_ataceita datetime ISO com offset (+00:00), não sóZfindingsé um array, vazio é válido: significa que a policy já não tem falhas e alimenta a resolução automática de findings antigos; nunca dá400por estar vazio- Só findings com severidade CRITICAL ou HIGH geram um registo de Risk, um único Risk por par agente × policy, nunca um Risk por cada check individual falhado
POST /integrations/wazuh/incidents
Cria incidente a partir de um alerta Wazuh (nível de regra ≥ 12). Autenticação: chave de API do tenant (x-api-key ou Bearer), ao contrário de findings, agents e alert-rollups, não usa x-etershield-key. Rate limit: 60 req/min por tenant.
POST /integrations/suricata/ingest
Ingestão de eventos EVE JSON do Suricata IDS. Autenticação por x-etershield-key (o segredo de ingestão do Suricata) + x-tenant-id. Alertas CRITICAL (C2/malware/trojan) escalam automaticamente para um Incidente.
POST /integrations/jira/webhook · POST /integrations/opencti/sync · POST /integrations/prowler/findings · GET/POST/DELETE /integrations/slack · GET/POST/DELETE /integrations/teams · POST /integrations/eterscan/findings
Endpoints de integração específicos por fornecedor (Jira, OpenCTI, Prowler, Slack, Teams, EterScan). Autenticação por chave de API, com duas exceções: slack e teams exigem sessão de browser (configuração feita no dashboard) e jira/webhook exige x-api-key + x-tenant-id (e, se estiver configurado um segredo de webhook, a assinatura HMAC). Os restantes endpoints de ingestão Wazuh (agents, alert-rollups) e POST /wazuh/enroll estão no índice no fim.