Alertas CAP automáticos

Importante

Versão beta 2.1. O que está descrito aqui existe apenas na versão beta 2.1: ela é instalada a partir do repositório beta e somente com uma licença; a versão estável 2.0.2 e a versão de demonstração não têm isso. A versão beta é fornecida sem garantias, e o suporte é prestado na medida do possível (Programa de testes beta).

Desde a versão 2.1.1.508, o nó recebe alertas de emergência no formato OASIS CAP 1.2 (Common Alerting Protocol) — dos sistemas de segurança do local e de feeds públicos de alerta — e comuta os canais para o clipe de alerta da categoria do alerta (Clipes de alerta). Por padrão, um novo alerta CAP aguarda a confirmação do operador. A recepção é configurada e acompanhada na aba «Alertas CAP» da tela «Alerta de emergência» (Aba «Alertas CAP»).

A recepção só funciona enquanto o interruptor geral «Alerta de emergência» estiver ligado (Alerta de emergência). As configurações e o estado da recepção são próprios de cada nó: não são transmitidos aos outros nós do domínio. Os alertas pendentes e o histórico ficam na memória: depois de reiniciar o streamer eles deixam de existir, e na consulta seguinte os feeds trazem de novo os alertas vigentes. A versão de demonstração não tem recepção.

De onde vêm os alertas

Push. Um sistema do local (alarme de incêndio, sistema de avisos) envia um alerta CAP 1.2 em formato XML por uma requisição POST para o endereço https://<nó>:<porta HTTPS>/cap/v1/alerts do servidor web do nó. O remetente não faz login no console: a permissão é verificada separadamente (Segurança do push). Limites: até 1 MB por requisição, até 10 requisições por minuto a partir de um mesmo endereço, somente a codificação UTF-8; campos de texto com mais de 512 caracteres são truncados.

Feeds. O próprio nó consulta feeds CAP ou Atom por HTTPS com verificação do certificado — somente URLs https://. O intervalo de consulta vai de 30 a 3600 s, por padrão 60 s; uma consulta dura no máximo 60 s. O nó confia no certificado do feed pelas CAs do sistema e, se definido, por um arquivo CA adicional. Se o feed não puder ser lido (erro HTTP ou TLS, resposta que não é CAP), é gerado o alerta 82 (cap-source-error, Alertas CAP).

Quais alertas comutam os canais

Um alerta passa se pelo menos um dos seus blocos de informações (info) passar pelos três limites e, onde isso for exigido, corresponder à área do local.

  • Limites: gravidade mínima (por padrão «Grave», Severe), urgência mínima (por padrão «Esperada», Expected) e certeza mínima (por padrão «Provável», Likely). Um alerta abaixo de qualquer limite é ignorado.

  • Área do local: geocódigos do local (pares como EMMA_ID=DE300) ou um ponto — latitude e longitude. Um alerta corresponde se contiver um desses geocódigos ou se o seu polígono ou círculo contiver o ponto. Os alertas dos feeds sempre precisam corresponder à área: sem área, nenhum alerta de feed passa. Para push, essa exigência é ativada separadamente.

  • Status: alertas Test e Exercise nunca comutam os canais; System e Draft são ignorados.

  • Difusão restrita (scope Restricted) é aceita somente por push.

A assinatura XML não é verificada: a confiança na fonte é garantida pela lista de remetentes, pelo token e pelo HTTPS no push e pela verificação do certificado nos feeds.

O que acontece com um alerta

  1. Aguarda o operador. Um novo alerta CAP que passou pelos filtros aguarda confirmação; é gerado o alerta 81 (cap-alert). As funções Admin e Restricted admin podem confirmá-lo ou descartá-lo — no banner do console ou na aba «Alertas CAP». Se «Aguardar a confirmação de um operador» estiver desligado, o alerta CAP comuta os canais sozinho.

  2. No ar. Um alerta confirmado ativa a comutação de emergência (Comutação de emergência para um aviso): os canais exibem o clipe da categoria do alerta e, se a categoria não tiver clipe, o clipe padrão. Um alerta sem clipe não pode ir ao ar. Os canais de destino são todos os fluxos SPTS elegíveis do nó ou a lista escolhida nas configurações.

  3. Atualização. Uma atualização (Update) de um alerta no ar é aplicada sem nova confirmação. Se após a atualização o alerta não passar mais pelos filtros, os canais voltam.

  4. Fim. O cancelamento (Cancel) ou o vencimento do alerta devolve os canais às suas entradas. O operador também pode encerrar o alerta por conta própria.

Precedência. Um alerta mais grave substitui no ar um alerta CAP menos grave. Uma comutação de emergência ativada manualmente não é substituída por um alerta CAP: o alerta aguarda até que o operador encerre a comutação manual. A nota de uma comutação manual não pode começar com [CAP].

Segurança do push

Um alerta comuta os canais, por isso o acesso ao push é fechado por padrão:

  • Remetentes permitidos — endereços, faixas ou blocos CIDR, separados por vírgulas. Uma lista vazia significa que ninguém pode enviar.

  • Token — se definido, o remetente o envia no cabeçalho X-CAP-Token.

  • Somente HTTPS — ativado por padrão: o push é aceito somente na porta HTTPS do servidor web (Servidor web e contas).

O remetente recebe a recusa como código HTTP: 403 — endereço, token ou HTTP em vez de HTTPS; 404 — recepção, push ou interruptor geral desligados; 413 — requisição maior que 1 MB; 429 — limite de requisições excedido.

Aviso

Desligar «Aguardar a confirmação de um operador» significa que todo alerta que passar pelos filtros comutará os canais sem intervenção humana. Desligue-o somente se você confia totalmente nas fontes e nos filtros.