Quali dispositivi supporta la Gateway, come si connette ciascuno (Native Push o Hybrid Push) e quali operazioni API sono disponibili in ciascuna modalità.
Introduzione
Compatibilità dei dispositivi
La Cams Biometric Gateway supporta tutti i dispositivi biometrici di rilevazione presenze e controllo accessi. L’unica scelta che devi fare è la modalità di connessione adatta alla tua installazione.
Native Push
Dispositivi Cams
Tutti i dispositivi su camsbiometrics.com/product. API completa — tutte le 38 operazioni, nessuna configurazione richiesta.
Qualsiasi altro dispositivo funziona tramite Hybrid Push. Tu scegli la modalità di connessione più adatta alla tua installazione — le funzionalità API dipendono dalla modalità selezionata.
Marche di dispositivi supportate
Cams BiometricsZKTecoSupremaHikvisionAnvizMorpho / IDEMIAVirdiMantraNitgenRealtime / StartekBiomaxSecugeneSSLMatrix COSEC+ Qualsiasi altra marca
Modalità di autenticazione supportate
Impronta digitaleRiconoscimento faccialeVene del palmoBadge RFIDPIN / PasswordQR / Codice a barreTracciamento GPS
Ogni dispositivo biometrico si collega alla Cams Biometric Gateway tramite una delle due modalità push. Il tipo di dispositivo determina quale modalità usare.
Native Push Dispositivi Cams & verificati
Tutti i dispositivi Cams Biometrics e i dispositivi verificati su developer.camsbiometrics.com si collegano tramite Native Push. Nessuna configurazione aggiuntiva — il dispositivo comunica direttamente con la Biometric Gateway via Internet.
Supporto API completo. Tutte le 38 operazioni funzionano senza limitazioni — sia API di callback sia RESTful. Latenza zero per i callback, ~15 secondi per i comandi RESTful.
Hybrid Push Tutti gli altri dispositivi
Per i dispositivi non Cams e non verificati, scegli una modalità di connessione Hybrid Push adatta al tuo ambiente. La combinazione tra metodo di comunicazione e topologia di distribuzione determina quali funzionalità API sono disponibili.
Metodi di comunicazione
(a) SDK del dispositivoLa Gateway comunica con l’hardware tramite l’SDK del produttore. Tutte le funzionalità supportate dall’SDK sono disponibili tramite l’API. L’opzione migliore per l’accesso completo all’API.
(b) Lettura del databaseLa Gateway legge da un database locale installato sul computer del sito (dove il software del dispositivo salva le presenze). È supportato solo l’invio al tuo server dei log di presenza/timbratura. Nessuna API RESTful (niente aggiunta/eliminazione utenti, niente caricamento log, ecc.).
(c) Elaborazione di fileUn file di presenze designato sul computer locale viene posto sotto sorveglianza continua. Ogni volta che il file viene aggiornato dal software del dispositivo, i nuovi record di presenza vengono rilevati, prelevati e inviati automaticamente al tuo URL di callback in tempo reale. Stesse limitazioni API della lettura del database -- solo invio delle presenze, nessuna API RESTful.
Topologie di distribuzione
(X) DirettaIl computer del sito ha un IP pubblico con port forwarding verso la rete locale. La Biometric Gateway si collega direttamente a dispositivo/database/file via Internet.
(Y) IndirettaSul computer locale è installato un Hybrid Connector. Fa da ponte tra la macchina/database/file locale e la Biometric Gateway — nessun IP pubblico richiesto lato cliente.
Hybrid Push — Matrice di disponibilità delle funzionalità
Modalità
Comunicazione
Topologia
API di callback
API RESTful
Dispositivo diretto
(a) SDK
(X) IP pubblico
Completo
Completo (limiti dell’SDK)
Dispositivo indiretto
(a) SDK
(Y) Hybrid Connector
Completo
Completo (limiti dell’SDK)
Database diretto
(b) Lettura del database
(X) IP pubblico
Solo presenze
Non supportato
Database indiretto
(b) Lettura del database
(Y) Hybrid Connector
Solo presenze
Non supportato
File diretto
(c) File
(X) IP pubblico
Solo presenze
Non supportato
File indiretto
(c) File
(Y) Hybrid Connector
Solo presenze
Non supportato
Quale modalità scegliere? Se il tuo dispositivo non Cams dispone di un SDK supportato dalla Gateway, scegli la modalità SDK del dispositivo (a) per l’accesso completo all’API. In caso contrario, la lettura del database (b) o l’elaborazione di file (c) consentono comunque di far arrivare i dati di presenza. Per la topologia, scegli Indiretta (Y) con l’Hybrid Connector se non puoi configurare un IP pubblico — è la più semplice da distribuire.
I limiti hardware possono restringere ulteriormente le funzionalità API. Anche in modalità SDK del dispositivo, alcune API potrebbero non funzionare a seconda del firmware o delle capacità dell’SDK del modello. Testa sempre con il tuo hardware e verifica con il team di supporto Cams.