Os webhooks fornecem dados a outras aplicações, desencadeados por certos eventos utilizando HTTP POST. Sempre que ocorre um evento, a origem envia um pedido HTTP para a aplicação de destino configurada para o webhook.

O VMware Edge Network Intelligence suporta Webhooks e permite que os administradores:
  • Selecionem incidentes com base nos critérios de correspondência.
  • Enviem os incidentes selecionados e as informações relacionadas ao recetor webhook configurado alojado num sistema de terceiros.

Ao receberem as notificações, os sistemas de terceiros podem relatá-los ou desencadear fluxos de trabalho automatizados ou notificar os utilizadores finais automaticamente em tempo real.

Procedimento

  1. No painel de navegação, clique em A minha conta (My Account) > Definições de administrador (Admin Settings).
  2. Na janela Definições de administrador (Admin Settings), clique em Integração externa (External Integration) e clique no separador Webhook.
  3. Na página Webhook, clique em Adicionar configuração do Webhook (Add Webhook Configuration).
    Introduza os parâmetros seguintes:
    Opção Descrição
    Nome Introduza um nome para o webhook.
    URL do Webhook Introduza um URL HTTPS válido. Este serve como a aplicação de destino para os webhooks.
    Código de resposta Introduza um código de estado de resposta HTTP esperado para cada destinatário webhook.
    Código de autenticação Especifique um código de autenticação para cada destinatário configurado do webhook, que é utilizado para calcular um HMAC para cada pedido do Webhook enviado ao destinatário correspondente. Na maior parte dos recetores webhook, o HMAC está incorporado num cabeçalho HTTP X-Webhook-Signature, juntamente com um parâmetro de versão, que identifica o algoritmo de assinatura e um carimbo de data/hora.
    Clique em Adicionar alerta (Add Alert) para configurar os incidentes que devem enviar informações para o recetor webhook.
    Tipo de alerta Descrição Modelo JSON Enviar alertas para
    Ocorrência de incidente Coloque o interruptor deslizante na posição LIGADO (ON) para ativar a ocorrência de incidentes.

    O VMware Edge Network Intelligence entrega notificações de alerta a cada destinatário do webhook, através de uma carga útil JSON contida no corpo de um pedido HTTP POST de saída.

    O modelo JSON consiste nos seguintes parâmetros:
    • ID
    • Descrição
    • Prioridade
    • Número de dispositivos afetados
    • Causas-raiz do alerta
    • Passos seguintes sugeridos
    • Intervalo de tempo
    • Ligação do incidente
    Segue-se um modelo de carga útil JSON de exemplo. 
    {
     "id": "p-1131935905",
     "description": "DHCP protocol/latency issues affected clients",
     "priority": "2",
     "affected": "237 out of 2358 devices affected (10.1%)",
     "rootcauses": "Server is not reachable or Server is not configured",
     "nextsteps": "Please check if DHCP server is reachable from clients VLAN",
     "timeInterval": "07:15 - 08:15 on 7/19 PDT"
     "incidentLink": "https://company.bogus/campus/ui/analysis#/incidents/SERVERS.dnsServerQoE_5minRunAvg?fr=1642_164300&incident-id=p1234"
}
    		 Selecione parâmetros como prioridade e eventos para os quais os alertas devem ser enviados.
    Indisponibilidades do crawler Coloque o interruptor deslizante na posição LIGADO (ON) para identificar o crawler com problemas de indisponibilidade.
    O modelo JSON consiste nos seguintes parâmetros:
    • ID
    • Nome
    • Endereços IP
    • Problema
    Segue-se um modelo de carga útil JSON de exemplo. 
    {
    id: "623e00b144fe5ed7959f44bd", 
    name: "Crawler-9",
    ips: ["192.0.2.0"], 
    issue: "Lost WAN/SPAN connectivity"
}
    		 Clique na ligação + Adicionar crawler (+ Add Crawler) e adicione os crawlers para os quais os alertas devem ser enviados.
  4. Clique em Guardar (Save). O separador Webhook apresenta os webhooks criados.

Resultados

Sempre que um incidente é desencadeado, é enviada uma mensagem de alerta juntamente com informações relevantes para o URL de destino.

No separador Webhook, pode clicar num webhook existente para ver os detalhes configurados, o estado da última notificação e o histórico de notificações dos incidentes.