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
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