Welche Geräte das Gateway unterstützt, wie sich jedes Gerät verbindet (Native Push oder Hybrid Push) und welche API-Operationen in welchem Modus verfügbar sind.
Einführung
Gerätekompatibilität
Das Cams Biometric Gateway unterstützt alle biometrischen Zeiterfassungs- und Zutrittskontrollgeräte. Die einzige Entscheidung, die Sie treffen müssen, ist, welcher Verbindungsmodus zu Ihrer Umgebung passt.
Native Push
Cams-Geräte
Alle Geräte unter camsbiometrics.com/product. Voller API-Umfang — alle 38 Operationen, ohne Einrichtung.
Jedes andere Gerät funktioniert über Hybrid Push. Sie wählen den Verbindungsmodus, der zu Ihrer Umgebung passt — die verfügbaren API-Funktionen hängen vom gewählten Modus ab.
Unterstützte Gerätemarken
Cams BiometricsZKTecoSupremaHikvisionAnvizMorpho / IDEMIAVirdiMantraNitgenRealtime / StartekBiomaxSecugeneSSLMatrix COSEC+ Jede andere Marke
Jedes biometrische Gerät verbindet sich über einen von zwei Push-Modi mit dem Cams Biometric Gateway. Ihr Gerätetyp bestimmt, welcher Modus zu verwenden ist.
Native Push Cams- & verifizierte Geräte
Alle Geräte von Cams Biometrics sowie die unter developer.camsbiometrics.com verifizierten Geräte verbinden sich über Native Push. Keine zusätzliche Einrichtung nötig — das Gerät kommuniziert über das Internet direkt mit dem Biometric Gateway.
Voller API-Umfang. Alle 38 Operationen funktionieren ohne Einschränkungen — sowohl Callback- als auch RESTful-APIs. Keine Latenz bei Callbacks, ca. 15 Sekunden bei RESTful-Befehlen.
Hybrid Push Alle anderen Geräte
Für Geräte, die nicht von Cams stammen und nicht verifiziert sind, wählen Sie einen Hybrid-Push-Verbindungsmodus, der zu Ihrer Umgebung passt. Die Kombination aus Kommunikationsmethode und Bereitstellungstopologie bestimmt, welche API-Funktionen verfügbar sind.
Kommunikationsmethoden
(a) Geräte-SDKDas Gateway kommuniziert über das SDK des Geräteherstellers mit der Hardware. Alle vom SDK unterstützten Funktionen sind über die API verfügbar. Die beste Option für vollen API-Zugriff.
(b) DB PullDas Gateway liest aus einer lokalen Datenbank, die auf dem Computer vor Ort installiert ist (dort, wo die Gerätesoftware die Anwesenheitsdaten speichert). Unterstützt wird nur das Senden von Anwesenheits-/Buchungsprotokollen an Ihren Server. Keine RESTful-APIs (kein Hinzufügen/Löschen von Benutzern, kein Laden von Logs usw.).
(c) DateiverarbeitungEine festgelegte Anwesenheitsdatei auf dem lokalen Computer wird dauerhaft überwacht. Sobald die Gerätesoftware die Datei aktualisiert, werden neue Anwesenheitsdatensätze automatisch erkannt, abgerufen und in Echtzeit an Ihre Callback-URL gesendet. Dieselben API-Einschränkungen wie bei DB Pull -- nur Anwesenheits-Push, keine RESTful-APIs.
Bereitstellungstopologien
(X) DirektDer Computer vor Ort hat eine öffentliche IP mit Portweiterleitung ins lokale Netzwerk. Das Biometric Gateway verbindet sich über das Internet direkt mit Gerät, Datenbank oder Dateien.
(Y) IndirektAuf dem lokalen Computer ist ein Hybrid Connector installiert. Er fungiert als Brücke zwischen lokalem Gerät/lokaler Datenbank/lokalen Dateien und dem Biometric Gateway — auf Kundenseite ist keine öffentliche IP erforderlich.
Hybrid Push — Matrix der Funktionsverfügbarkeit
Modus
Kommunikation
Topologie
Callback-API
RESTful-API
Direktes Gerät
(a) SDK
(X) Öffentliche IP
Voll
Voll (SDK-Grenzen)
Indirektes Gerät
(a) SDK
(Y) Hybrid Connector
Voll
Voll (SDK-Grenzen)
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) Datei
(X) Öffentliche IP
Nur Anwesenheit
Nicht unterstützt
Indirekte Datei
(c) Datei
(Y) Hybrid Connector
Nur Anwesenheit
Nicht unterstützt
Welchen Modus sollte ich wählen? Wenn Ihr Gerät nicht von Cams stammt, aber ein vom Gateway unterstütztes SDK besitzt, wählen Sie den Modus Geräte-SDK (a) für vollen API-Zugriff. Andernfalls sorgen DB Pull (b) oder Dateiverarbeitung (c) trotzdem dafür, dass Anwesenheitsdaten fließen. Wählen Sie bei der Topologie Indirekt (Y) mit Hybrid Connector, wenn Sie keine öffentliche IP einrichten können — das ist die am einfachsten zu implementierende Variante.
Hardware-Einschränkungen können den API-Umfang zusätzlich begrenzen. Selbst im Modus Geräte-SDK funktionieren bestimmte APIs je nach Firmware oder SDK-Funktionsumfang des Gerätemodells möglicherweise nicht. Testen Sie immer mit Ihrer Hardware und klären Sie dies mit dem Cams-Support-Team.
