Grundsatz: Die Leser bleiben unverändert
InnerWeb produziert und tauscht keine Leser und Zutrittskarten aus. Die Lösung wird in das bestehende Zutrittssystem des Kunden eingebunden: Sie nimmt Kartenbuchungen per Webhook entgegen und verknüpft sie mit Qualifikationen, Berechtigungen, Anwesenheit und Zeiterfassung. Für die IT ist damit die Verantwortung klar geteilt: Der Lieferant der Zutrittskontrolle verantwortet Leser, Karten und Steuerungen, das ergänzende System die Logik rund um die Buchung.
So ist für die Integration kein Gerätetausch nötig. Ein Wechsel der Kartentechnik auf der Seite der Zutrittskontrolle, zum Beispiel auf DESFire, erfordert keine Änderung der Berechtigungslogik. Das ergänzende System bleibt ein eigenständiges System neben Zutrittskontrolle, Zeiterfassung, Personalwesen und ERP.
Schritt 1: Ereignisspezifikation für den Lieferanten der Zutrittskontrolle
Das erste Dokument ist die Spezifikation des Buchungsereignisses, die die IT dem Lieferanten der Zutrittskontrolle übergibt. Ein Muster aus einer Einführung bei einem Verpackungshersteller sieht vor, Kartenbuchungen aus der Zutrittskontrolle nach den Vorgaben für den Lieferanten an die Zeiterfassung zu übergeben, ganz ohne InnerWeb-Leser. Die Spezifikation beschreibt, welche Felder ein Ereignis enthält und wie es übermittelt wird.
Die Anforderungen lauten: Das Zutrittssystem sendet Ereignisse in Echtzeit. Jedes Ereignis enthält eine Mitarbeiterkennung in vereinbarter Form, die Zeit der Buchung, wie sie der Leser erfasst, die Kennung des Lesers, die Richtung des Durchgangs (Eingang oder Ausgang) und eine Ereigniskennung. InnerWeb nimmt die Ereignisse über einen authentifizierten Webhook entgegen. Der Zugang erfolgt über ein Token mit begrenzter Gültigkeit, das die Integration selbstständig erneuert. Nach dem Grundsatz der Datenminimierung wird keine Kartennummer übermittelt, sofern die Mitarbeiterkennung ausreicht.
Schritt 2: Leser den Orten im System zuordnen
Eine Buchung an einem Leser ohne zugeordneten Ort, also ohne Aktionspunkt, löst keinen Schulungsalarm aus. Die Konfiguration der Leser muss deshalb den Standorten im System entsprechen. Die IT pflegt dazu eine Tabelle mit: Kennung des Lesers in der Zutrittskontrolle, Name des Ortes im System, Art des Ortes, zum Beispiel Haupttor, Hallenzugang oder Lager.
Die Tabelle wird gemeinsam mit Werkschutz und Arbeitssicherheit erstellt, denn sie wissen, welche Türen für Schulungen und Berechtigungen von Bedeutung sind. Ein Fehler in diesem Schritt ist die häufigste Ursache für eine „funktionierende Integration, die nichts bewirkt“.
Schritt 3: Richtung des Durchgangs und Ereigniskennung
Richtung des Durchgangs und Ereigniskennung sind Anforderungen an das Zutrittssystem, keine Zusatzleistungen. Ein Ereignis mit Richtung erlaubt es, Eingang und Ausgang einander zuzuordnen und die Anwesenheit zu zählen. Die Ereigniskennung erlaubt es, ein Duplikat zu verwerfen, wenn dieselbe Meldung zweimal ankommt. Die Zeit stammt vom Leser, daher bleibt die Reihenfolge der Buchungen verlässlich, auch wenn die Zustellung eines Ereignisses verzögert ist.
Die Regeln für das Zuordnen von Ein- und Ausgängen und für das Verwerfen von Duplikaten werden zusammen mit dem Lieferanten der Zutrittskontrolle und dem Werk in der Spezifikation festgelegt. Sie sind keine fertige Funktion zum Einschalten. Als Ausgangspunkt für das Gespräch dienen oft ein Zuordnungsfenster in der Größenordnung von etwa einem Dutzend Stunden und eine Duplikatschwelle von einigen Minuten. Für den Betrieb in drei Schichten müssen die Werte jedoch angepasst werden, und das Werk sollte die Regeln schriftlich bestätigen. Kann der Leser auf der Seite der Zutrittskontrolle die Richtung nicht erkennen, ist das ein technischer Befund des Zutrittssystems. Dann ist in der Spezifikation abzustimmen, wie die Richtung ergänzt wird.
Schritt 4: Kanal für die Zustellung der Ereignisse wählen
Der Webhook ist der einfachste Kanal, aber nicht immer möglich. Blockiert das Netz des Werks den ausgehenden Verkehr vom Anwendungsserver, lassen sich ausgehende Webhooks in einer Outbox-Tabelle zwischenspeichern, und die Abholung erfolgt über einen mit dem Kunden vereinbarten anderen Kanal. Die IT sollte dies zu Beginn klären, denn ein Kanalwechsel nach dem Start bedeutet erneute Tests.
Die Regeln des Werksnetzes sollten schon in der Spezifikation erfragt werden: Darf der Server der Zutrittskontrolle Verbindungen nach außen aufbauen oder nur im internen Netz, und wer verwaltet die Regeln der Firewall?
Schritt 5: Drei Fallen, die Wochen kosten
Die erste Falle sind Daten, die nur als Spur vorliegen. Der Import der Konten aus der Zutrittskontrolle ersetzt den Strom der Ereignisse nicht. Das Anwesenheitsregister braucht eine eigene Spezifikation der Ereignisse mit Zeit, Richtung und Ereigniskennung, die der Import der Konten nicht ersetzen kann.
Die zweite Falle sind unterschiedliche Kennungen derselben Person in Zutrittskontrolle, Zeiterfassung und Schulungssystem. Hat ein Mitarbeiter in jedem System eine andere Kennung, wird die Zuordnung der Ereignisse manuell. Vor dem Start sollte deshalb ein gemeinsamer Verknüpfungsschlüssel festgelegt werden.
Die dritte Falle ist das fehlende Testen mit einer echten Buchung. Ein Testereignis aus dem Werkzeug des Lieferanten der Zutrittskontrolle läuft durch, eine echte Buchung am Tor dagegen nicht, weil der Leser in der Tabelle aus Schritt 2 keinen Ort hat. Der abschließende Test wird mit einer Karte am Leser durchgeführt.
Schritt 6: Nachweis für den Revisor
Nach dem Start sollte das Werk drei Dokumente haben: die Spezifikation des Ereignisses, die Tabelle der Leser und Orte sowie das Testprotokoll mit einer Kartenbuchung am Tor und der sichtbaren Wirkung im System. Für den Revisor ist das der vollständige Nachweis, dass die Integration so arbeitet, wie beschrieben.
Ergänzen Sie die Dokumentation um ein Notfallverfahren: Was geschieht, wenn Ereignisse nicht ankommen? Das Werk sollte wissen, wer fehlende Ereignisse aus der Zutrittskontrolle wie und bis wann nachträgt. Die Regeln dafür werden mit dem Lieferanten der Zutrittskontrolle in der Spezifikation abgestimmt.
Videomaterial
Häufig gestellte Fragen
Muss für die Integration der Leser ausgetauscht werden?
Nein. Das Zutrittssystem sendet die Ereignisse, und das ergänzende System nimmt sie entgegen. Leser und Karten bleiben in der Verantwortung des Lieferanten der Zutrittskontrolle und des Kunden.
Welche Anforderungen muss ein Ereignis aus der Zutrittskontrolle erfüllen?
Das Zutrittssystem sendet Ereignisse in Echtzeit mit der Zeit des Lesers, der Richtung und der Ereigniskennung. Die Regeln für das Zuordnen von Ein- und Ausgängen und für das Verwerfen von Duplikaten werden mit dem Lieferanten der Zutrittskontrolle in der Spezifikation festgelegt.
Was ist zu tun, wenn das Netz des Werks keinen ausgehenden Webhook erlaubt?
Die Webhooks lassen sich in einer Outbox-Tabelle zwischenspeichern, und die Abholung erfolgt über einen anderen, mit dem Kunden vereinbarten Kanal. Das wird bereits bei der Spezifikation festgelegt.
Möchten Sie die KD mit Berechtigungen verbinden?
Wir übergeben dem Lieferanten der Zutrittskontrolle die Ereignisspezifikation und bringen die Integration ohne Eingriff in die Leser in Betrieb. Vereinbaren Sie ein Gespräch oder eine Demo.
Sprechen wir