InnerWeb
Zum Inhalt springen

Serviceeinlass ins Wasserwerk mit KD-Karte: Umsetzungsszenario

Ein Servicetechniker eines Fremdunternehmens hält seine Karte am Tor des Wasserwerks an den Leser, und das System prüft, ob er gültige Berechtigungen und eine Arbeitserlaubnis für den heutigen Tag hat. Wir beschreiben ein Konzept für einen Wasserversorger, in dem ein Ereignis aus dem bestehenden KD-System Arbeitserlaubnisse und das Anwesenheitsregister speist. InnerWeb tauscht weder Karten noch Leser aus.

180 s
Schwelle für das Verwerfen doppelter Abbuchungen
Quelle: karta
13 h
Fenster für das Paaren von Eintritt und Austritt
Quelle: karta

Szenario: Service am Tor der Wasseraufbereitung

Die Wasseraufbereitung hat ein Zutrittskontrollsystem mit Näherungskarten und Lesern am Haupttor sowie an mehreren Techniktüren. Regelmäßig kommen Fremdfirmen zur Anlage: Pumpenservice, Automatisierung, Chemikaliendosierung. Bisher ging das Tor allein auf die Karte auf, und ob die Person heute einen Auftrag und eine Schulung hat, prüfte der diensthabende Mitarbeiter auf einer Papierliste.

Der Betreiber möchte, dass ein einziges Kartenabbuchen gleichzeitig drei Dinge auslöst: den Eintrag im Anwesenheitsregister, die Prüfung der Berechtigungen und die Verknüpfung der Person mit der Arbeitserlaubnis. Dies ist ein Umsetzungsszenario und kein Bericht über ein abgeschlossenes Projekt. Wir zeigen, wie sich diese Kette auf der vorhandenen Infrastruktur aufbauen lässt.

So gelangt ein KD-Ereignis zu InnerWeb

InnerWeb nimmt Kartenabbuchungen aus dem Zutrittskontrollsystem als HTTPS-Nachricht entgegen, die von der Anlage auf Port 443 initiiert wird. Die Anlage öffnet keine eingehenden Ports. Die Authentifizierung erfolgt über ein technisches Konto und ein Token mit begrenzter Gültigkeit, das die Integration automatisch erneuert. Für die IT ist das ein Muster, das anderen ausgehenden Integrationen ähnelt.

Das KD-System sendet Ereignisse in Echtzeit. Die Nachricht enthält die Zeit am Leser, die Leser-ID, die Person, die Kartennummer, die Richtung (Eintritt oder Austritt) und eine Ereignis-ID, die für Idempotenz sorgen soll. Die Regeln für das Paaren von Ein- und Austritten sowie für das Verwerfen von Duplikaten, etwa ein Fenster von 13 Stunden und eine Schwelle von 180 Sekunden, werden mit dem KD-Anbieter in der Spezifikation festgelegt. So verfälscht ein doppeltes Vorhalten der Karte an einem klemmenden Tor das Register nicht.

Wichtig für das Budget: Die Integration erfordert keinen Austausch von Karten oder Lesern. InnerWeb ist Softwarehersteller und kein Hersteller von Zutrittslesern, daher nutzt die Lösung das, was die Anlage bereits besitzt.

  • HTTPS-Nachricht vom KD-System oder dessen Integrationsgateway
  • Authentifizierung: technisches Konto und Token mit begrenzter Gültigkeit, automatisch erneuert
  • Felder: Zeit am Leser, Leser, Person, Kartennummer, Richtung, Ereignis-ID
  • Regeln zum Verwerfen von Duplikaten werden in der Spezifikation mit dem KD-Anbieter festgelegt

Beispielparameter der Spezifikation für KD-Abbuchungen

Beispielparameter der Spezifikation für KD-AbbuchungenBalkendiagramm: Beispiel für eine Duplikatschwelle von 180 Sekunden und ein Paarungsfenster von 46 800 Sekunden.010.00020.00030.00040.00050.000sDuplikatschwelleDuplikatschwelle: 180 s180Paarungsfenster (13 h)Paarungsfenster (13 h): 46.800 s46.800
Quelle: Beispielparameter der Spezifikation für die Integration von Kartenabbuchungen aus dem KD-System

Was das System prüft, bevor sich das Tor öffnet

Beim Erstellen einer Arbeitserlaubnis prüft das System automatisch, ob die zugewiesenen Mitarbeitenden die erforderlichen, gültigen Berechtigungen haben. Ein Servicetechniker ohne aktuelle Schulung oder Qualifikation für Arbeiten in einem geschlossenen Raum wird somit gar nicht erst auf die Erlaubnis gesetzt, und am Besuchstag gibt es nichts, was man öffnen könnte.

