InnerWeb
Zum Inhalt springen

Zutrittskontrolle und Arbeitsschutz: Webhook im Werk

Wer im Werk bereits ein funktionierendes Zutrittskontrollsystem betreibt, muss die Leser nicht austauschen, um Arbeitsschutzschulungen an der Pforte zu prüfen. Es genügt, dass das Zutrittssystem bei jeder Kartenbuchung einen HTTP-POST-Aufruf an InnerWeb sendet. Im Folgenden ist der Einführungsablauf für ein mittelgroßes Produktionswerk Tag für Tag beschrieben.

3
Merkmale jedes Ereignisses: Zeit am Leser, Richtung, Kennung
Quelle: Spezifikation der Integration
2.000+
Buchungen pro Werktag in einem Werk mit vielen Zeitarbeitsfirmen

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

Umfang und Bandbreite der Ereignisse in der BuchungsintegrationZwei Balken: mehr als 2.000 Buchungen pro Tag und 3 Merkmale je Ereignis.0500100015002000WertBuchungen pro Tag (Werk mit Zeitarbeit): 2000 Wert2000 WertBuchungen pro Tag (Werk mit Zeitarbeit)Merkmale eines Ereignisses laut Spezifikation: 3 Wert3 WertMerkmale eines Ereignisses lautSpezifikation
Quelle: und

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