InnerWeb
Zum Inhalt springen

Webhook der KD-Leser und Outbox-Warteschlange: Empfehlungen für die IT-Architektur

Ein Ereignis des Kartenlesens ist nur dann wertvoll, wenn es dort ankommt, wo es gebraucht wird, und industrielle Netze werden manchmal unterbrochen. Die folgenden Empfehlungen zeigen dem IT-Architekten, wie der Empfang von Ereignissen aus dem Zutrittskontrollsystem per Webhook gestaltet wird und wie eine Outbox-Warteschlange dafür sorgt, dass kein Ereignis verloren geht, wenn der Empfänger kurzzeitig nicht erreichbar ist.

62
Ereignisse pro Stunde bei 1 500 Buchungen täglich
Quelle: Beispielkalkulation
125
nachzuholende Ereignisse nach 2 Stunden Unterbrechung
Quelle: Beispielkalkulation

Für wen und welches Problem wir lösen

Die Empfehlungen richten sich an den IT-Architekten oder Integrator, der das bestehende Zutrittskontrollsystem des Werks mit der Software von InnerWeb verbindet. InnerWeb ist Softwarehersteller und fertigt oder ersetzt keine Leser: Es empfängt die Ereignisse der Kartenbuchung aus dem KD-System per Webhook. Leser, Steuerungen und Karten bleiben auf Seiten des Werks und seines KD-Lieferanten.

Das Problem ist praktischer Natur. Ein Chemiewerk hat ein in Segmente aufgeteiltes Netz, das KD-System arbeitet in einem, die Anwendungen in einem anderen, und dazwischen steht eine Firewall. Die Verbindung ist bei Updates, Überlastung oder Netzarbeiten manchmal nicht verfügbar. Jedes Ereignis, das in dieser Zeit verloren geht, ist eine mögliche Lücke bei der Anwesenheit oder bei der Arbeitszeiterfassung.

Empfehlung 1: die Richtung wählen: das KD-System sendet die Ereignisse

Die Ereignisse der Kartenbuchung fließen vom KD-System zu InnerWeb über einen Webhook, also einen HTTP-Aufruf mit den Daten des Ereignisses. Gestalten Sie es so, dass auf Seiten des KD-Lieferanten eine einzige Stelle für die Adresse des Empfängers besteht und eine einzige Art der Authentifizierung der Aufrufe.

Die Spezifikation des Ereignisses sollte dem KD-Lieferanten als kurzes Dokument übergeben werden: Kennung der Karte oder Person, Kennung des Lesers, Richtung und Zeitpunkt des Ereignisses. Je weniger Felder, desto geringer das Risiko von Abweichungen auf Seiten des Lieferanten.

Anwachsen der ausstehenden Ereignisse während einer Unterbrechung der Verbindung

Anwachsen der ausstehenden Ereignisse während einer Unterbrechung der VerbindungLiniendiagramm: 0, 62, 125 und 187 ausstehende Ereignisse nach jeder weiteren Stunde der Unterbrechung.050100150200Ereignisse0 Std.1 Std.2 Std.3 Std.0 Std.: 0 Ereignisse01 Std.: 62 Ereignisse622 Std.: 125 Ereignisse1253 Std.: 187 Ereignisse187
Quelle: Beispielkalkulation: 1 500 Buchungen pro Tag, gleichmäßiger Verkehr

Empfehlung 2: mit einer unterbrochenen Verbindung rechnen

Gestalten Sie den Empfang so, als würde eine Netzunterbrechung tatsächlich eintreten. Eine Outbox-Warteschlange für Webhooks funktioniert so, dass ausgehende Ereignisse an externe Systeme zuerst dauerhaft gespeichert und erst danach zugestellt werden. Ist das empfangende System vorübergehend nicht erreichbar, kann das Ereignis erneut gesendet werden, weil es nicht verloren gegangen ist.

Das betrifft ausgehende Ereignisse von InnerWeb, zum Beispiel Alarmmeldungen. Bei eingehenden Ereignissen aus dem KD-System lautet die Frage an den Lieferanten, ob sein System Aufrufe puffert und wiederholt, wenn der Empfänger nicht antwortet. Das ist eine der zentralen Festlegungen in der Spezifikation der Integration.

Die Zustellung erfolgt nicht sofort

Bei Arbeit hinter einer Netzisolierung hängt die Zustellung von der Häufigkeit ab, mit der die Warteschlange abgefragt wird. Den Nutzern darf deshalb nicht versprochen werden, dass ein Alarm in derselben Sekunde ankommt. Die zulässige Verzögerung muss festgelegt und in der Dokumentation der Einführung beschrieben werden.

Empfehlung 3: ein Netz ohne ausgehenden Verkehr ist kein Hindernis

Blockiert das Netz des Werks den gesamten ausgehenden Verkehr vom Host der Anwendung, werden Alarm-Webhooks dauerhaft gespeichert, und ein externer Poller holt sie über einen funktionierenden eingehenden Kanal ab und leitet sie weiter. Der Alarm geht also nicht verloren, ohne dass ausgehender Verkehr geöffnet werden muss. Das ist wichtig für OT-Teams, die keine zusätzlichen Firewall-Regeln öffnen wollen.

