InnerWeb
Zum Inhalt springen

Kartenbuchungen nach der Migration: Fragen von IT und OT

Nach dem Wechsel der Karten will die IT und OT eines wissen: Übersteht die Schnittstelle zu den Buchungen den Wechsel des Datenträgers, ohne neue Ports zu öffnen und ohne die Arbeitstage zu verfälschen? Im Folgenden die Antworten zu Verbindungsrichtung, Authentifizierung, Inhalt der Nachricht, Zeit und erneuten Übertragungen.

443
ein ausgehender Port für die Schnittstelle
Quelle: Karte
3
Pflichtfelder des Ereignisses: Zeit am Leser, Richtung, Kennung
Quelle: Karte

Verbindungsrichtung und Ports

Muss im Netz des Werks ein eingehender Port geöffnet werden? Nein. Bei jeder Buchung sendet der Server des Zutrittskontrollsystems eine HTTPS-POST-Nachricht an InnerWeb, die Verbindung geht also vom Werksnetz aus. Für das Team IT/OT bedeutet das eine Firewall-Regel für ausgehenden Verkehr zu einer Adresse auf Port 443, ohne den Server des Zutrittskontrollsystems ins Internet zu stellen.

Ändert die Migration der Karten diese Struktur? Nein, denn es ändern sich der Datenträger und die Kartennummer, nicht der Kanal der Ereignisse. Werden zusammen mit den Karten auch Leser und Controller ausgetauscht, genügt die Prüfung, ob der Server des Zutrittskontrollsystems nach dem Update weiterhin HTTPS-POST-Nachrichten senden kann.

Authentifizierung und JWT-Token

Wie weist sich das Zutrittskontrollsystem gegenüber InnerWeb aus? Die Schnittstelle nutzt ein technisches Konto und einen JWT-Token mit begrenzter Gültigkeit, den die Schnittstelle automatisch erneuert. Auf Seiten des Anbieters des Zutrittskontrollsystems muss daher die Erneuerung des Tokens funktionieren oder vor jeder Serie von Übertragungen eine Anmeldung erfolgen.

Mit dem Anbieter des Zutrittskontrollsystems sollte geklärt werden, wie der Ablauf des Tokens nachts oder am Wochenende behandelt wird. Ein guter Abnahmetest ist, die Erneuerung anzuhalten und zu prüfen, ob die Übertragung nach der erneuten Anmeldung ohne Verlust von Ereignissen wieder anläuft.

Anforderungen der Spezifikation für die Buchungsschnittstelle

Anforderungen der Spezifikation für die BuchungsschnittstelleBalkendiagramm: ein ausgehender Port und drei Pflichtfelder des Ereignisses0123AnzahlAusgehende Ports: 1 Anzahl1 AnzahlAusgehende PortsPflichtfelder des Ereignisses: 3 Anzahl3 AnzahlPflichtfelder des Ereignisses
Quelle: Karte der Schnittstelle für Kartenbuchungen aus dem Zutrittskontrollsystem

Inhalt der Nachricht und Kartennummer

Was muss die Nachricht enthalten? Die Schnittstellenspezifikation verlangt die Zeit der Buchung am Leser, die Kennung des Lesers, die Person, die Kartennummer in der Form Objektcode-Nummer, die Richtung (Eingang oder Ausgang) und die Kennung des Ereignisses. Nach der Migration haben die Kartennummern neue Werte, daher ist vor dem Start einer Welle ein Export der Karten (Objektcode und Nummer) bereitzustellen, der der Personalnummer zugeordnet ist.

Wie werden Ein- und Ausgänge behandelt? Das Zutrittskontrollsystem sendet die Ereignisse in Echtzeit mit ihrer Richtung, und InnerWeb nimmt sie über einen authentifizierten Webhook entgegen. Die Regeln für die Zuordnung von Ein- und Ausgängen sowie das Verwerfen von Duplikaten werden in der Spezifikation mit dem Anbieter des Zutrittskontrollsystems festgelegt. Unterscheiden die Leser im Zutrittssystem des Kunden die Richtung nicht, ist das ein technischer Fakt auf Seiten des Zutrittskontrollsystems, der in dieser Spezifikation zu berücksichtigen ist. Nach dem Austausch der Leser ist das Verzeichnis der Leser zu aktualisieren, in dem getrennte Leser als Eingang und Ausgang beschrieben werden.

Zeit vom Controller und Idempotenz

Warum zählt die Zeit des Lesers und nicht die Empfangszeit? Das Zutrittskontrollsystem sendet Ereignisse in Echtzeit mit der Zeit des Ereignisses am Leser. So verschiebt eine Offline-Warteschlange oder eine erneute Übertragung nach einem Ausfall der Leitung die Buchungen nicht: Eine verzögerte Buchung landet in ihrer eigenen Stunde, und die Kennung des Ereignisses erlaubt, Duplikate nach den in der Spezifikation vereinbarten Regeln zu verwerfen.

In der Praxis bedeutet das eine Anforderung an den Anbieter des Zutrittskontrollsystems: Jedes Ereignis braucht eine stabile Kennung, die sich bei einer erneuten Übertragung nicht ändert. Nach der Migration der Controller lohnt sich diese Prüfung, weil neue Firmware die Kennungen anders erzeugen kann.

Was bei InnerWeb und was beim Zutrittssystem bleibt

Die gesamte Verarbeitung, also die Erkennung von Ein- und Ausgang, die Zusammenfassung zu Arbeitstagen, Dienstpläne, Abweichungen und Berichte, erfolgt bei InnerWeb, und die Logik des Zutrittssystems bleibt unverändert. Die IT und OT muss die Abrechnungsregeln also weder in das Zutrittssystem übertragen noch umgekehrt.

Eine unbekannte Karte landet in der Warteschlange für Karten zur Zuordnung, anstatt ein Konto aus einer unbekannten Buchung anzulegen. So erzeugt die erste Welle neuer Karten, die noch keiner Person zugeordnet sind, keine Konten und bringt die Zeiterfassung nicht durcheinander.

Videomaterial

Häufig gestellte Fragen

Muss die Schnittstelle nach dem Kartenwechsel neu eingerichtet werden?

Nein. Der HTTPS-POST-Kanal und die Authentifizierung bleiben bestehen. Geändert werden die Kartennummer und der Export der Karten zur Personalnummer, der per CSV-Import in InnerWeb eingelesen wird.

Was tun, wenn der Anbieter des Zutrittssystems kein HTTPS POST sendet?

Das ist die erste Frage, die vor der Einrichtung zu klären ist: Unterstützt der Server des Zutrittssystems den Versand per HTTPS POST? Zusammen damit werden die Liste der Leser und das Format des Kartenexports festgelegt.

Können Ereignisse aus der Offline-Warteschlange die Arbeitstage durcheinanderbringen?

Nein, sofern die Nachricht die Zeit am Leser und die Kennung des Ereignisses enthält. Die Regeln für das Verwerfen von Duplikaten werden mit dem Anbieter des Zutrittssystems in der Spezifikation festgelegt.

Sieht InnerWeb die Kartennummer im Klartext?

Die Kartennummer hat die Form Objektcode-Nummer und dient der Zuordnung zu einer Person. Im Suchfeld des Kontos im Schulungsmodul wird die Kartennummer nicht angezeigt.

Quellen

Prüfen wir die Schnittstelle der Buchungen vor der Migration

Wir gehen mit Ihrem Team IT/OT und dem Anbieter des Zutrittssystems die Liste der Festlegungen durch: Übertragung, Token, Leser und Kartenexport. So bleiben die Arbeitstage nach dem Kartenwechsel lückenlos.

Sprechen wir