Criar uma integração
Registre um sistema da sua empresa (SIEM, EDR, inventário ou outro) para que ele envie seus eventos à plataforma.
Uma integração representa um sistema externo que envia informações à plataforma: por exemplo, o seu Wazuh de produção ou o seu scanner de vulnerabilidades. Ao criá-la, você escolhe o que esse sistema fornece e, se quiser, é gerado na hora o endereço para onde ele enviará seus eventos.
Antes de começar
Você precisa do papel Administrador na sua empresa. Com outro papel, o botão Nova integração aparece desativado e, ao passar o mouse, diz Somente um administrador pode criar integrações.
Tenha em mãos o endereço da API do sistema (se quiser testar a conexão a partir da plataforma) e as credenciais dele, se forem exigidas.
Passos
Acesse Configurações → Integrações.
Clique em Nova integração (ou Criar uma integração se você ainda não tem nenhuma).
Preencha os dados do sistema:
Nome: como você o reconhecerá na plataforma, por exemplo «Wazuh produção».
Categoria: SIEM, SOC, EDR, Scanner de vulnerabilidades, Inventário / CMDB, CRM, Central de serviços (ITSM), Monitoramento, Argunis Monitoring ou Outro.
Fornecedor: o produto, por exemplo
wazuh. Abaixo do campo aparecem sugestões conforme a categoria (por exemplo, para SIEM: wazuh, splunk, sentinel, qradar, elastic); clique em uma para usá-la. Você também pode escrever outro. É salvo em minúsculas.URL base (opcional): o endereço da API do sistema. É usado para testar a conexão.
Rota de saúde (opcional): a rota consultada ao testar a conexão, por exemplo
/health. Se você deixá-la vazia, a URL base é consultada.
Em Autenticação, escolha como a plataforma se identifica perante o sistema e preencha os campos. Explicamos isso em Credenciais de acesso. Se o sistema só enviará eventos e você não precisa testar a conexão, deixe Sem autenticação.
Em O que esta integração fornece, marque o que o sistema enviará: Ativos para o inventário, Alertas, Incidentes ou Vulnerabilidades. Por padrão, Alertas vem marcado.
Se quiser que o mais grave seja atendido sem esperar, marque Abrir incidente automaticamente diante de eventos críticos: os alertas e incidentes de severidade crítica são escalados sozinhos para um incidente.
Deixe marcado Receber eventos por webhook se o sistema enviará seus eventos à plataforma (o normal). Isso gera uma URL e um segredo de assinatura. Se você desmarcar, pode ativá-lo depois a partir do cartão.
Clique em Salvar. O botão é habilitado quando você preenche o Nome e o Fornecedor.
Se você deixou marcado Receber eventos por webhook, ao salvar abre-se a janela Webhook ativado com a URL e o Segredo de assinatura. O segredo é mostrado uma única vez: copie-o antes de fechar. Continue em Ativar o webhook e enviar eventos.
Marque Ativos para o inventário apenas em sistemas de inventário ou descoberta. Se não estiver marcado, os eventos do tipo ativo são guardados, mas não adicionam ativos descobertos.
O que acontece depois
Você verá Integração criada. e um novo cartão na aba Integrações, com o status Ativa. O cartão mostra:
A categoria e o fornecedor.
O que ela fornece (ou Sem capacidades marcadas) e Incidente automático, se você o marcou.
Autenticação, com a pista da credencial salva.
Webhook: Ativo ou Desativado.
Último evento e Última sincronização (no início, Nunca).
URL base e URL do webhook, com um botão para copiá-la.
Quando o sistema enviar seu primeiro evento, Último evento é atualizado e o evento aparece em Eventos recebidos.