/
EUS (ILS Passau)

EUS (ILS Passau)

  • 2.40

    • Die EUS-Schnittstelle ermöglicht den Empfang von Einsatzdaten des EUS-Systems (ILS Passau) über einen HTTPS-Webhook. Eingehende Alarme werden automatisch an die konfigurierten Einheiten in FE2 weitergeleitet.

    Voraussetzungen

    • Die Lizenz muss für den Kunden freigeschaltet sein

    • FE2 muss von extern über HTTPS mit einem gültigen, öffentlich vertrauenswürdigen Zertifikat erreichbar sein (z.B. Let's Encrypt). Selbstsignierte Zertifikate werden vom EUS-System nicht akzeptiert

    • Wird ein Reverse Proxy (z.B. nginx, Traefik) eingesetzt, muss dieser die TLS-Terminierung übernehmen und ein gültiges Zertifikat bereitstellen

    Einrichtung in FE2

    1. In der FE2-Administration unter "Alarmeingänge" einen neuen Input vom Typ "EUS (ILS Passau)" anlegen.

    2. Folgende Felder konfigurieren:

      • Webhook-URL (nur lesbar):
        Wird automatisch generiert und setzt sich aus der konfigurierten externen Adresse und dem Pfad /rest/input/external/eus/alarm zusammen. Diese URL muss im EUS-Portal hinterlegt werden

      • EUS-Secret:
        Ein gemeinsames Geheimnis (Shared Secret), das zwischen FE2 und dem EUS-System vereinbart wird. Dient zur Absicherung der Kommunikation, wird über das EUS-Portal bereitgestellt und darf nicht leer sein

      • Alarmierung → Einheiten:
        Auswahl der Einheiten, die bei eingehenden EUS-Alarmen alarmiert werden sollen. Mindestens eine Einheit muss ausgewählt sein

    3. Den Alarmeingang starten. Falls die Webhook-URL nicht mit https:// beginnt, wird eine Warnung angezeigt.

    image-20260323-164235.png

    Funktionsweise

    Das EUS-System sendet bei einem Einsatz eine HTTP-POST-Anfrage an die Webhook-URL. Der Anfragekörper enthält die Einsatzdaten im JSON-Format (Einsatznummer, Stichwort, Schlagwort, Einsatzort mit Adresse und Koordinaten). Jede Anfrage wird entsprechend verschlüsselt.

    Folgende Einsatzdaten werden übernommen:

    • Einsatznummer (dient auch zur Erkennung von Aktualisierungen)

    • Stichwort und Schlagwort

    • Einsatzort: Straße, Hausnummer, Postleitzahl, Ort

    • Koordinaten (Breiten- und Längengrad)

    • Optionaler Stempel/Nachricht des EUS-Systems

    Aktualisierungen

    Die Schnittstelle erkennt automatisch, ob ein Alarm eine Aktualisierung eines bereits empfangenen Einsatzes ist. Dazu wird die Einsatznummer als Identifikator verwendet. Wenn sich keine relevanten Parameter geändert haben (Stichwort, Schlagwort, Adresse, Koordinaten), wird der Alarm nicht erneut ausgelöst.

    Fehlerbehebung

    • Warnung "EUS erfordert eine HTTPS-Verbindung":
      FE2 ist nicht über HTTPS erreichbar. Prüfen Sie die SSL-Konfiguration des Servers oder Reverse Proxys.

    • Alarme kommen nicht an:

      • Prüfen, ob das Secret in FE2 und im EUS-System übereinstimmt

      • Prüfen, ob der Alarmeingang in FE2 gestartet ist

      • Prüfen, ob die Webhook-URL vom EUS-System aus erreichbar ist (Testalarm) und die Anfrage in FE2 im HTTP-Protokoll erscheint - wenn nicht, EUS-Support kontaktieren