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
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