O SD-WAN Orchestrator permite configurar alertas que notificam os operadores, administradores empresariais ou outros utilizadores de apoio, sempre que ocorre um evento.

Nota: Se tiver iniciado sessão como utilizador com privilégios de apoio ao cliente, poderá ver os alertas e outros objetos, mas não os poderá configurar.

No portal da empresa, clique em Configurar > Alertas e notificações (Configure > Alerts & Notifications) para configurar os alertas.

Selecione os eventos para os quais os alertas têm de ser enviados e introduza o tempo de atraso da notificação em minutos em Selecionar alertas (Select Alerts).

Pode utilizar o evento EDIT_ALERT_CONFIGURATION para registar as alterações nas configurações de alerta da empresa.

Configurar alertas e notificações

Em Clientes (Customers), são apresentados os dados de contacto dos utilizadores de administração existentes. Pode selecionar as caixas de verificação para e-mail e SMS para enviar alertas aos utilizadores correspondentes.

Os alertas são enviados tanto para a equipa de operadores que gere todo o SD-WAN Orchestrator como para os clientes.

Os alertas que vão para os operadores são denominados alertas de pré-notificação, uma vez que são enviados imediatamente. Os alertas de cliente ou empresa estão sujeitos a atrasos configurados pela administração da empresa.

Por exemplo, um alerta de ligação inativa pode ir para um destino configurado pelo operador e para destinos configurados pelo cliente. Suponhamos que uma ligação está inativa durante um minuto e o cliente configura o atraso de alerta Ligação inativa (Link Down) para 2 minutos. Se os alertas de pré-notificação estiverem ativados para esta ligação, o Orchestrator enviará um alerta de operador para Ligação inativa, mas o cliente não receberá um alerta uma vez que se enquadrava no atraso configurado.

Traps SNMP

As traps do Protocolo SNMP (Simple Network Management Protocol) são notificações enviadas a um agente SNMP para indicar que ocorreu um evento. O SD-WAN Orchestrator envia traps SNMP correspondentes aos alertas existentes como Edge inativo e Edge ativo. Pode selecionar a versão SNMP e introduzir os detalhes correspondentes em Traps SNMP (SNMP Traps).
Nota: Atualmente, apenas os algoritmos SHA-1 e AES-128 são suportados para o Trap SNMP v3.

Webhooks

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

O SD-WAN Orchestrator suporta Webhooks que enviam automaticamente mensagens através do HTTP POST para direcionar as aplicações quando ocorre um evento. Pode definir o URL de destino no portal da empresa e automatizar ações em resposta aos alertas desencadeados por SD-WAN Orchestrator. Os destinatários do webhook devem suportar HTTPS e devem ter certificados válidos, para garantir a privacidade das cargas úteis de alerta potencialmente sensíveis. Isto também impede a adulteração das cargas.

Configurar webhooks

Na janela Configuração de alerta (Alert Configuration), pode introduzir os seguintes detalhes em Webhooks.

Opção Descrição
URL Introduza um URL HTTPS válido. Este serve como a aplicação de destino para os webhooks.
Código

Introduza um código de estado de resposta HTTP esperado para cada destinatário webhook. Por predefinição, o SD-WAN Orchestrator espera que os destinatários do webhook respondam a pedidos HTTP POST com um código de estado como HTTP 200.

Quando o SD-WAN Orchestrator recebe um código de estado inesperado de um servidor recetor ou de um servidor proxy, considera que a entrega do alerta falhou e gera um evento de cliente ALERT_DELIVERY_FAILED. Este evento ajuda a identificar quando um servidor destinatário do webhook pode não funcionar como esperado.

Secreto (Secret)

Especifique um token secreto para cada destinatário configurado do webhook, que é utilizado para calcular um HMAC para cada pedido de webhook enviado ao destinatário correspondente. 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.

X-Webhook-Signature: v=<signature-version>&t=<timestamp>&s=<hmac> 
O destinatário interpreta os componentes da seguinte forma:
  • v: versão do algoritmo utilizado para produzir a assinatura. O único valor suportado é 1.
  • t: carimbo de data/hora com uma precisão de milissegundos correspondente à hora em que o pedido é emitido.
  • s: HMAC calculado por SD-WAN Orchestrator. O HMAC é calculado da seguinte forma: HMAC-SHA256(request-body + '.' + timestamp, secret).

A mensagem utilizada para calcular o HMAC é formada através da concatenação do corpo de pedido, de um único período, e do valor do parâmetro do carimbo de data/hora que aparece no cabeçalho da assinatura. O algoritmo HMAC específico utilizado para produzir o código é HMAC-SHA256.

Depois de receber um pedido de Webhook, o servidor responsável pela escuta pode verificar a autenticidade do pedido calculando a sua própria assinatura HMAC-SHA256 de acordo com o mesmo algoritmo e comparar a assinatura recém-calculada com a gerada pelo SD-WAN Orchestrator.

Modelo de carga útil JSON (JSON Payload Template)

Este é um campo obrigatório.

O SD-WAN Orchestrator 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 SD-WAN Orchestrator gera conteúdo de carga útil dinamicamente, uma vez que as notificações são enviadas através da interpolação variável. As variáveis do marcador de posição suportadas no modelo de carga útil configurado pelo utilizador são substituídas por valores específicos de alerta.

Os modelos de carga útil webhook suportam as seguintes variáveis do marcador de posição:
  • alertTime – hora em que o alerta foi desencadeado.
  • alertType – o tipo de alerta, como EDGE_DOWN, LINK_UP, VNF_VM_DEPLOYED.
  • Customer – nome do cliente a quem é enviada a notificação.
  • customerLogicalId – o ID lógico do cliente a quem a notificação é enviada.
  • deviceLogicalId – o ID lógico do Edge ao qual o alerta é aplicado.
  • entityAffected – nome da entidade, como Edge ou ligação ou VNF, à qual o alerta é aplicado.
  • lastContact – a hora em que o Edge comunicou mais recentemente com o SD-WAN Orchestrator. Isto aplica-se apenas aos alertas Edge.
  • Message – uma breve mensagem que descreve o evento que desencadeou o alerta.
  • VCO – nome do anfitrião ou IP público do SD-WAN Orchestrator a partir do qual a notificação é enviada.
  • deviceName – o nome do Edge ao qual o alerta é aplicado.
  • deviceDescription – uma breve mensagem a descrever o Edge ao qual o alerta é aplicado.
  • deviceSerialNumber – o número de série do Edge ao qual o alerta é aplicado.

O exemplo a seguir mostra um modelo de carga útil JSON da amostra:

{
   "alertTime": "alertTime",
   "alertType": "alertType",      
   "customer": "customer",
   "customerLogicalId": "customerLogicalId",
   "entityAffected": "entityAffected",
   "deviceLogicalId": "deviceLogicalId",
   "lastContact": "lastContact",
   "message": "message",
   "vco": "vco",
   "deviceName": "deviceName",
   "deviceDescription": "deviceDescription",
   "deviceSerialNumber": "deviceSerialNumber"
}

Pode clicar no ícone mais (+) para adicionar mais URLs de destino e os detalhes correspondentes.

Clique em Teste (Test) para verificar os alertas do Webhook.

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