Автоматические оповещения CAP¶
Важно
Бета-версия 2.1. Описанное здесь есть только в бета-версии 2.1: она ставится из бета-репозитория и только с лицензией, в стабильной версии 2.0.2 и в демоверсии этого нет. Бета-версия поставляется без гарантий, поддержка — по возможности (Программа бета-тестирования).
С версии 2.1.1.508 узел принимает экстренные оповещения в формате OASIS CAP 1.2 (Common Alerting Protocol) — от систем безопасности объекта и из публичных лент оповещений — и переключает каналы на ролик оповещения его категории (Ролики оповещения). Новое оповещение по умолчанию ждёт подтверждения оператора. Настраивается и ведётся приём на вкладке «Оповещения CAP» экрана «Аварийное оповещение» (Вкладка «Оповещения CAP»).
Приём работает, только пока включён главный переключатель «Аварийное оповещение» (Аварийное оповещение). Настройки и состояние приёма у каждого узла свои: они не передаются другим узлам домена. Ждущие оповещения и журнал хранятся в памяти: после перезапуска стримера их нет, а ленты при следующем опросе снова приносят действующие оповещения. В демоверсии приёма нет.
Откуда приходят оповещения¶
Push. Система объекта (пожарная сигнализация, система оповещения) отправляет
оповещение CAP 1.2 в формате XML запросом POST на адрес
https://<узел>:<порт HTTPS>/cap/v1/alerts веб-сервера узла. Отправитель не входит в
консоль: допуск проверяется отдельно (Безопасность push). Пределы: до 1 МБ на
запрос, до 10 запросов в минуту с одного адреса, только кодировка UTF-8; текстовые поля
длиннее 512 символов обрезаются.
Ленты. Узел сам опрашивает ленты CAP или Atom по HTTPS с проверкой сертификата —
адреса только https://. Период опроса — от 30 до 3600 с, по умолчанию 60 с; один
опрос длится не дольше 60 с. Сертификату ленты узел доверяет по системным CA и, если
задан, по дополнительному файлу CA. Если лента не читается (ошибка HTTP или TLS, ответ
не CAP), поднимается алерт 82 (cap-source-error, Оповещения CAP).
Какие оповещения переключают каналы¶
Оповещение проходит, если хотя бы один его блок сведений (info) проходит все три порога и, где это требуется, совпадает с зоной объекта.
Пороги: наименьшая серьёзность (по умолчанию «Серьёзная», Severe), наименьшая срочность (по умолчанию «Ожидается», Expected) и наименьшая достоверность (по умолчанию «Вероятно», Likely). Оповещение ниже любого порога пропускается.
Зона объекта: геокоды объекта (пары вида
EMMA_ID=DE300) или точка — широта и долгота. Оповещение совпадает, если в нём есть один из этих геокодов или его полигон или круг содержит точку. Оповещения из лент должны совпадать с зоной всегда: без зоны ни одно оповещение из ленты не пройдёт. Для push это требование включается отдельно.Статус: оповещения Test и Exercise не переключают каналы никогда, System и Draft пропускаются.
Ограниченная рассылка (scope Restricted) принимается только по push.
Подпись XML не проверяется: доверие к источнику обеспечивают список отправителей, токен и HTTPS для push и проверка сертификата для лент.
Что происходит с оповещением¶
Ждёт оператора. Новое оповещение, прошедшее фильтры, ждёт подтверждения; поднимается алерт 81 (
cap-alert). Подтвердить или отклонить его могут роли Admin и Restricted admin — в баннере консоли или на вкладке «Оповещения CAP». Если «Ждать подтверждения оператора» выключено, оповещение переключает каналы само.В эфире. Подтверждённое оповещение включает аварийное переключение (Аварийное переключение на оповещение): каналы показывают ролик категории оповещения, а если у категории ролика нет — ролик по умолчанию. Оповещение без ролика в эфир не дать. Целевые каналы — все подходящие SPTS-потоки узла или выбранный в настройках список.
Обновление. Обновление (Update) оповещения в эфире применяется без нового подтверждения. Если после обновления оповещение больше не проходит фильтры, каналы возвращаются.
Конец. Отмена (Cancel) или истечение срока оповещения возвращает каналы на их входы. Оператор может завершить оповещение и сам.
Старшинство. Более серьёзное оповещение сменяет в эфире менее серьёзное оповещение
CAP. Аварийное переключение, включённое вручную, оповещение CAP не заменяет: оповещение
ждёт, пока оператор не завершит ручное переключение. Примечание ручного переключения не
может начинаться с [CAP].
Безопасность push¶
Оповещение переключает каналы, поэтому допуск к push закрыт по умолчанию:
Разрешённые отправители — адреса, диапазоны или блоки CIDR через запятую. Пустой список означает, что отправлять не может никто.
Токен — если задан, отправитель передаёт его в заголовке
X-CAP-Token.Только HTTPS — включено по умолчанию: push принимается только на порту HTTPS веб-сервера (Веб-сервер и учётные записи).
Отказ отправитель получает кодом HTTP: 403 — адрес, токен или HTTP вместо HTTPS; 404 — приём, push или главный переключатель выключены; 413 — запрос больше 1 МБ; 429 — превышен предел запросов.
Предупреждение
Выключение «Ждать подтверждения оператора» означает, что каждое прошедшее фильтры оповещение переключит каналы без участия человека. Выключайте его, только если источникам и фильтрам вы доверяете полностью.
