--- title: Automatische CAP-Warnungen url: https://doc2.pstreamer.tv/de/manual/streamer/cap.html lang: de product: Perfect Streamer version: 2.0.2.423 --- # Automatische CAP-Warnungen > **Wichtig** > > **Betaversion 2.1.** Das hier Beschriebene gibt es nur in der Betaversion 2.1: Sie wird aus dem Beta-Repository und nur mit einer Lizenz installiert; die stabile Version 2.0.2 und die Demoversion enthalten es nicht. Die Betaversion wird ohne Gewähr ausgeliefert, Support gibt es nach Möglichkeit ([Betatestprogramm](../extras/beta.md#extras-beta)). Seit Version 2.1.1.508 nimmt der Knoten Notfallwarnungen im Format OASIS CAP 1.2 (Common Alerting Protocol) an — von den Sicherheitssystemen des Standorts und aus öffentlichen Warn-Feeds — und schaltet die Kanäle auf den Warnclip ihrer Kategorie um ([Warnclips](override.md#streamer-override-clips)). Eine neue Warnung wartet standardmäßig auf die Bestätigung eines Operators. Eingerichtet und geführt wird der Empfang auf der Registerkarte „CAP-Warnungen“ der Ansicht „Notfallwarnung“ ([Registerkarte „CAP-Warnungen“](../webui/administration.md#webui-cap)). Der Empfang funktioniert nur, solange der Hauptschalter „Notfallwarnung“ eingeschaltet ist ([Notfallwarnung](../webui/administration.md#webui-emergency)). Einstellungen und Zustand des Empfangs hat jeder Knoten für sich: Sie werden nicht an andere Knoten der Domäne übertragen. Wartende Warnungen und das Protokoll liegen im Speicher: Nach einem Neustart des Streamers sind sie weg, und die Feeds liefern bei der nächsten Abfrage die gültigen Warnungen erneut. In der Demoversion gibt es keinen Empfang. ## Woher die Warnungen kommen **Push.** Ein System des Standorts (Brandmeldeanlage, Warnsystem) sendet eine CAP-1.2-Warnung im XML-Format per POST an die Adresse `https://:/cap/v1/alerts` des Webservers des Knotens. Der Absender meldet sich nicht an der Konsole an: Die Zulassung wird gesondert geprüft (Sicherheit von Push). Grenzen: bis 1 MB je Anfrage, bis 10 Anfragen pro Minute von einer Adresse, nur Kodierung UTF-8; Textfelder über 512 Zeichen werden gekürzt. **Feeds.** Der Knoten fragt CAP- oder Atom-Feeds selbst über HTTPS mit Zertifikatsprüfung ab — nur Adressen `https://`. Das Abfrageintervall beträgt 30 bis 3600 s, standardmäßig 60 s; eine Abfrage dauert höchstens 60 s. Dem Zertifikat eines Feeds vertraut der Knoten anhand der System-CAs und, falls angegeben, einer zusätzlichen CA-Datei. Lässt sich ein Feed nicht lesen (HTTP- oder TLS-Fehler, Antwort nicht CAP), wird der Alarm 82 ausgelöst (`cap-source-error`, [CAP-Warnungen](../extras/alert_codes.md#extras-alert-codes-cap)). ## Welche Warnungen die Kanäle umschalten Eine Warnung passiert, wenn mindestens einer ihrer Informationsblöcke (info) alle drei Schwellen passiert und, wo das verlangt ist, zum Gebiet des Standorts passt. - **Schwellen:** Mindestschwere (standardmäßig „Schwer“, Severe), Mindestdringlichkeit (standardmäßig „Erwartet“, Expected) und Mindestsicherheit (standardmäßig „Wahrscheinlich“, Likely). Eine Warnung unter einer dieser Schwellen wird ignoriert. - **Gebiet des Standorts:** Geocodes des Standorts (Paare der Form `EMMA_ID=DE300`) oder ein Punkt — Breite und Länge. Eine Warnung passt, wenn sie einen dieser Geocodes enthält oder ihr Polygon oder Kreis den Punkt enthält. Warnungen aus Feeds müssen immer zum Gebiet passen: Ohne Gebiet passiert keine einzige Feed-Warnung. Für Push wird diese Anforderung gesondert eingeschaltet. - **Status:** Test- und Exercise-Warnungen schalten die Kanäle nie um, System und Draft werden ignoriert. - **Eingeschränkter Empfängerkreis** (scope Restricted) wird nur per Push angenommen. Die XML-Signatur wird nicht geprüft: Das Vertrauen in die Quelle sichern die Absenderliste, das Token und HTTPS für Push sowie die Zertifikatsprüfung für Feeds. ## Was mit einer Warnung geschieht 1. **Wartet auf den Operator.** Eine neue Warnung, die die Filter passiert hat, wartet auf Bestätigung; der Alarm 81 wird ausgelöst (`cap-alert`). Bestätigen oder verwerfen können sie die Rollen Admin und Restricted admin — im Banner der Konsole oder auf der Registerkarte „CAP-Warnungen“. Ist „Auf die Bestätigung eines Bedieners warten“ ausgeschaltet, schaltet die Warnung die Kanäle selbst um. 2. **Auf Sendung.** Eine bestätigte Warnung startet die Notfall-Umschaltung ([Notfall-Umschaltung auf eine Durchsage](override.md#streamer-override)): Die Kanäle zeigen den Clip der Kategorie der Warnung, und wenn die Kategorie keinen Clip hat, den Standard-Clip. Eine Warnung ohne Clip kann nicht auf Sendung gehen. Ziel-Kanäle sind alle geeigneten SPTS-Streams des Knotens oder eine in den Einstellungen gewählte Liste. 3. **Aktualisierung.** Eine Aktualisierung (Update) einer Warnung auf Sendung wird ohne neue Bestätigung angewendet. Passiert die Warnung nach der Aktualisierung die Filter nicht mehr, kehren die Kanäle zurück. 4. **Ende.** Eine Aufhebung (Cancel) oder der Ablauf der Warnung bringt die Kanäle auf ihre Eingänge zurück. Der Operator kann die Warnung auch selbst beenden. **Vorrang.** Eine schwerere Warnung löst auf Sendung eine weniger schwere CAP-Warnung ab. Eine manuell gestartete Notfall-Umschaltung ersetzt eine CAP-Warnung nicht: Die Warnung wartet, bis der Operator die manuelle Umschaltung beendet. Der Hinweis einer manuellen Umschaltung darf nicht mit `[CAP]` beginnen. ## Sicherheit von Push Eine Warnung schaltet Kanäle um, deshalb ist die Zulassung zu Push standardmäßig gesperrt: - **Erlaubte Absender** — Adressen, Bereiche oder CIDR-Blöcke, durch Kommas getrennt. Eine leere Liste bedeutet, dass niemand senden darf. - **Token** — wenn gesetzt, sendet der Absender es im Header `X-CAP-Token` mit. - **Nur HTTPS** — standardmäßig eingeschaltet: Push wird nur am HTTPS-Port des Webservers angenommen ([Webserver & Konten](../webui/administration.md#webui-web-server)). Eine Ablehnung erhält der Absender als HTTP-Code: 403 — Adresse, Token oder HTTP statt HTTPS; 404 — Empfang, Push oder Hauptschalter ausgeschaltet; 413 — Anfrage größer als 1 MB; 429 — Anfragegrenze überschritten. > **Warnung** > > Das Ausschalten von „Auf die Bestätigung eines Bedieners warten“ bedeutet, dass jede Warnung, die die Filter passiert, die Kanäle ohne einen Menschen umschaltet. Schalten Sie es nur aus, wenn Sie den Quellen und Filtern voll vertrauen.