InnerWeb
Zum Inhalt springen

FAQ: KD-Integration mit Arbeitsschutz und Zeiterfassung

Der Integrator eines Zutrittskontrollsystems stellt vor dem Start immer dieselben Fragen: In welchem Format soll die Buchung gesendet werden, wie erfolgt die Authentifizierung und was passiert, wenn dasselbe Ereignis zweimal ankommt? Die folgenden Antworten kann der KD-Anbieter ohne Raten in seine Spezifikation übernehmen.

12 Std.
Gültigkeit des JWT-Tokens des technischen Kontos
Quelle: karta
13 s
Aktualisierung der Fluchtwegliste
Quelle: karta
6 Gruppen
Einteilung der Personen auf der Fluchtwegliste
Quelle: karta

Wer liest die Ereignisse und wer liefert die Leser?

InnerWeb ist Softwarehersteller und fertigt oder tauscht keine Zutrittsleser aus. Leser, Steuerungen und Karten bleiben beim Kunden und bei seinem KD-Anbieter. Unser System nimmt die Kartenbuchungen aus dem bestehenden KD-System über einen Webhook entgegen und verknüpft sie mit Qualifikationen, Erlaubnissen, Anwesenheit und Zeiterfassung.

Der KD-Anbieter erhält von uns die Spezifikation des Buchungsereignisses. So muss er den inneren Aufbau unseres Systems nicht kennen, und der Betrieb muss seine Torausstattung nicht austauschen.

Wie authentifiziert sich der KD-Anbieter im System?

Die Authentifizierung erfolgt über ein technisches Konto und ein JWT-Token. Das Token ist 12 Stunden gültig, daher muss die Integration es vor Ablauf erneuern oder nach einer Ablehnung wegen Ablaufs neu anfordern.

Das technische Konto dient ausschließlich dem Senden von Ereignissen. Es ist kein Mitarbeiterkonto und sollte keine Berechtigung zum Einsehen personenbezogener Daten haben.

  • Ein eigenes technisches Konto für jedes KD-System, damit es unabhängig gesperrt werden kann.
  • Erneuerung des Tokens mit Zeitreserve, nicht in der letzten Minute der Gültigkeit.
  • Speicherung der Zugangsdaten auf Seiten des KD-Anbieters im Geheimnisspeicher, nicht im Code.

Parameter der Buchungsintegration

Parameter der BuchungsintegrationSäulendiagramm: Token 12 Stunden, Aktualisierung der Liste 13 Sekunden, sechs Gruppen von Personen051015AnzahlGültigkeit des Tokens (Std.): 12 Anzahl12 AnzahlGültigkeit des Tokens (Std.)Aktualisierung der Fluchtwegliste (s): 13 Anzahl13 AnzahlAktualisierung derFluchtwegliste (s)Gruppen auf der Liste: 6 Anzahl6 AnzahlGruppen auf der Liste
Quelle: Funktionskarten: KD-Integration über Webhook und Fluchtwegliste

Woraus besteht die Buchungsnachricht?

Die Nachricht enthält den von der Steuerung erfassten Buchungszeitpunkt, die Kennung des Lesers, die Person und die Kartennummer in der Form objektcode-nummer. Optional gibt der Anbieter die Durchgangsrichtung und eine Ereigniskennung an.

Der Zeitpunkt stammt aus der Steuerung und nicht aus dem Zeitpunkt, zu dem die Nachricht bei uns eintrifft. Das ist für die Zeiterfassung wichtig: Nach einem Netzausfall kann die Steuerung nachgeholte Buchungen senden, und deren Uhrzeit bleibt korrekt.

Kartennummer in der Form objektcode-nummer

Der Objektcode unterscheidet Karten aus verschiedenen Anlagen, die dieselbe Nummer haben könnten. Das System verknüpft die Karte mit dem Konto der Person, daher reicht die Übertragung der Nummer ohne Objektcode nicht für eine eindeutige Zuordnung.

