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
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.
Ereignisse des KD-Systems während einer Unterbrechung der Verbindung
| Parameter | Wert |
|---|---|
| Kartenbuchungen pro Tag | 1500 Ereignisse |
| Dauer der Unterbrechung | 2 Stunden |
| Verteilung des Verkehrs | gleichmäß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