Support Hub/API & Integrations/Native Push vs. Hybrid-Modi: Technischer Entscheidungsbaum
Translated from the English article and reviewed by a person. Read the English original
Developer

Native Push vs. Hybrid-Modi: Technischer Entscheidungsbaum

Native Push vs. Hybrid-Modi: Technischer Entscheidungsbaum

Jedes biometrische Gerät, das sich mit dem Cams Biometric Gateway verbindet, tut dies über einen von zwei Push-Modi. Der Modus, den Ihr Gerät verwendet, bestimmt, welche APIs verfügbar sind, wie Ereignisse zugestellt werden und wie Ihre Infrastruktur konfiguriert werden muss. Dieser Leitfaden erläutert jede Variable der Entscheidung, von Gerätetyp über Kommunikationsmethode bis zur Bereitstellungstopologie, damit Sie den richtigen Weg wählen können, bevor Sie mit der Umsetzung beginnen.

Die erste Frage: Welche Art von Gerät verbinden Sie?

Bevor Sie eine Kommunikationsmethode oder Bereitstellungstopologie wählen, gibt es eine grundlegendere Frage zu beantworten: Ist Ihr Gerät ein Cams Biometrics-Gerät oder ein Gerät, das im Cams Developer Portal als verifiziert aufgeführt ist?

Die Antwort auf diese Frage bestimmt vollständig Ihren Push-Modus. Lautet die Antwort ja, verwenden Sie Native Push, und es ist keine weitere Entscheidung erforderlich. Lautet die Antwort nein, befinden Sie sich im Bereich von Hybrid Push, und es folgt eine Reihe weiterer Entscheidungen.

Modus 1
Native Push
Für alle Cams Biometrics-Geräte und alle Geräte, die auf developer.camsbiometrics.com als verifiziert aufgeführt sind. Das Gerät kommuniziert direkt über das Internet mit dem Biometric Gateway, ohne dass zusätzliche Einrichtung erforderlich ist.

Alle 38 Operationen
Vollständige Callback API
Vollständige RESTful API

Modus 2
Hybrid Push
Für alle übrigen nicht verifizierten Geräte. Sie wählen eine Kommunikationsmethode und eine Bereitstellungstopologie, die zu Ihrer Umgebung passen. Die API-Verfügbarkeit hängt von der gewählten Kombination ab.

3 Kommunikationsmethoden
2 Topologieoptionen
Variabler API-Zugriff

Native Push: das vollständige Bild

Native-Push-Geräte erhalten vollen Zugriff auf alle 38 Gateway-Operationen, ohne weitere Konfiguration außer der Verbindung des Geräts mit dem Internet. Die Callback API liefert Ereignisse ohne Latenz. RESTful-API-Befehle werden in etwa 15 Sekunden ausgeführt. Keine SDK, keine lokale Software und keine Topologieentscheidung erforderlich.

Hybrid Push verstehen: drei Kommunikationsmethoden

Wenn Ihr Gerät kein Cams- oder verifiziertes Gerät ist, besteht die nächste Entscheidung darin, wie das Gateway tatsächlich mit Ihrer Hardware kommuniziert. Es stehen drei Kommunikationsmethoden zur Verfügung, und jede hat unterschiedliche Anforderungen und unterschiedliche Auswirkungen darauf, welche API-Funktionen Sie nutzen können.

Die Kommunikationsmethode betrifft nicht Ihre Netzwerkkonfiguration. Es geht um den technischen Mechanismus, mit dem das Gateway Daten von Ihrem spezifischen Gerät liest und Befehle an es sendet. Diese Wahl wird durch die Unterstützung Ihrer Hardware eingeschränkt.

