InnerWeb
Zum Inhalt springen

Zutrittssystem mit OSDP und Webhook für Ereignisse: Hinweise zur Umsetzung für den Administrator

Nach dem Austausch der Wiegand-Leser auf OSDP befürchtet der Administrator des Zutrittssystems, dass die Integrationen mit externen Systemen aufhören zu funktionieren. Die Regel ist einfach: InnerWeb empfängt die Ereignisse vom Zutrittssystem und nicht vom Leser, daher ändert eine Umstellung der Verbindung zwischen Leser und Steuerung den Vertrag des Webhooks nicht. Im Folgenden die Punkte, die bei der Umschaltung zu prüfen sind.

443
Port der ausgehenden Verbindung der Integration
Quelle: interne Karte der Integration
12 Std.
Gültigkeit des JWT-Tokens
Quelle: interne Karte der Integration
2.100
Buchungen täglich in einer ähnlichen Integration
Quelle: interne Karte der Umsetzung

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

Parameter der Integration des Zutrittssystems mit InnerWebHorizontales Balkendiagramm: 2.100 Buchungen täglich, Zuordnungsfenster 780 Minuten, Token 12 Stunden, Schwelle für Doppelbuchungen 180 Sekunden.05001000150020002500WertBuchungen täglichBuchungen täglich: 2100 Wert2100Zuordnungsfenster (Min.)Zuordnungsfenster (Min.): 780 Wert780JWT-Token (Std.)JWT-Token (Std.): 12 Wert12Schwelle Doppelbuchung (s)Schwelle Doppelbuchung (s): 180 Wert180
Quelle: Interne Karte der Integration; das Fenster von 13 Stunden entspricht 780 Minuten

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