--- title: Alertas CAP automáticos url: https://doc2.pstreamer.tv/pt/manual/streamer/cap.html lang: pt-BR product: Perfect Streamer version: 2.0.2.423 --- # 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](../extras/beta.md#extras-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](override.md#streamer-override-clips)). 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»](../webui/administration.md#webui-cap)). A recepção só funciona enquanto o interruptor geral «Alerta de emergência» estiver ligado ([Alerta de emergência](../webui/administration.md#webui-emergency)). 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://:/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](../extras/alert_codes.md#extras-alert-codes-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](override.md#streamer-override)): 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](../webui/administration.md#webui-web-server)). 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.