Allgemeine Definition Einer Remote-Benachrichtigung - Keba Kebin S10 Benutzerhandbuch

Allgemeine Definition einer Remote-Benachrichtigung

● Name:
Der Name der Benachrichtigung sollte so beschreibend wie möglich sein.
● Url:
Identifiziert ein externes System im Netzwerk. Da dies der Zielort ist, an den die Daten gesendet wer-
den, muss diese Eingabe strenge Kriterien erfüllen. Validierungsregeln siehe Kapitel
rungsregeln [▶56]".
Beim Hochladen einer Konfigurationsdatei werden Url's ebenfalls überprüft. Wenn Url's nicht den Kriteri-
en entsprechen, führt dies zu einem Fehlschlag des Uploads.
● Type:
Damit Daten an verschiedene Systeme gesendet werden können, wurden Benachrichtigungstypen ein-
geführt. Jeder Typ enthält eine Liste von Parametern und kann zeit- oder ereignisbasiert sein. Der Wert
wird aus der Dropdown-Liste ausgewählt. Im Moment werden zwei Typen unterstützt, die jeweiligen Pa-
rameter werden nachfolgend erklärt:
| SystemStatus | CardData |
● Konfiguration:
Obwohl externe Systeme meist REST-basiert sind, können sie auf unterschiedliche Kommunikations-
protokolle zurückgreifen. Dieses Feld ermöglicht eine Auswahl in Kombination mit dem Datenformat und
der Protokollmethode.
Derzeit unterstützt KeBin die Protokolle HTTP und HTTPS.
Das Datenformat ist JSON und da dies ausgehende Benachrichtigungen sind, ist die einzige unterstütz-
te Protokollmethode POST.
Wenn das HTTPS-Protokoll verwendet wird, wird erwartet, dass der Server, der Benachrichtigungen
empfängt, ein X.509-Serverzertifikat bereitstellt. Das bereitgestellte Zertifikat muss eine vollständige
Zertifikatskette (einschließlich des Zertifikats der Zertifizierungsstelle und aller Zwischenzertifikate) ent-
halten, um validiert zu werden. Möglicherweise sind zusätzliche Konfigurationsschritte erforderlich, um
eine neue Zertifizierungsstelle hinzuzufügen, die als Zertifikatsaussteller vertrauenswürdig ist. Dies kann
über die Seite "Einstellungen -> Allgemeine Einstellungen -> Netzwerk" erfolgen.
Empfehlung: Aus Sicherheitsgründen wird die Verwendung des HTTPS Protokolls für alle Benachrichti-
gungen unbedingt empfohlen.
● Intervall:
Dieses Feld wird nur für zeitbasierte Benachrichtigungstypen angezeigt und stellt dar, wie oft Benach-
richtigungen an ein externes System gesendet werden. Das Intervall wird in Sekunden gemessen und
muss im Bereich [0, 3600] liegen.
● Parameter:
Stellen jene Daten dar, die in einem bestimmten Format an das externe System gesendet werden. Die-
se Parameter werden grundsätzlich in „nicht obligatorische Parameter" und „obligatorische Parameter"
unterteilt.
Obligatorische Parameter sind immer aktiviert und können nicht deaktiviert werden. Falls solche Para-
meter sensible Daten übertragen, wird nach der Überprüfung eine Warnmeldung angezeigt. Zum Sen-
den von Daten an ein externes System muss mindestens ein Parameter ausgewählt werden.
52/64
Datenschnittstelle zu externen Systemen
„6.2 Url Validie-