a
Device SDK
Beste Option für vollen API-Zugriff
Das Gateway kommuniziert mit der Hardware über das SDK des Geräteherstellers. Das SDK übernimmt das Protokoll auf niedriger Ebene, und das Gateway stellt alle Funktionen, die das SDK unterstützt, über seine API bereit. Dies ist die einzige Kommunikationsmethode in Hybrid Push, die RESTful-API-Operationen ermöglicht.
Vollständige Callback API + vollständige RESTful API (im Rahmen der SDK-Funktionen)
b
DB Pull
Nur Anwesenheitsdaten
Das Gateway liest aus einer lokalen Datenbank, in die die eigene Verwaltungssoftware des Geräts Anwesenheitsdatensätze schreibt. Das Gateway überwacht diese Datenbank und sendet neue Datensätze in Echtzeit an Ihre Callback-URL. Es findet keine direkte Gerätekommunikation statt, daher können keine Befehle an das Gerät gesendet werden. Operationen wie das Hinzufügen von Benutzern, das Löschen von Datensätzen oder das Laden von Protokollen sind nicht verfügbar.
Callback API: nur Anwesenheits- und Stempelprotokolle. RESTful API: nicht unterstützt.
c
File Processing
Nur Anwesenheitsdaten
Eine festgelegte Anwesenheitsdatei auf dem lokalen Computer wird kontinuierlich überwacht. Jedes Mal, wenn die Gerätesoftware diese Datei mit neuen Anwesenheitsdatensätzen aktualisiert, erkennt das Gateway die Änderung, extrahiert die neuen Datensätze und sendet sie in Echtzeit an Ihre Callback-URL. Wie DB Pull ist diese Methode aus Sicht des Geräts nur lesend und weist dieselben API-Einschränkungen auf.
Callback API: nur Anwesenheits- und Stempelprotokolle. RESTful API: nicht unterstützt.
So wählen Sie eine Kommunikationsmethode

Wenn Ihr Gerät ein Hersteller-SDK besitzt, das vom Cams Gateway unterstützt wird, wählen Sie Device SDK (a). Es ist die einzige Methode, die RESTful-API-Operationen für Hybrid-Push-Geräte freischaltet. Wenn das SDK nicht unterstützt oder nicht verfügbar ist, liefern DB Pull (b) oder File Processing (c) dennoch Anwesenheitsdaten in Echtzeit an Ihren Callback-Endpunkt, was für viele Anwendungsfälle ausreichend ist.

Hybrid Push verstehen: zwei Bereitstellungstopologien

Sobald Sie eine Kommunikationsmethode gewählt haben, besteht die zweite Entscheidung darin, wohin sich das Gateway mit Ihrem Gerät, Ihrer Datenbank oder Ihrer Datei verbindet. Dies ist die Topologieentscheidung, und sie hängt von Ihrer Netzwerkumgebung am physischen Standort des Geräts ab.

Topologie X

Direkt
Der Standortcomputer, an dem das Gerät angeschlossen ist oder auf dem die Geräteverwaltungssoftware läuft, verfügt über eine öffentliche IP-Adresse mit einer Portweiterleitung in das lokale Netzwerk. Das Biometric Gateway verbindet sich direkt über das Internet mit dem Gerät, der Datenbank oder den Dateien.
Erforderlich: öffentliche IP + Portweiterleitung am Standort
Topologie Y

Indirekt
Auf dem lokalen Standortcomputer ist eine Hybrid Connector-Anwendung installiert. Sie fungiert als ausgehende Brücke zwischen dem lokalen Rechner und dem Biometric Gateway und baut die Verbindung von innen auf, statt eine eingehende Verbindung vorauszusetzen. Auf Kundenseite wird keine öffentliche IP benötigt.
Erforderlich: Hybrid Connector auf dem lokalen Computer installiert. Keine öffentliche IP nötig.
Empfehlung zur Topologie

Wenn Sie am Standort keine öffentliche IP oder Portweiterleitung konfigurieren können, wählen Sie die indirekte Topologie (Y) mit dem Hybrid Connector. Dies ist der einfachste Bereitstellungsweg und vermeidet vollständig Netzwerkkonfigurationen auf Kundenseite. Wenn eine öffentliche IP verfügbar und konfiguriert ist, funktioniert auch die direkte Topologie (X), und am Standort ist keine zusätzliche Softwareinstallation erforderlich.

