---
title: Alertes CAP automatiques
url: https://doc2.pstreamer.tv/fr/manual/streamer/cap.html
lang: fr
product: Perfect Streamer
version: 2.0.2.423
---

# Alertes CAP automatiques

> **Important**
>
> **Version bêta 2.1.** Ce qui est décrit ici n’existe que dans la version bêta 2.1 : elle s’installe depuis le dépôt bêta et uniquement avec une licence ; la version stable 2.0.2 et la version de démonstration ne l’ont pas. La version bêta est fournie sans garantie, et l’assistance est assurée dans la mesure du possible ([Programme de test bêta](../extras/beta.md#extras-beta)).

Depuis la version 2.1.1.508, le nœud reçoit des alertes d’urgence au format OASIS CAP 1.2 (Common Alerting Protocol) — des systèmes de sécurité du site et des flux publics d’alerte — et bascule les chaînes sur le clip d’alerte de leur catégorie ([Clips d’alerte](override.md#streamer-override-clips)). Par défaut, une nouvelle alerte attend la confirmation d’un opérateur. La réception se configure et se suit dans l’onglet « Alertes CAP » de l’écran « Alerte d’urgence » ([Onglet « Alertes CAP »](../webui/administration.md#webui-cap)).

La réception ne fonctionne que tant que l’interrupteur général « Alerte d’urgence » est activé ([Alerte d’urgence](../webui/administration.md#webui-emergency)). Chaque nœud a ses propres réglages et son propre état de réception : ils ne sont pas transmis aux autres nœuds du domaine. Les alertes en attente et l’historique sont conservés en mémoire : après un redémarrage du streamer, ils disparaissent, et au sondage suivant les flux ramènent les alertes encore en vigueur. La version de démonstration n’a pas de réception.

## D’où viennent les alertes

**Push.** Un système du site (alarme incendie, système d’annonce) envoie une alerte CAP 1.2 au format XML par une requête POST à l’adresse `https://<nœud>:<port HTTPS>/cap/v1/alerts` du serveur web du nœud. L’émetteur ne se connecte pas à la console : son accès est vérifié à part (Sécurité du push). Limites : jusqu’à 1 Mo par requête, jusqu’à 10 requêtes par minute depuis une même adresse, encodage UTF-8 uniquement ; les champs de texte de plus de 512 caractères sont tronqués.

**Flux.** Le nœud interroge lui-même des flux CAP ou Atom en HTTPS avec vérification du certificat — uniquement des adresses `https://`. La période d’interrogation va de 30 à 3600 s, 60 s par défaut ; une interrogation ne dure pas plus de 60 s. Le nœud se fie au certificat d’un flux d’après les CA du système et, s’il est défini, d’après un fichier CA supplémentaire. Si un flux ne peut pas être lu (erreur HTTP ou TLS, réponse qui n’est pas du CAP), l’alerte 82 est levée (`cap-source-error`, [Alertes CAP](../extras/alert_codes.md#extras-alert-codes-cap)).

## Quelles alertes basculent les chaînes

Une alerte est retenue si au moins l’un de ses blocs d’informations (info) franchit les trois seuils et, là où c’est exigé, correspond à la zone du site.

- **Seuils :** gravité minimale (par défaut « Grave », Severe), urgence minimale (par défaut « Attendue », Expected) et certitude minimale (par défaut « Probable », Likely). Une alerte sous l’un de ces seuils est ignorée.
- **Zone du site :** les géocodes du site (paires de la forme `EMMA_ID=DE300`) ou un point — latitude et longitude. Une alerte correspond si elle porte l’un de ces géocodes ou si son polygone ou son cercle contient le point. Les alertes des flux doivent toujours correspondre à la zone : sans zone, aucune alerte de flux ne passe. Pour le push, cette exigence s’active séparément.
- **Statut :** les alertes Test et Exercise ne basculent jamais les chaînes, les alertes System et Draft sont ignorées.
- **La diffusion restreinte** (scope Restricted) n’est acceptée qu’en push.

La signature XML n’est pas vérifiée : la confiance envers la source repose sur la liste des émetteurs, le jeton et HTTPS pour le push, et sur la vérification du certificat pour les flux.

## Ce que devient une alerte

1. **En attente de l’opérateur.** Une nouvelle alerte qui a passé les filtres attend d’être confirmée ; l’alerte 81 est levée (`cap-alert`). Les rôles Admin et Restricted admin peuvent la confirmer ou la rejeter — dans le bandeau de la console ou dans l’onglet « Alertes CAP ». Si « Attendre la confirmation d’un opérateur » est désactivé, l’alerte bascule les chaînes d’elle-même.
2. **À l’antenne.** Une alerte confirmée active le basculement d’urgence ([Basculement d’urgence vers une alerte](override.md#streamer-override)) : les chaînes diffusent le clip de la catégorie de l’alerte ou, si la catégorie n’a pas de clip, le clip par défaut. Une alerte sans clip ne peut pas passer à l’antenne. Les chaînes visées sont tous les flux SPTS éligibles du nœud ou la liste choisie dans les réglages.
3. **Mise à jour.** Une mise à jour (Update) d’une alerte à l’antenne s’applique sans nouvelle confirmation. Si, après la mise à jour, l’alerte ne passe plus les filtres, les chaînes sont rétablies.
4. **Fin.** Une annulation (Cancel) ou l’expiration de l’alerte ramène les chaînes sur leurs entrées. L’opérateur peut aussi terminer l’alerte lui-même.

**Priorité.** Une alerte plus grave remplace à l’antenne une alerte CAP moins grave. Une alerte CAP ne remplace pas un basculement d’urgence lancé manuellement : elle attend que l’opérateur termine le basculement manuel. La note d’un basculement manuel ne peut pas commencer par `[CAP]`.

## Sécurité du push

Une alerte bascule les chaînes ; c’est pourquoi l’accès au push est fermé par défaut :

- **Émetteurs autorisés** — adresses, plages ou blocs CIDR, séparés par des virgules. Une liste vide signifie que personne ne peut envoyer.
- **Jeton** — s’il est défini, l’émetteur le transmet dans l’en-tête `X-CAP-Token`.
- **HTTPS uniquement** — activé par défaut : le push n’est accepté que sur le port HTTPS du serveur web ([Serveur web et comptes](../webui/administration.md#webui-web-server)).

Un refus est signalé à l’émetteur par un code HTTP : 403 — adresse, jeton, ou HTTP au lieu de HTTPS ; 404 — réception, push ou interrupteur général désactivés ; 413 — requête de plus de 1 Mo ; 429 — limite de requêtes dépassée.

> **Avertissement**
>
> Désactiver « Attendre la confirmation d’un opérateur » signifie que toute alerte qui passe les filtres basculera les chaînes sans intervention humaine. Ne le désactivez que si vous faites entièrement confiance aux sources et aux filtres.