Durchgangsrichtung

Die Richtung ist optional. Wenn Sie sie angeben, unterscheidet das System Eingang und Ausgang und berechnet die Anwesenheit. Fehlt sie, richtet sich die Erfassung nach den für den jeweiligen Leser festgelegten Regeln.

Was bedeutet Idempotenz und wozu dient die Ereigniskennung?

Netze sind störanfällig, daher sendet die Steuerung ein Ereignis erneut, wenn keine Bestätigung eintrifft. Ohne Ereigniskennung könnte dieselbe Buchung zweimal gespeichert werden und die Arbeitszeit verfälschen.

Die Ereigniskennung erkennt Wiederholungen: Eine erneute Meldung mit derselben Kennung erzeugt keine zweite Buchung. Wir empfehlen deshalb, sie immer anzugeben, auch wenn das Feld optional ist.

Was macht das System mit der Buchung im Arbeitsschutz und in der Zeiterfassung?

Die Scans am Tor bilden auch die Fluchtwegliste und zugleich die Zeiterfassung: Tages-, Monats- und Jahresansichten, Ausnahmewarteschlangen, Abschluss des Zeitraums und Erinnerungen an einen nicht erfassten Ausgang. Das Modul der Zeiterfassung ist standardmäßig deaktiviert, und der Betrieb schaltet es bewusst ein.

Die Fluchtwegliste aktualisiert sich alle 13 Sekunden und teilt Personen in sechs Gruppen ein: Gäste, Kuriere, Lieferanten, Beschäftigte des Betriebs, Fremdfirmen und unsicher. Die Daten stammen aus denselben Buchungen, daher sendet der KD-Anbieter sie nicht getrennt.

Wie prüfe ich die Integration vor dem Produktivbetrieb?

Wir empfehlen einen kurzen Test bei geschlossenem Tor: mehrere Buchungen von der Steuerung, die Wiederholung desselben Ereignisses, eine Buchung mit einer gesperrten Karte und eine Buchung nach einem simulierten Netzausfall. Der Nachweis dieses Tests ist das Protokoll der Ereignisse auf beiden Seiten, das der Integrator der Abnahmedokumentation beilegt.

  • Gültige Buchung: Es entsteht ein Eintrag mit dem Zeitpunkt der Steuerung.
  • Wiederholung mit derselben Kennung: kein zweiter Eintrag.
  • Abgelaufenes Token: Ablehnung und erfolgreiche Erneuerung.
  • Gesperrte Karte: Die Buchung gewährt keinen Zugang, der von Schulungen abhängt.

Checkliste

Videomaterial

Häufig gestellte Fragen

Tauscht InnerWeb Leser oder Steuerungen aus?

Nein. Wir integrieren uns mit dem bestehenden KD-System und übernehmen daraus die Ereignisse. Die Torausstattung bleibt beim Kunden und bei seinem Anbieter.

Ist die Angabe der Richtung Pflicht?

Nein, sie ist optional. Wenn Sie sie angeben, unterscheidet das System Eingang und Ausgang; ohne sie richtet sich die Erfassung nach den Regeln des Lesers.

Was passiert, wenn dasselbe Ereignis erneut gesendet wird?

Bei derselben Ereigniskennung entsteht keine zweite Buchung. Ohne Kennung erkennt das System die Wiederholung nicht, daher empfehlen wir, sie immer anzugeben.

Arbeitet das Zeiterfassungsmodul sofort?

Nein, es ist standardmäßig deaktiviert. Der Betrieb schaltet es ein, nachdem die Regeln für Ausnahmen und den Abschluss des Zeitraums festgelegt sind.

Wir übergeben die Spezifikation an Ihren KD-Anbieter

Vereinbaren Sie ein Gespräch mit dem Integrator: Wir besprechen Format des Ereignisses, Authentifizierung und Testszenarien vor der ersten Buchung.

Sprechen wir