Der Entscheidungsbaum: Welchen Modus sollten Sie wählen?

Gehen Sie diesen Entscheidungsbaum von oben nach unten durch. Halten Sie bei der ersten Antwort an, die auf Ihre Situation zutrifft.

Entscheidungsbaum, Start oben
1. Ist Ihr Gerät ein Cams Biometrics-Gerät oder auf developer.camsbiometrics.com als verifiziert aufgeführt?
Ja Verwenden Sie Native Push. Voller API-Zugriff. Keine weiteren Entscheidungen erforderlich.
Nein Weiter mit Frage 2.
2. Unterstützt das Cams Gateway das SDK für den Hersteller Ihres Geräts?
Ja Verwenden Sie Hybrid Push, Device SDK (a). Vollständiger Callback- und RESTful-API-Zugriff im Rahmen der SDK-Grenzen. Weiter mit Frage 3 zur Topologie.
Nein Weiter mit Frage 2b.
2b. Schreibt Ihre Geräteverwaltungssoftware Anwesenheitsdatensätze in eine lokale Datenbank?
Ja Verwenden Sie Hybrid Push, DB Pull (b). Nur Anwesenheits-Callback. Weiter mit Frage 3 zur Topologie.
3. Verfügt der Standortcomputer über eine öffentliche IP-Adresse mit verfügbarer Portweiterleitung?
Ja Verwenden Sie Direkte Topologie (X). Am Standort ist keine zusätzliche Software erforderlich.
Nein Verwenden Sie Indirekte Topologie (Y). Installieren Sie den Hybrid Connector auf dem lokalen Standortcomputer.

Matrix der Funktionsverfügbarkeit bei Hybrid Push

Die folgende Tabelle zeigt jede Kombination aus Kommunikationsmethode und Bereitstellungstopologie sowie die API-Funktionen, die in jedem Fall verfügbar sind. Verwenden Sie sie zusammen mit dem Entscheidungsbaum, um zu bestätigen, was Ihre gewählte Konfiguration unterstützt.

Modus Kommunikation Topologie Callback API RESTful API
Direktes Gerät (a) Device SDK (X) Öffentliche IP Vollständig Vollständig (SDK-Grenzen gelten)
Indirektes Gerät (a) Device SDK (Y) Hybrid Connector Vollständig Vollständig (SDK-Grenzen gelten)
Direkte DB (b) DB Pull (X) Öffentliche IP Nur Anwesenheit Nicht unterstützt
Indirekte DB (b) DB Pull (Y) Hybrid Connector Nur Anwesenheit Nicht unterstützt
Direkte Datei (c) File Processing (X) Öffentliche IP Nur Anwesenheit Nicht unterstützt
Indirekte Datei (c) File Processing (Y) Hybrid Connector Nur Anwesenheit Nicht unterstützt
Wichtiger Hinweis zur Hardware

Hardwarebeschränkungen können API-Funktionen auch im Device-SDK-Modus weiter einschränken. Bestimmte APIs funktionieren möglicherweise nicht, je nach Firmware-Version des Gerätemodells oder den vom SDK des Herstellers bereitgestellten Funktionen. Die obige Matrix beschreibt, was die Gateway-Architektur unterstützt, nicht was jedes einzelne Gerätemodell garantiert unterstützt. Testen Sie stets mit Ihrer spezifischen Hardware und klären Sie Grenzfälle mit dem Cams-Support-Team, bevor Sie in den Produktivbetrieb gehen.

Worauf sich die Topologieentscheidung aus- und nicht auswirkt

Eine häufige Quelle für Verwirrung ist das Verhältnis zwischen Topologie und API-Verfügbarkeit. Die Topologiewahl, ob direkt oder indirekt, beeinflusst nicht, welche API-Funktionen verfügbar sind. Der API-Funktionsumfang wird ausschließlich durch die Kommunikationsmethode bestimmt.