Der Betreiber muss allerdings entscheiden, in welcher Phase das KD-Ereignis Einfluss auf das Tor hat. In der einfachsten Variante landet das Abbuchen im Register, und der diensthabende Mitarbeiter sieht laufend, wer eingetreten ist und ob eine Erlaubnis bestand. In der erweiterten Variante erhält das KD-System von InnerWeb die Information, ob eine Person heute eine gültige Erlaubnis hat, und entscheidet auf seiner Seite über das Öffnen. Diese Rückkopplung ist mit dem KD-Anbieter abzustimmen, nicht allein in der Konfiguration von InnerWeb.

Gegenüber der Anlagenleitung sollte man klar sagen: InnerWeb liefert den Nachweis und das Urteil, die Entscheidung über das physische Öffnen bleibt in dem System, das das Schloss steuert.

Erlaubnis, Anwesenheit und nächster Schritt auf der Anlage

Der Antrag der Fremdfirma und die dem Auftragnehmer erteilte Erlaubnis beruhen auf derselben Erlaubnis, die für beide Seiten sichtbar ist. Die Servicefirma stellt den Antrag, der Anlagenbetreiber genehmigt ihn, und am Arbeitstag bestätigt das Abbuchen der Karte die Anwesenheit der Person auf dem Gelände.

Auf dem Bildschirm des Auftragnehmers bedeuten Grün und die Anzeige „Sie arbeiten“ ausschließlich die Freigabe für die Hauptarbeiten. Ein Team, das auf vorbereitende Aufgaben wartet, sieht einen bernsteinfarbenen Hinweis zum Handeln. Das ist für die Anlage wichtig, wo vor dem Öffnen eines Behälters zuerst abgesperrt, abgepumpt und belüftet werden muss, bevor man hineingeht.

Alle Änderungen an Erlaubnissen werden mit Autor und Zeitpunkt gespeichert, sodass sich bei einer Kontrolle oder nach einem Vorfall nachvollziehen lässt, wer den Auftragnehmer wann freigegeben hat.

Gespräch mit dem KD-Anbieter: was zu klären ist

Mit dem KD-Anbieter sind drei Punkte offen: ob das System Ereignisse per HTTPS POST senden kann, welche Leser Eingang und welche Ausgang sind und wie der Export der Karten aussieht. Der Rest liegt auf der Seite von InnerWeb.

Es empfiehlt sich, dieses Gespräch vor dem ersten Projekttermin zu führen und die Antwort schriftlich vorzubereiten. Das verkürzt die Inbetriebnahme und zeigt sofort, ob die Variante mit dem Register genügt oder eine Rückkopplung zum Öffnen des Tors nötig ist.

Fazit für den Betreiber der Anlage

Ein Scan, drei Wirkungen: Eintrag in die Anwesenheit, Prüfung der Berechtigungen und Verknüpfung mit der Erlaubnis. Beginnen Sie mit einem Eingang an einer Anlage, vergleichen Sie zwei Wochen lang die Ereignisse mit dem manuellen Register und erweitern Sie erst danach auf weitere Objekte.

Videomaterial

Häufig gestellte Fragen

Müssen die Kartenleser ausgetauscht werden?

Nein. Die Integration mit der Zutrittskontrolle erfordert keinen Austausch von Karten oder Lesern. InnerWeb nutzt die Ereignisse des bestehenden KD-Systems.

Muss die Anlage eingehende Ports öffnen?

Nein. Die Nachricht wird von der Anlage als HTTPS-Verbindung auf Port 443 initiiert.

Wer entscheidet über das Öffnen des Tors?

Das System, das das Schloss steuert. InnerWeb liefert Ereignisse, Berechtigungen und das Urteil, eine eventuelle Rückkopplung ist mit dem KD-Anbieter abzustimmen.

Was passiert bei einer fehlerhaften Abbuchung oder einem klemmenden Tor?

Die Ereignis-ID soll für Idempotenz sorgen, die Regeln zum Verwerfen von Duplikaten werden in der Spezifikation mit dem KD-Anbieter festgelegt.

Sprechen wir über die Integration mit Ihrem KD-System

Wir bereiten eine Liste von Fragen für Ihren KD-Anbieter vor und zeigen die Kette von der Kartenabbuchung bis zum Anwesenheitseintrag anhand der Daten Ihrer Anlage.

Sprechen wir