Wir empfehlen, diese Variante schon in der Projektphase mit der Sicherheitsabteilung zu besprechen, denn sie verändert die Verteilung der Verantwortung: Der Poller ist ein Bestandteil, den jemand pflegen und überwachen muss.

Empfehlung 4: die Warteschlange überwachen, nicht nur den Dienst

Eine Warteschlange ohne Überwachung ist ein stiller Ausfall. Legen Sie Kennzahlen fest: Anzahl der wartenden Ereignisse, Alter des ältesten Ereignisses und Anzahl der Wiederholungen. Ein Ereignis, das wiederholt in die Warteschlange zurückkehrt, ist ein Signal, dass der Empfänger die Daten nicht annimmt oder dass die Daten ein fehlerhaftes Format haben.

In der aktuellen Umsetzung kehrt eine fehlgeschlagene Zustellung im Warteschlangenmodus in den Status „wartend“ zurück und wird erneut versucht. Mechanismen für verzögerte Wiederholungen und eine Obergrenze der Versuche sind beim Projekt zu bewerten. Deshalb ist ein Alarm auf das Alter des ältesten Ereignisses wichtiger als ein Fehlerzähler.

Empfehlung 5: die Ereignisse des KD-Systems mit ihrem Zweck verknüpfen

Die Ereignisse der Kartenleser können mit Qualifikationen, Erlaubnissen, Anwesenheit und Arbeitszeiterfassung verknüpft werden. Bevor Sie den Ablauf entwerfen, halten Sie fest, welche dieser Verwendungen zum Umfang gehören. Die Anwesenheit verlangt eine andere Zuverlässigkeit als eine Statistik, und die Arbeitszeiterfassung verlangt eine andere Genauigkeit als eine Liste der Zutritte.

Ein guter Weg ist, mit einer Verwendung zu beginnen, zum Beispiel der Verknüpfung der Kartenbuchung mit der Liste der Anwesenden auf dem Gelände, und danach zu erweitern.

  • Den Umfang der Ereignisse festlegen: Eintritte, Austritte, Ablehnungen.
  • Format und Authentifizierung der Aufrufe mit dem KD-Lieferanten abstimmen.
  • Die zulässige Verzögerung der Zustellung festlegen.
  • Eine Überwachung des Alters des ältesten Ereignisses in der Warteschlange einrichten.
  • Eine Unterbrechung der Verbindung in der Testumgebung durchspielen.

Beispielkalkulation: wie viele Ereignisse sich während einer Unterbrechung ansammeln

Angenommen werden 1 500 Kartenbuchungen pro Tag in einem Werk mit mehreren Toren und drei Schichten, das ergibt im Mittel etwa 62 Ereignisse pro Stunde. Eine Unterbrechung der Verbindung von 2 Stunden bedeutet etwa 125 Ereignisse zum Nachholen. Dies ist eine Beispielkalkulation: In der Wirklichkeit konzentriert sich der Verkehr auf Beginn und Ende der Schichten, sodass sich die Warteschlange schneller füllen kann. Wichtig ist, das Szenario einer Unterbrechung zur Hauptverkehrszeit zu testen.

Beispielrechnung

Ereignisse des KD-Systems während einer Unterbrechung der Verbindung

Annahmen
ParameterWert
Kartenbuchungen pro Tag1500 Ereignisse
Dauer der Unterbrechung2 Stunden
Verteilung des Verkehrsgleichmäßig Annahme

Ergebnis: etwa 125 Ereignisse zum Nachholen nach 2 Stunden Unterbrechung

Hinweis: Beispielkalkulation; der tatsächliche Verkehr ist ungleichmäßig und auf den Schichtwechsel konzentriert.

Videomaterial

Häufig gestellte Fragen

Liefert InnerWeb Kartenleser?

Nein. InnerWeb ist Softwarehersteller, Leser und Karten bleiben auf Seiten des Werks und des Lieferanten des KD-Systems.

Garantiert die Outbox-Warteschlange eine sofortige Zustellung?

Nein. Sie garantiert, dass ein Ereignis nicht verloren geht und erneut gesendet werden kann. Die Zeit bis zur Zustellung hängt vom Abfragetakt und von der Verfügbarkeit des Empfängers ab.

Was ist mit einem Netz ohne ausgehenden Verkehr?

Webhooks werden dauerhaft gespeichert, und ein externer Poller holt sie über einen eingehenden Kanal ab und leitet sie weiter.

Wofür lassen sich die Ereignisse des KD-Systems nutzen?

Zur Verknüpfung mit Qualifikationen, Erlaubnissen, Anwesenheit und Arbeitszeiterfassung, je nach festgelegtem Umfang.

Die Integration mit dem KD-System planen

Wir bereiten die Spezifikation der Ereignisse für Ihren KD-Lieferanten vor und planen die Robustheit gegen Netzunterbrechungen. Vereinbaren Sie ein Gespräch mit dem Team von InnerWeb.

Sprechen wir