InnerWeb
Zum Inhalt springen

Checkliste KD-Integration mit InnerWeb

Ein Start des Kartenwebhooks im Betrieb ohne Vorbereitung endet mit Buchungen, die im Protokoll erscheinen, aber am Tor keine Wirkung haben. Die Checkliste ist in einen Teil für den IT-Administrator und einen Teil für den Sicherheitsleiter gegliedert. Jeder Punkt ist begründet, damit Sie die Bereitschaft des Betriebs beurteilen können und nicht nur Häkchen setzen.

11
Punkte der Checkliste der Bereitschaft
Quelle: Checkliste auf dieser Seite
2 000+
Buchungen pro Werktag in einem Betrieb mit Agenturen
Quelle: interne Karte

Teil für den IT-Administrator: Zugang und Authentifizierung

Der IT-Administrator sorgt dafür, dass das KD-System den Webhook sicher aufrufen kann. Der Aufruf benötigt ein Token vom Anmeldeendpunkt der API; das Token hat eine begrenzte Gültigkeit und wird durch die Integration automatisch erneuert. Prüfen Sie vor dem Start, ob der KD-Anbieter ein technisches Konto hat, ob er das Token mit Reserve erneuert und ob er sich nach einer abgelehnten Autorisierung erneut anmeldet.

Prüfen Sie außerdem die Netzwerkverbindung: Hat der Server des KD Zugriff auf die Adresse der API, lassen die Firewall-Regeln dies zu und gehen Ereignisse bei kurzer Nichterreichbarkeit verloren? InnerWeb stellt API und Webhooks für die Anbindung an Systeme des Betriebs bereit, derselbe Kanal kann also später weitere Szenarien bedienen.

Teil für den IT-Administrator: Daten und Felder

Die Meldung enthält die Ereigniszeit des Lesers, den Ort der Buchung und die Daten der Person. Vorname, Nachname und Firmenname sind Pflicht, die Nummer der aktiven Karte ist die Kennung, die die Buchung mit dem Konto verbindet. Die Buchung einer unbekannten Person legt Konto und Firma aus den Daten der Meldung an, daher müssen die Daten im KD einheitlich geschrieben sein, besonders die Namen der Arbeitsagenturen. Vereinbaren Sie vor dem Start mit dem KD-Anbieter ein Wörterverzeichnis der Firmennamen.

Verteilung der Checklistenpunkte auf die Rollen

Verteilung der Checklistenpunkte auf die RollenKreisdiagramm: 5 Punkte für die IT, 3 für den Sicherheitsdienst, 3 gemeinsamIT-Administrator: 5 Punkte (45,5%)Sicherheitsleiter: 3 Punkte (27,3%)Gemeinsam: 3 Punkte (27,3%)11PunkteIT-Administrator5 Punkte (45,5%)Sicherheitsleiter3 Punkte (27,3%)Gemeinsam3 Punkte (27,3%)
Quelle: Verteilung der Checklistenpunkte auf dieser Seite

Teil für den Sicherheitsleiter: Orte und Vorlagen

Der Sicherheitsleiter kennt die Leser und ihre Verteilung. Das Feld des Buchungsorts unterscheidet die Standorte, und Ereignisse von einem Ort ohne Vorlage in InnerWeb landen im Protokoll und lösen keinen Schulungsalarm aus. Erstellen Sie vor dem Start eine Liste aller Leser mit den Namen der Buchungsorte und stellen Sie sicher, dass jeder eine passende Vorlage hat.

Legen Sie außerdem fest, welche Schulungspflicht gilt: Die Pflicht zur Arbeitsschutzschulung kann so eingestellt werden, dass sie alle Firmen außer den benannten Ausnahmen umfasst, und die Schulungsgruppe kann Fassungen in mehreren Sprachen haben. Das ist wichtig für Betriebe mit Beschäftigten verschiedener Nationalitäten aus Arbeitsagenturen.

Gemeinsam: Anforderungen an den Versand der Ereignisse

Beide sollten drei Anforderungen der Spezifikation kennen. Das KD-System sendet Ereignisse in Echtzeit und mit der Ereigniszeit des Lesers. Jedes Ereignis trägt die Richtung Eintritt oder Austritt und eine Ereigniskennung. Die Regeln für die Paarbildung von Ein- und Austritt und für das Verwerfen von Duplikaten werden mit dem KD-Anbieter in der Spezifikation festgelegt. Das Verkehrsaufkommen in einem Betrieb mit mehreren Agenturen kann an einem Werktag 2 000 Buchungen überschreiten, daher muss die Integration Ereignisserien und Wiederholungen verkraften.

InnerWeb produziert und tauscht keine Leser aus. Sendet ein Leser keine Ereignisse, ist die Lösung eine Konfiguration auf Seiten des KD, kein Austausch der Hardware.

Abschlusstest vor dem Produktivbetrieb

Führen Sie einen Test im Livebetrieb durch: eine bekannte Person, eine unbekannte Person, eine doppelte Buchung, eine Buchung an jedem Leser der Liste. Prüfen Sie bei jedem Ereignis, ob es im Eintrittsregister erscheint und nicht nur in der Kontohistorie, denn ein Eintrag in der Kontohistorie bedeutet noch kein funktionierendes Zeiterfassungssystem. Speichern Sie Ergebnisse und Datum des Tests als Nachweis für das Audit.

Checkliste

Videomaterial

Häufig gestellte Fragen

Wer ist für die Liste der Leser verantwortlich?

Der Sicherheitsleiter, der die Verteilung der Leser kennt. Die Liste ist die Grundlage der Vorlagen für Buchungsorte in InnerWeb.

Was ist, wenn ein Leser keine Ereignisse sendet?

Die Lösung ist eine Konfiguration auf Seiten des KD. InnerWeb produziert und tauscht keine Leser aus.

Reicht die Prüfung im Protokoll?

Nein. Die Buchung sollte im Eintrittsregister sichtbar sein, denn ein Eintrag in der Kontohistorie bedeutet noch kein funktionierendes Zeiterfassungssystem.

Prüfen wir die Bereitschaft Ihres Betriebs

Wir gehen mit dem IT-Administrator und dem Sicherheitsleiter diese Liste vor dem Start durch. Vereinbaren Sie ein Gespräch mit dem Team von InnerWeb.

Sprechen wir