InnerWeb
Zum Inhalt springen

Webhook aus dem KD-System zum ergänzenden System: Hinweise zur Umsetzung für die IT

Buchungsereignisse der Karten müssen aus dem KD-System in das ergänzende System gelangen, und der Weg führt durch ein Netz, das in der Regel von getrennten IT- und OT-Teams verwaltet wird. Im Folgenden finden Sie eine Liste der Abstimmungen mit dem KD-Lieferanten und dem OT-Netz, die Reihenfolge der Arbeiten und die Fallstricke, die den Start am häufigsten verzögern.

2
Versionen der REST-API (v1 und v2, JWT)
Quelle: Karte

Was übertragen wird und wozu

InnerWeb nimmt Buchungsereignisse der Karten aus dem bestehenden KD-System per Webhook entgegen und verbindet sie mit Qualifikationen, Freigaben, Anwesenheit und Zeiterfassung. Das KD-System bleibt Eigentümer der Leser und der Entscheidung über das Öffnen des Durchgangs. InnerWeb ist ein unabhängiges ergänzendes System und ersetzt daher nicht KD, Zeiterfassung, Personalwesen oder ERP.

Die Plattform stellt eine REST-API in den Versionen 1 und 2 mit JWT-Autorisierung bereit und Webhooks für Automatisierungsplattformen, und Regeln vom Typ wenn-dann können bei einem Ereignis einen Webhook auslösen. Für die Integration mit dem KD-System ist jedoch die umgekehrte Richtung wichtiger: Das Ereignis sendet das KD-System.

Abstimmungen mit dem KD-Lieferanten

Die Spezifikation für den Lieferanten sollte ein einziges Dokument sein. Nach diesem Muster wurde beim Verpackungshersteller die Integration der Kartenbuchungen aus dem KD-System mit der Zeiterfassung aufgebaut, ohne Leser von InnerWeb.

  • Format des Ereignisses: Kartenkennung, Kontrollpunkt, Richtung, Zeitstempel mit Zeitzone.
  • Art der Authentifizierung des Aufrufs, zum Beispiel ein Token im Header.
  • Verhalten bei Fehlern: Wiederholungen, Abstände, Grenze der Versuche.
  • Wer den Versand auf Seite des Lieferanten betreut und wie eine Störung gemeldet wird.
  • Ob Ereignisse abgelehnter Buchungen ebenfalls gesendet werden.

Beispielhafte Dauer der Abstimmungen vor dem Start (Arbeitstage)

Beispielhafte Dauer der Abstimmungen vor dem Start (Arbeitstage)Balkendiagramm: 5, 13, 5 und 8 Arbeitstage für die aufeinanderfolgenden Etappen der Abstimmung051015TageSpezifikation mit demKD-LieferantenSpezifikation mit dem KD-Lieferanten: 5 Tage5Ausnahme im OT-NetzAusnahme im OT-Netz: 13 Tage13Tests an einem TorTests an einem Tor: 5 Tage5Übrige ToreÜbrige Tore: 8 Tage8
Quelle: Beispielkalkulation: veranschaulichende Annahmen für ein Werk

Abstimmungen mit dem OT-Netz

Produktionsnetze blockieren häufig den ausgehenden Verkehr vom Host der Anwendung. Für diese Variante gibt es eine fertige Lösung: Blockiert das Netz des Kunden den ausgehenden Verkehr vom Host der Anwendung, werden die Webhooks dauerhaft in einer Warteschlange gespeichert und vom Poller über den eingehenden Kanal abgeholt. Ereignisse gehen nicht verloren, und das OT-Team muss keine neuen ausgehenden Verbindungen öffnen.

Klären Sie mit dem OT-Team drei Punkte: das Netzsegment, aus dem das KD-System Ereignisse sendet, die Regeln der Firewall für die Adresse des Empfängers und das Wartungsfenster für Änderungen. Es lohnt sich außerdem festzulegen, wer eine Ausnahme von der Richtlinie genehmigt, denn das ist meist die längste Etappe.

Reihenfolge der Arbeiten

Eine gute Reihenfolge begrenzt das Risiko eines Stillstands des Verkehrs: zuerst eine Testumgebung mit Buchungen einer Testkarte, dann ein Tor, danach die übrigen. Prüfen Sie auf jeder Etappe die Verzögerung, die Vollständigkeit und die Übereinstimmung der Kartenkennung mit dem Konto der Person.

Beim erneuten Senden von Ereignissen nach einer Störung sollte das System Duplikate erkennen. Klären Sie mit dem Lieferanten, ob ein Ereignis eine eindeutige Kennung hat, denn ohne sie würde eine Wiederholung denselben Eintritt zweimal speichern.

Fallstricke bei der Umsetzung

Der erste ist die Abweichung der Zeitzonen: Ein Ereignis in UTC, das als Ortszeit gelesen wird, verschiebt die Anwesenheit um eine oder zwei Stunden. Der zweite ist das Fehlen eines Kontos für die Karte: Die Buchung kommt an, aber es gibt niemanden, dem sie zugeordnet werden kann. Der dritte ist die Annahme, die verschlüsselte Karte löse die Berechtigungen: Sie prüft die Identität des Datenträgers, und über den Eintritt entscheiden die Berechtigungen auf Seite des Systems. Der vierte ist das Fehlen einer Überwachung der Stille: Eine Integration ohne Ereignisse eine Stunde lang mitten am Tag ist ein Zeichen einer Störung und keine Ruhe.

Videomaterial

Häufig gestellte Fragen

Was geschieht, wenn das OT-Netz den ausgehenden Verkehr blockiert?

Webhooks werden dauerhaft in einer Warteschlange gespeichert, und der Poller holt sie über den eingehenden Kanal ab. Ereignisse gehen nicht verloren, und das OT-Team öffnet keine neuen ausgehenden Verbindungen.

Ist neben dem Webhook eine API nötig?

Nicht immer. Die Plattform stellt eine REST-API in den Versionen 1 und 2 mit JWT bereit, die sich hinzufügen lässt, wenn der Lieferant des KD-Systems eine Integration in beide Richtungen unterstützt.

Wer haftet bei einer Störung des Versands?

Die Parteien legen dies in der Spezifikation fest: Der Lieferant des KD-Systems verantwortet den Versand und die Steuerungen, IT und OT das Netz und InnerWeb die Annahme und Verarbeitung der Ereignisse.

Quellen

Vereinbaren wir den Webhook mit Ihrem Lieferanten

Wir bereiten die Spezifikation der Ereignisse vor und helfen Ihnen, sie mit der IT und dem OT-Team abzustimmen. Vereinbaren Sie ein Gespräch mit dem Team von InnerWeb.

Sprechen wir