Wo OSDP endet und der Webhook beginnt
OSDP betrifft die Verbindung zwischen Leser und Steuerung. Der Webhook betrifft den Weg vom Zutrittssystem zu InnerWeb. Das sind zwei unabhängige Schichten: Nach dem Austausch der Leser erfasst die Steuerung weiterhin die Kartenbuchung, und die Software des Zutrittssystems kann weiterhin eine Nachricht über HTTPS senden.
InnerWeb arbeitet als eigenständiges System, das die bestehenden Systeme des Kunden (Zutrittssystem, Zeiterfassung, Personalwesen, ERP) ergänzt. Eine Änderung des Protokolls zwischen Leser und Steuerung erfordert daher keine Änderungen auf Seite von InnerWeb, solange das Zutrittssystem weiterhin Ereignisse sendet. Diese eine Bedingung ist entscheidend, und auf sie stützen sich die Prüfungen nach der Umstellung.
Was die Nachricht enthält und was sich nach dem Austausch ändern kann
Die Buchungsnachricht enthält die Buchungszeit aus der Steuerung, die Kennung des Lesers, die Person, die Kartennummer in der Form Objektcode-Nummer und optional die Richtung sowie eine Ereigniskennung für die Idempotenz. Nach dem Austausch des Lesers kann sich die Kennung des Lesers ändern, falls der neue Leser im Zutrittssystem eine andere Adresse oder einen anderen Namen erhalten hat.
Stimmen Sie deshalb vor der Umschaltung ab, ob die Kennungen der Leser gleich bleiben oder ob die Zuordnung Leser zu Standort auf Seite von InnerWeb aktualisiert werden muss. Ohne dies kommen die Buchungen zwar an, werden aber dem falschen Ort zugeordnet.
Richtung von Eingang und Ausgang
Wenn die neuen OSDP-Leser getrennte Eingangs- und Ausgangsbuchungen ermöglichen, kann das Zutrittssystem beginnen, das Feld der Richtung zu senden. Ohne Richtung erfolgt die Zuordnung von Eingang zu Ausgang in der Software von InnerWeb: Fenster bis 13 Stunden, Doppelbuchung unter 180 s. Testen Sie beide Varianten, bevor Sie die Einstellungen ändern.
Parameter der Integration des Zutrittssystems mit InnerWeb
Netz und Authentifizierung bleiben gleich
Bei der Integration mit dem Zutrittssystem baut die Seite des Werks die Verbindung als ausgehenden Verkehr auf Port 443 auf, daher müssen keine eingehenden Ports im Netz des Werks geöffnet werden. Der Austausch der Leser ändert diesen Grundsatz nicht und erfordert keine Änderungen der Firewall-Regeln.
Die Authentifizierung der Integration erfolgt über ein technisches Konto und ein JWT-Token mit 12 Stunden Gültigkeit. Prüfen Sie bei der Umschaltung, ob der Server des Zutrittssystems das Token rechtzeitig erneuert, denn ein langes Wartungsfenster kann die Gültigkeit des Tokens überschreiten und den Versand anhalten.
Abnahmetest nach der Umschaltung eines Tores
Führen Sie nach jedem Tor einen Test durch: Buchung einer Testkarte am neuen Leser, Prüfung des Ereignisses im Zutrittssystem, Prüfung, ob das Ereignis in InnerWeb angekommen ist, und Kontrolle des Standorts des Lesers. Halten Sie Uhrzeit und Ergebnis des Tests im Abnahmeprotokoll fest.
Die Ereignisse aus dem Zutrittssystem gelangen in die Anwesenheitserfassung und, wenn das Modul aktiviert ist, in die Erfassung der Arbeitszeit. Das Modul für die Arbeitszeit wird standardmäßig ausgeschaltet und vom Administrator eingeschaltet, daher bedeuten fehlende Buchungen nicht immer einen Fehler der Integration.
- Testbuchung und Bestätigung des Ereignisses im Zutrittssystem
- Ereignis in InnerWeb mit dem richtigen Leser sichtbar
- Standort des Lesers stimmt mit der Karte überein
- keine Duplikate bei einer Buchung, die in kurzem Abstand wiederholt wird
- Ergebnis im Abnahmeprotokoll festgehalten
Idempotenz und Ereignisse nach einer Unterbrechung
Hat die Warteschlange des Zutrittssystems während der Umschaltung Buchungen gesammelt, können nach dem Wiederaufnehmen des Versands Ereignisse verspätet oder mehrfach ankommen. Die Ereigniskennung sorgt für Idempotenz: dasselbe Ereignis, zweimal gesendet, erzeugt keine zwei Buchungen.
Bei hohem Verkehr spielt der Umfang eine Rolle: In einer ähnlichen Integration, die seit 2024 läuft, werden an Werktagen etwa 2.100 Buchungen täglich verarbeitet. Bei diesem Volumen erzeugt ein Wartungsfenster mitten in der Schicht Hunderte aufgelaufener Ereignisse, daher sollte es in eine Produktionspause gelegt werden.
Videomaterial
Häufig gestellte Fragen
Erfordert der Austausch der Leser auf OSDP Änderungen in InnerWeb?
Nein, solange das Zutrittssystem weiterhin Buchungsereignisse sendet. Es lohnt sich, die Kennungen der Leser und die Zuordnung zu Standorten zu prüfen.
Müssen nach dem Austausch der Leser eingehende Ports geöffnet werden?
Nein. Die Verbindung wird von der Seite des Werks als ausgehender Verkehr auf Port 443 aufgebaut.
Was geschieht mit den Buchungen, die während der Unterbrechung gesammelt wurden?
Sie können nach dem Wiederaufnehmen verspätet ankommen. Die Ereigniskennung sorgt dafür, dass dasselbe Ereignis nicht zweimal gespeichert wird.
Quellen
Tauschen Sie die Leser im Zutrittssystem aus?
Beschreiben Sie uns Ihr Zutrittssystem und den Plan des Austauschs. Wir helfen, einen Test der Ereignisse vorzubereiten, damit die Buchungen nach der Umschaltung nicht aus InnerWeb verschwinden.
Sprechen wir