Welke apparaten de Gateway ondersteunt, hoe elk apparaat verbinding maakt (Native Push of Hybrid Push) en welke API-bewerkingen in elke modus beschikbaar zijn.
Introductie
Apparaatcompatibiliteit
De Cams Biometric Gateway ondersteunt alle biometrische aanwezigheids- en toegangscontroleapparaten. De enige keuze die u maakt, is welke verbindingsmodus bij uw situatie past.
Native Push
Cams-apparaten
Alle apparaten op camsbiometrics.com/product. Volledige API — alle 38 bewerkingen, geen installatie nodig.
Elk ander apparaat werkt via Hybrid Push. U kiest de verbindingsmodus die bij uw situatie past — de beschikbare API-functies hangen af van de gekozen modus.
Ondersteunde apparaatmerken
Cams BiometricsZKTecoSupremaHikvisionAnvizMorpho / IDEMIAVirdiMantraNitgenRealtime / StartekBiomaxSecugeneSSLMatrix COSEC+ Elk ander merk
Elk biometrisch apparaat maakt via een van twee pushmodi verbinding met de Cams Biometric Gateway. Uw apparaattype bepaalt welke modus u gebruikt.
Native Push Cams- & geverifieerde apparaten
Alle apparaten van Cams Biometrics en alle apparaten die zijn geverifieerd op developer.camsbiometrics.com maken verbinding via Native Push. Geen extra installatie nodig — het apparaat communiceert via internet rechtstreeks met de Biometric Gateway.
Volledige API-ondersteuning. Alle 38 bewerkingen werken zonder beperkingen — zowel Callback- als RESTful API's. Geen vertraging bij callbacks, ~15 seconden voor RESTful-opdrachten.
Hybrid Push Alle andere apparaten
Voor apparaten die niet van Cams zijn en niet geverifieerd zijn, kiest u een Hybrid Push-verbindingsmodus die bij uw omgeving past. De combinatie van communicatiemethode en implementatietopologie bepaalt welke API-functies beschikbaar zijn.
Communicatiemethoden
(a) Apparaat-SDKDe Gateway communiceert met de hardware via de SDK van de apparaatfabrikant. Alle functies die de SDK ondersteunt, zijn beschikbaar via de API. De beste optie voor volledige API-toegang.
(b) DB PullDe Gateway leest uit een lokale database op de computer ter plaatse (waar de apparaatsoftware de aanwezigheid opslaat). Alleen het pushen van aanwezigheids-/registratielogs naar uw server wordt ondersteund. Geen RESTful API's (geen gebruikers toevoegen/verwijderen, geen logs laden, enz.).
(c) BestandsverwerkingEen aangewezen aanwezigheidsbestand op de lokale computer wordt continu bewaakt. Telkens wanneer de apparaatsoftware het bestand bijwerkt, worden nieuwe aanwezigheidsrecords automatisch gedetecteerd, opgehaald en realtime naar uw Callback-URL gepusht. Dezelfde API-beperkingen als bij DB Pull -- alleen aanwezigheidspush, geen RESTful API's.
Implementatietopologieën
(X) DirectDe computer ter plaatse heeft een openbaar IP-adres met portforwarding naar het lokale netwerk. De Biometric Gateway maakt via internet rechtstreeks verbinding met het apparaat, de database of de bestanden.
(Y) IndirectOp de lokale computer is een Hybrid Connector geïnstalleerd. Deze fungeert als brug tussen het lokale apparaat/de database/de bestanden en de Biometric Gateway — aan de klantzijde is geen openbaar IP-adres nodig.
Hybrid Push — matrix van functiebeschikbaarheid
Modus
Communicatie
Topologie
Callback-API
RESTful API
Direct apparaat
(a) SDK
(X) Openbaar IP
Volledig
Volledig (SDK-beperkingen)
Indirect apparaat
(a) SDK
(Y) Hybrid Connector
Volledig
Volledig (SDK-beperkingen)
Directe DB
(b) DB Pull
(X) Openbaar IP
Alleen aanwezigheid
Niet ondersteund
Indirecte DB
(b) DB Pull
(Y) Hybrid Connector
Alleen aanwezigheid
Niet ondersteund
Direct bestand
(c) Bestand
(X) Openbaar IP
Alleen aanwezigheid
Niet ondersteund
Indirect bestand
(c) Bestand
(Y) Hybrid Connector
Alleen aanwezigheid
Niet ondersteund
Welke modus moet ik kiezen? Als uw apparaat niet van Cams is maar een SDK heeft die de Gateway ondersteunt, kies dan de modus Apparaat-SDK (a) voor volledige API-toegang. Zo niet, dan zorgen DB Pull (b) of Bestandsverwerking (c) er toch voor dat aanwezigheidsgegevens binnenkomen. Kies voor de topologie Indirect (Y) met Hybrid Connector als u geen openbaar IP-adres kunt instellen — dit is het eenvoudigst te implementeren.
Hardwarebeperkingen kunnen de API-functies verder inperken. Zelfs in de modus Apparaat-SDK kunnen bepaalde API's niet werken, afhankelijk van de firmware of SDK-mogelijkheden van het apparaatmodel. Test altijd met uw hardware en stem af met het Cams-supportteam.
