Aufteilung der Verantwortung
InnerWeb empfängt Ereignisse des Kartenvorhalts aus dem Zutrittskontrollsystem per Webhook. Das System stellt keine Leser her und ersetzt sie nicht. Auf Seiten des Integrators bleibt die Konfiguration des Zutrittssystems, auf Seiten von InnerWeb die Zuordnung des Ereignisses zu Person, Qualifikationen und Berechtigungen.
Ereignisse der Leser lassen sich mit Qualifikationen, Berechtigungen, Anwesenheit und Arbeitszeiterfassung verknüpfen. Ein Kartenvorhalt kann also mehrere Prozesse gleichzeitig speisen, sofern die Kartenkennung eindeutig einer Person zugeordnet ist.
Schritt 1: Ereignisvertrag abstimmen
Beginnen Sie mit einem kurzen Vertragsdokument: welche Felder das Zutrittssystem sendet, welches Zeitformat gilt, wie Richtung und Kontrollpunkt gekennzeichnet werden. In diesem Schritt erfinden wir kein Format nach Wunsch: Der Integrator beschreibt, was sein System senden kann, und wir bilden das auf unser Ereignismodell ab.
Das Minimum für die Zuordnung eines Ereignisses sind Kartenkennung, Ereigniszeit und Kennung des Kontrollpunkts. Der Rest, etwa die Richtung, erleichtert die Ortung, ist aber keine Bedingung für den Start.
- Kartenkennung in einem stabilen Format.
- Ereigniszeit mit Zeitzone.
- Kennung des Lesers oder Kontrollpunkts.
- Richtung des Eintritts oder Austritts, sofern das System sie kennt.
Schritte der Webhook-Integration und typischer Aufwand (Beispiel)
Schritt 2: Karten Personen zuordnen
Der Webhook ist ohne eine Zuordnungstabelle nutzlos: welche Kartenkennung gehört zu welcher Person. Die Zuordnungen sollten aus einer einzigen Quelle stammen, am besten aus dem Personalsystem oder der Registrierung, nicht aus manuellen Listen des Integrators.
Verschlüsselte Karten ändern diesen Schritt nicht, wohl aber das, was auf der Integrationsseite sichtbar ist: Die Kennung kann eine Ableitung eines im Zutrittssystem verwalteten Schlüssels sein. Wichtig ist, dass die Kennung im Webhook dieselbe ist wie die in der Zuordnung gespeicherte.
Verlorene und Ersatzkarten
Sperren Sie eine verlorene Karte im Zutrittssystem, und bewahren Sie in InnerWeb den Eintrag, damit frühere Ereignisse der richtigen Person zugeordnet bleiben.
Temporäre Karten
Bei Gästen und Auftragnehmern brauchen temporäre Karten einen ausdrücklichen Anfang und ein Ende der Zuordnung, sonst erben die nächsten Personen fremde Qualifikationen.
Schritt 3: Sicherheit und Zuverlässigkeit
Der Webhook sollte eine Authentifizierung haben, etwa ein gemeinsames Geheimnis oder eine Signatur, und die Quelle sollte auf das Netz des Integrators beschränkt sein. Die Übertragung innerhalb des OT-Netzes muss mit der IT abgestimmt werden, planen Sie das also früh und nicht am Starttag.
Ereignisse, die von InnerWeb an externe Systeme gehen, laufen über eine Outbox-Warteschlange, und eine erneute Zustellung ist möglich, wenn das empfangende System vorübergehend nicht erreichbar ist. Dasselbe Muster empfiehlt sich auf Seiten des Zutrittssystems: eine Warteschlange mit Wiederholungen statt eines einzigen Versuchs.
Schritt 4: Abnahmetest
Der Test beginnt mit einem einzigen Ereignis einer Testkarte, die der Kunde benennt. Prüfen Sie, ob das Ereignis bei der richtigen Person in InnerWeb erscheint und ob sich der Status der Berechtigung oder der Anwesenheit ändert.
Danach folgt ein Lasttest: eine Reihe von Ereignissen in kurzer Zeit, etwa ein Schichtwechsel am Drehkreuz. Am Ende steht der Ausfalltest: Unterbrechung der Verbindung und Nachzustellung der aufgelaufenen Ereignisse nach deren Ende.
Was Sie dem Auftraggeber nach der Abnahme übergeben
Der Auftraggeber sollte eine kurze Dokumentation erhalten: Vertrag, Ablaufschema, Liste der Kontrollpunkte und ein Verfahren für den Ausfall. Ohne sie braucht jeder Austausch eines Lesers eine erneute Analyse.
Halten Sie außerdem fest, wer für die Zuordnungen der Karten verantwortlich ist. Diese Frage kommt nach einem Jahr zurück, wenn der Anbieter des Zutrittssystems wechselt.
Checkliste
Videomaterial
Häufig gestellte Fragen
Liefert InnerWeb Kartenleser?
Nein. InnerWeb ist Software-Hersteller, stellt keine Leser her und ersetzt sie nicht.
Muss der Webhook direkt vom Zutrittssystem kommen?
Wir nehmen Ereignisse vom Zutrittssystem an. Ein Vermittler im OT-Netz ist zulässig, wenn er Zeit und Kartenkennung unverändert lässt.
Was passiert mit aufgelaufenen Ereignissen nach einem Ausfall?
Wir empfehlen eine Warteschlange mit Wiederholungen auf Seiten des Zutrittssystems. Auf Seiten von InnerWeb gilt ein entsprechendes Muster für ausgehende Ereignisse.
Wofür dienen die Ereignisse nach der Integration?
Zur Verknüpfung mit Qualifikationen, Berechtigungen, Anwesenheit und Arbeitszeiterfassung.
Verbinden Sie Zutrittskontrolle mit Berechtigungen?
Wir schicken dem Anbieter des Zutrittssystems den Ereignisvertrag und eine Fragenliste und begleiten Sie durch den Abnahmetest.
Sprechen wir