DocumentaciónAjuda

Criar uma integração

Registre um sistema da sua empresa (SIEM, EDR, inventário ou outro) para que ele envie seus eventos à plataforma.

Nesta página

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

  1. Acesse Configurações → Integrações.

  2. Clique em Nova integração (ou Criar uma integração se você ainda não tem nenhuma).

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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.

  8. 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.

Relacionado

Pesquisar em SofIA Gestão

Digite pelo menos 2 letras para pesquisar em SofIA Gestão.

↑↓ navegar · Enter abrir · Esc fechar