Die Topologie beeinflusst jedoch, wie die Netzwerkverbindung zwischen dem Gateway und Ihrer lokalen Umgebung hergestellt wird. Die direkte Topologie erfordert eine öffentliche IP und Portweiterleitung am Standort. Die indirekte Topologie erfordert, dass der Hybrid Connector auf dem lokalen Rechner installiert ist. Die verfügbaren API-Funktionen sind für Direct Device SDK und Indirect Device SDK identisch sowie für Direct DB Pull und Indirect DB Pull.

“Wählen Sie Ihre Kommunikationsmethode anhand der API-Funktionen, die Ihre Integration benötigt. Wählen Sie Ihre Topologie anhand dessen, was Ihre Netzwerkumgebung unterstützt. Dies sind unabhängige Entscheidungen.”

Häufig gestellte Fragen

Kann ich DB Pull oder File Processing zusammen mit RESTful-API-Befehlen verwenden?
Nein. DB Pull und File Processing sind nur lesende Integrationsmethoden. Sie ermöglichen dem Gateway, die Anwesenheitsdaten zu beobachten, die von der eigenen Software des Geräts erzeugt werden, schaffen aber keinen Kanal, über den Befehle an das Gerät zurückgesendet werden können. RESTful-API-Operationen wie das Hinzufügen von Benutzern, das Löschen von Datensätzen oder das Laden von Protokollen erfordern den Device-SDK-Modus, der einen bidirektionalen Kommunikationskanal herstellt.
Muss der Hybrid Connector auf demselben Rechner wie die Gerätesoftware installiert werden?
Ja. Der Hybrid Connector muss auf demselben lokalen Computer installiert werden, an dem das Gerät angeschlossen ist oder auf dem die Geräteverwaltungssoftware läuft. Das ist erforderlich, weil er je nach Kommunikationsmethode lokalen Zugriff auf das Gerät, die lokale Datenbank oder die Anwesenheitsdatei benötigt. Der Connector baut dann einen ausgehenden Tunnel zum Gateway auf, sodass an diesem Standort keine öffentliche IP benötigt wird.
Wie unterscheidet sich die Latenz zwischen Native Push und Hybrid Push?
Bei Native Push werden Callback-API-Ereignisse ohne Latenz zugestellt, und RESTful-API-Befehle werden in etwa 30 Sekunden ausgeführt. Bei Hybrid Push mit Device SDK hängt die Latenz vom eigenen Kommunikationszyklus des SDK ab und variiert je nach Gerätehersteller. Die Latenz bei DB Pull und File Processing hängt davon ab, wie häufig die lokale Software neue Datensätze schreibt und wie schnell das Gateway die Änderung erkennt, typischerweise innerhalb weniger Sekunden nach der Erfassung des Ereignisses durch das Gerät.

Fazit: Wählen Sie Ihren Modus passend zu Ihren Rahmenbedingungen

Die Entscheidung über den Verbindungsmodus für das Cams Biometric Gateway ist keine Frage der Vorliebe, sondern der Rahmenbedingungen. Native Push ist die richtige Wahl, wenn Ihr Gerät die Voraussetzungen erfüllt, da es die meisten Funktionen mit der geringsten Konfiguration bietet. Hybrid Push ist die Lösung für alle übrigen Fälle, und innerhalb davon bietet der Device-SDK-Modus beim API-Zugriff die engste Entsprechung zu Native Push.

Wenn der vollständige SDK-Zugriff nicht verfügbar ist, sind DB Pull und File Processing praktikable Wege, die dennoch Anwesenheitsdaten in Echtzeit an Ihre Systeme liefern. Die Topologieentscheidung ist dann eine eigenständige Entscheidung auf Infrastrukturebene, die nichts daran ändert, was die API leisten kann.

Beginnen Sie mit dem Entscheidungsbaum, gleichen Sie Ihre Wahl mit der Funktionsmatrix ab, testen Sie mit Ihrer Hardware und klären Sie Grenzfälle mit dem Cams-Support-Team, bevor Sie in den Produktivbetrieb gehen.

Was this article helpful?