Ausgangslage: Werk mit Zutrittskontrolle, die unverändert bleiben soll
Das Konzept gilt für ein mittelgroßes Produktionswerk, das seit Jahren ein kartenbasiertes Zutrittskontrollsystem nutzt. Leser hängen an der Pforte, in den Umkleiden und an den Hallenzugängen, und der Dienstleister des Zutrittssystems übernimmt deren Wartung. Der Werkschutz sieht, dass eine Karte gültig ist, aber nicht, ob ihr Inhaber eine gültige Erstunterweisung im Arbeitsschutz hat und ob eine Fremdfirma das Betriebsgelände betreten darf.
InnerWeb ist ein Softwarehersteller und kein Hersteller von Lesern. Die Geräte der Zutrittskontrolle werden weder hergestellt noch ausgetauscht. Stattdessen wird das bestehende Zutrittssystem als unabhängiges Zusatzsystem neben Zutrittskontrolle, Zeiterfassung, Personalwesen und ERP angebunden. Daraus folgt der Grundsatz des Projekts: kein Gerätetausch, kein Stillstand der Schranken und nur eine Schnittstelle auf Seiten der Software.
Der Berührungspunkt ist der Webhook für die Kartenbuchung. Das Zutrittssystem sendet bei jeder Buchung einen HTTP-POST-Aufruf an InnerWeb. InnerWeb nimmt diesen als Ereignis entgegen und verknüpft es mit dem Konto der Person, ihren Schulungen, Qualifikationen und ihrer Firma.
Tag 1: Authentifizierung und erste Testnachricht
Am ersten Tag erhält der Integrator auf Seiten des Zutrittssystems Zugang zur InnerWeb-API. Für den Webhook-Aufruf wird ein Token benötigt, das über den Anmeldeendpunkt der API abgerufen wird. Der Token ist zeitlich begrenzt gültig und wird durch die Integration automatisch erneuert. In der Praxis muss der Dienst auf Seiten des Zutrittssystems den Token regelmäßig erneuern, entweder vor jeder Serie von Meldungen oder bei Bedarf.
Ein typischer Fehler am ersten Tag ist, den Token fest in der Skriptkonfiguration zu hinterlegen. Der Token läuft nach einer bestimmten Zeit ab, sodass die Integration zunächst funktioniert und Meldungen später abgewiesen werden. Ein bewährtes Muster ist ein kurzer Anmeldevorgang, der ausgelöst wird, sobald eine Antwort die Autorisierung ablehnt.
Die erste Testnachricht sollte eine bekannte Person mit Karte betreffen. Der Werkschutz prüft in InnerWeb, ob die Buchung beim richtigen Konto erschienen ist, und schaltet erst danach den Produktivverkehr frei.
Umfang und Bandbreite der Ereignisse in der Buchungsintegration
Tag 2 und 3: Daten der Person und der Firma in der Meldung
Laut Spezifikation sendet das Zutrittssystem in der Buchungsmeldung den Zeitpunkt des Ereignisses am Leser, die Richtung (Eingang oder Ausgang), die Ereigniskennung, den Ort der Buchung und die Daten der Person: Vor- und Nachname (Pflicht), Kürzel, Firma (Firmenname Pflicht), Nummer der aktiven Karte, Telefon, E-Mail und Sprache. Die Nummer der aktiven Karte ist die Kennung, über die InnerWeb die Buchung dem Konto der Person zuordnet. Die Fremdfirma wird anhand des Firmennamens aus der Meldung zugeordnet.
Am zweiten und dritten Tag wird geprüft, wer im System auftaucht. Eine Buchung einer Person, die InnerWeb nicht kennt, legt Konto und Firma aus den Meldungsdaten an. Ist dieselbe Firma im Zutrittssystem einmal mit vollem Namen und einmal als Kurzform erfasst, entstehen zwei Firmen. Deshalb vergleichen Werkschutz und Personalwesen in diesem Zeitfenster die Firmenliste im Zutrittssystem mit der Firmenliste in InnerWeb und vereinheitlichen die Schreibweise an der Quelle.
- Vergleich der Firmennamen im Zutrittssystem und in InnerWeb
- Prüfung, ob jede Person eine Nummer der aktiven Karte hat
- Kontrolle, ob das Sprachfeld bei ausländischen Personen gefüllt ist
Tag 4 und 5: Buchungsorte und Schulungsalarm
Das Feld für den Buchungsort unterscheidet die Standorte der Leser. Ereignisse von einem Ort, für den in InnerWeb keine Vorlage definiert ist, landen im Protokoll und lösen keinen Schulungsalarm aus. Das ist die häufigste Überraschung am vierten Tag: Der Leser am Haupttor funktioniert wie erwartet, der Leser am Lieferantentor schreibt nur ins Protokoll und löst keine Reaktion aus.
Der Werkschutz geht deshalb die Liste aller Orte durch, von denen Meldungen eingehen, und entscheidet für jeden Ort, ob dort eine Vorlage mit Schulungspflicht gelten soll. Erst ein vollständiger Satz an Vorlagen gibt die Sicherheit, dass fehlende Schulungen unabhängig vom genutzten Tor gemeldet werden.
Tag 6: Prüfung der Last und der Ereignisserien
In einem Werk mit mehreren Fremdfirmen verläuft der Kartenverkehr während der Schichtwechsel stoßweise. In einem Werk mit vielen Zeitarbeitsfirmen kann der Verkehr an einem Werktag 2.000 Buchungen überschreiten, daher muss die Integration gegen Ereignisserien und Wiederholungen robust sein. Am sechsten Tag prüft die IT auf Seiten des Zutrittssystems, ob nach einem Leitungsausfall die Warteschlange der Meldungen der Reihe nach gesendet wird und ob Wiederholungen keine Ereignisse doppelt anlegen.
Die Spezifikation verlangt, dass das Zutrittssystem Ereignisse in Echtzeit sendet, mit dem Zeitpunkt des Ereignisses am Leser. Das ist die Voraussetzung für eine verlässliche Erfassung der Zutritte und der Arbeitszeit.
Auf Seiten von InnerWeb empfiehlt es sich, parallel eine Kontrollansicht für den Werkschutz vorzubereiten, in der Ereignisse neuer Leser sofort sichtbar sind. So lässt sich in den ersten Tagen des Produktivbetriebs ein Leser erkennen, der Daten in einem anderen Format sendet als die übrigen.
Tag 7: Was der Webhook allein nicht leistet
Der Webhook mit der Kartenbuchung allein ergibt noch keine Arbeitszeiterfassung: Dafür ist die Zuordnung der Ereignisse zu Eingängen und Ausgängen nötig. Am letzten Tag der Woche legt das Team fest, ob die Buchungen das Eingangsregister speisen sollen, und hält zusammen mit der Spezifikation des Dienstleisters des Zutrittssystems die Regeln für das Paaren von Ein- und Ausgängen sowie das Verwerfen von Dubletten fest.
Der Mehrwert von InnerWeb liegt in der Verbindung der Buchung mit Konto, Schulungen und Berechtigungen. Die Buchung im Zutrittssystem zeigt nur, dass eine Person einen Punkt passiert hat. InnerWeb beantwortet die Frage, ob sie dies gemäß den Anforderungen des Werks tun durfte.
Videomaterial
Häufig gestellte Fragen
Müssen für die Integration Kartenleser ausgetauscht werden?
Nein. InnerWeb stellt keine Kartenleser her und tauscht sie nicht aus. Die Anbindung erfolgt an das bestehende Zutrittssystem, das Buchungen per Webhook sendet.
Was passiert, wenn der Token abläuft?
Der Aufruf wird abgewiesen. Der Token ist zeitlich begrenzt gültig, daher sollte der Dienst auf Seiten des Zutrittssystems ihn automatisch über den Anmeldeendpunkt erneuern.
Wird die Buchung einer unbekannten Person abgewiesen?
Nein. Das System legt Konto und Firma aus den Meldungsdaten an, daher müssen Personendaten und Firmenname einheitlich sein.
Sie haben ein Zutrittssystem und wollen den Arbeitsschutz ergänzen?
Vereinbaren Sie ein Gespräch über die Webhook-Integration mit Ihrem Zutrittssystem. Wir prüfen, welche Daten der Anbieter sendet und was auf Seiten von InnerWeb einzurichten ist.
Sprechen wir