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.
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.
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.
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.
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.
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
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.