Support Hub/API & Integrations/Native Push vs. modalità Hybrid: albero decisionale tecnico
Translated from the English article and reviewed by a person. Read the English original
Developer

Native Push vs. modalità Hybrid: albero decisionale tecnico

Native Push vs. modalità Hybrid: albero decisionale tecnico

Ogni dispositivo biometrico che si connette al Cams Biometric Gateway lo fa tramite una delle due modalità push. La modalità utilizzata dal dispositivo determina quali API sono disponibili, come vengono consegnati gli eventi e come deve essere configurata la tua infrastruttura. Questa guida illustra ogni variabile della decisione, dal tipo di dispositivo al metodo di comunicazione fino alla topologia di distribuzione, così da poter scegliere il percorso corretto prima di iniziare a sviluppare.

La prima domanda: che tipo di dispositivo stai collegando?

Prima di scegliere un metodo di comunicazione o una topologia di distribuzione, c'è una domanda più fondamentale a cui rispondere: il tuo dispositivo è un dispositivo Cams Biometrics oppure un dispositivo verificato sul portale per sviluppatori di Cams?

La risposta a questa domanda determina interamente la tua modalità push. Se la risposta è sì, utilizzi Native Push e non serve alcuna ulteriore decisione. Se la risposta è no, ti trovi nell'ambito di Hybrid Push e segue una serie di ulteriori decisioni.

Modalità 1
Native Push
Per tutte le macchine Cams Biometrics e per qualsiasi dispositivo elencato come verificato su developer.camsbiometrics.com. Il dispositivo comunica direttamente con il Biometric Gateway tramite internet senza alcuna configurazione aggiuntiva.

Tutte le 38 operazioni
Callback API completa
RESTful API completa

Modalità 2
Hybrid Push
Per tutti gli altri dispositivi non verificati. Selezioni un metodo di comunicazione e una topologia di distribuzione adatti al tuo ambiente. La disponibilità delle API dipende dalla combinazione scelta.

3 metodi di comunicazione
2 opzioni di topologia
Accesso alle API variabile

Native Push: il quadro completo

I dispositivi Native Push ottengono accesso completo a tutte le 38 operazioni del Gateway senza alcuna configurazione oltre al collegamento del dispositivo a internet. La Callback API consegna gli eventi con latenza zero. I comandi della RESTful API vengono eseguiti in circa 15 secondi. Non sono necessari SDK, software locale né decisioni sulla topologia.

Comprendere Hybrid Push: tre metodi di comunicazione

Se il tuo dispositivo non è un dispositivo Cams o verificato, la decisione successiva riguarda il modo in cui il Gateway comunicherà effettivamente con il tuo hardware. Sono disponibili tre metodi di comunicazione, ciascuno con requisiti diversi e implicazioni diverse sulle funzionalità API utilizzabili.

Il metodo di comunicazione non riguarda la configurazione di rete. Riguarda il meccanismo tecnico che il Gateway utilizza per leggere i dati dal tuo dispositivo specifico e inviargli comandi. Questa scelta è vincolata da ciò che il tuo hardware supporta.

a
Device SDK
Opzione migliore per l'accesso completo alle API
Il Gateway comunica con l'hardware utilizzando l'SDK del produttore del dispositivo. L'SDK gestisce il protocollo di basso livello del dispositivo e il Gateway espone tutte le funzionalità supportate dall'SDK attraverso la sua API. Questo è l'unico metodo di comunicazione in Hybrid Push che consente le operazioni della RESTful API.
Callback API completa + RESTful API completa (entro i limiti dell'SDK)
b
DB Pull
Solo dati di presenza
Il Gateway legge da un database locale in cui il software di gestione del dispositivo scrive i record di presenza. Il Gateway monitora questo database e invia i nuovi record al tuo URL di callback in tempo reale. Non avviene alcuna comunicazione diretta con il dispositivo, il che significa che non è possibile inviare comandi al dispositivo. Operazioni come l'aggiunta di utenti, l'eliminazione di record o il caricamento dei log non sono disponibili.
Callback API: solo presenze e log di timbratura. RESTful API: non supportata.
c
File Processing
Solo dati di presenza
Un file di presenze designato sul computer locale viene monitorato in modo continuo. Ogni volta che il software del dispositivo aggiorna questo file con nuovi record di presenza, il Gateway rileva la modifica, estrae i nuovi record e li invia al tuo URL di callback in tempo reale. Come DB Pull, questo metodo è di sola lettura dal punto di vista del dispositivo e presenta le stesse limitazioni delle API.
Callback API: solo presenze e log di timbratura. RESTful API: non supportata.
Come scegliere un metodo di comunicazione

Se il tuo dispositivo dispone di un SDK del produttore supportato dal Gateway Cams, scegli Device SDK (a). È l'unico metodo che sblocca le operazioni della RESTful API per i dispositivi Hybrid Push. Se l'SDK non è supportato o non è disponibile, DB Pull (b) o File Processing (c) consegneranno comunque i dati di presenza al tuo endpoint di callback in tempo reale, il che è sufficiente per molti casi d'uso.

Comprendere Hybrid Push: due topologie di distribuzione

Una volta scelto il metodo di comunicazione, la seconda decisione riguarda il punto in cui il Gateway si collega al tuo dispositivo, database o file. Questa è la decisione sulla topologia e dipende dall'ambiente di rete nella posizione fisica del dispositivo.

Topologia X

Diretta
Il computer del sito a cui è collegato il dispositivo, o su cui è in esecuzione il software di gestione del dispositivo, dispone di un indirizzo IP pubblico con port forwarding configurato verso la rete locale. Il Biometric Gateway si collega direttamente al dispositivo, al database o ai file tramite internet.
Richiede: IP pubblico + port forwarding presso il sito
Topologia Y

Indiretta
Sul computer locale del sito è installata un'applicazione Hybrid Connector. Funge da ponte in uscita tra la macchina locale e il Biometric Gateway, stabilendo la connessione dall'interno anziché richiedere una connessione in ingresso. Dal lato del cliente non è necessario alcun IP pubblico.
Richiede: Hybrid Connector installato sul computer locale. Nessun IP pubblico necessario.
Raccomandazione sulla topologia

Se non è possibile configurare un IP pubblico o il port forwarding presso il sito, scegli la topologia Indiretta (Y) con Hybrid Connector. È il percorso di distribuzione più semplice ed evita del tutto la configurazione di rete dal lato del cliente. Se un IP pubblico è disponibile e configurato, anche la topologia Diretta (X) funziona e non richiede l'installazione di software aggiuntivo presso il sito.

L'albero decisionale: quale modalità scegliere?

Percorri questo albero decisionale dall'alto verso il basso. Fermati alla prima risposta che si applica alla tua situazione.

Albero decisionale, inizia dall'alto
1. Il tuo dispositivo è un dispositivo Cams Biometrics, oppure è elencato come verificato su developer.camsbiometrics.com?
Sì Usa Native Push. Accesso completo alle API. Non servono ulteriori decisioni.
No Passa alla domanda 2.
2. Il Gateway Cams supporta l'SDK del produttore del tuo dispositivo?
Sì Usa Hybrid Push, Device SDK (a). Accesso completo alla Callback API e alla RESTful API entro i limiti dell'SDK. Passa alla domanda 3 per la topologia.
No Passa alla domanda 2b.
2b. Il software di gestione del dispositivo scrive i record di presenza in un database locale?
Sì Usa Hybrid Push, DB Pull (b). Solo Callback per le presenze. Passa alla domanda 3 per la topologia.
3. Il computer del sito dispone di un indirizzo IP pubblico con port forwarding disponibile?
Sì Usa Topologia diretta (X). Nessun software aggiuntivo necessario presso il sito.
No Usa Topologia indiretta (Y). Installa l'Hybrid Connector sul computer locale del sito.

Matrice di disponibilità delle funzionalità Hybrid Push

La tabella seguente mostra ogni combinazione di metodo di comunicazione e topologia di distribuzione, e quali funzionalità API sono disponibili in ciascun caso. Usala insieme all'albero decisionale per confermare ciò che la configurazione scelta supporta.

Modalità Comunicazione Topologia Callback API RESTful API
Dispositivo diretto (a) Device SDK (X) IP pubblico Completa Completa (si applicano i limiti dell'SDK)
Dispositivo indiretto (a) Device SDK (Y) Hybrid Connector Completa Completa (si applicano i limiti dell'SDK)
DB diretto (b) DB Pull (X) IP pubblico Solo presenze Non supportata
DB indiretto (b) DB Pull (Y) Hybrid Connector Solo presenze Non supportata
File diretto (c) File Processing (X) IP pubblico Solo presenze Non supportata
File indiretto (c) File Processing (Y) Hybrid Connector Solo presenze Non supportata
Importante: avvertenza sull'hardware

Le limitazioni hardware possono restringere ulteriormente le funzionalità API anche all'interno della modalità Device SDK. Alcune API potrebbero non funzionare in base alla versione del firmware del modello di dispositivo o alle funzionalità esposte dall'SDK del produttore. La matrice sopra descrive ciò che l'architettura del Gateway supporta, non ciò che ogni singolo modello di dispositivo è garantito a supportare. Verifica sempre con il tuo hardware specifico e chiarisci i casi limite con il team di supporto Cams prima della messa in produzione.

Cosa influisce e cosa non influisce la decisione sulla topologia

Un punto di confusione comune riguarda il rapporto tra topologia e disponibilità delle API. La scelta della topologia, diretta o indiretta, non influisce su quali funzionalità API sono disponibili. Il set di funzionalità API è determinato interamente dal metodo di comunicazione.

La topologia influisce sul modo in cui viene stabilita la connessione di rete tra il Gateway e il tuo ambiente locale. La topologia diretta richiede un IP pubblico e il port forwarding presso il sito. La topologia indiretta richiede che l'Hybrid Connector sia installato sulla macchina locale. Le funzionalità API disponibili per te sono identiche per Device SDK diretto e Device SDK indiretto, e identiche per DB Pull diretto e DB Pull indiretto.

“Scegli il metodo di comunicazione in base alle funzionalità API di cui ha bisogno la tua integrazione. Scegli la topologia in base a ciò che supporta il tuo ambiente di rete. Si tratta di decisioni indipendenti.”

Domande frequenti

Posso usare DB Pull o File Processing insieme ai comandi della RESTful API?
No. DB Pull e File Processing sono metodi di integrazione di sola lettura. Permettono al Gateway di osservare i dati di presenza generati dal software del dispositivo, ma non stabiliscono un canale attraverso cui inviare comandi al dispositivo. Le operazioni della RESTful API, come l'aggiunta di utenti, l'eliminazione di record o il caricamento dei log, richiedono la modalità Device SDK, che crea un canale di comunicazione bidirezionale.
L'Hybrid Connector deve essere installato sulla stessa macchina del software del dispositivo?
Sì. L'Hybrid Connector deve essere installato sullo stesso computer locale a cui è collegato il dispositivo o su cui è in esecuzione il software di gestione del dispositivo. Questo perché ha bisogno di accesso locale al dispositivo, al database locale o al file di presenze, a seconda del metodo di comunicazione utilizzato. Il Connector crea quindi un tunnel in uscita verso il Gateway, eliminando la necessità di un IP pubblico in quella sede.
Qual è la differenza di latenza tra Native Push e Hybrid Push?
Per Native Push, gli eventi della Callback API vengono consegnati con latenza zero e i comandi della RESTful API vengono eseguiti in circa 30 secondi. Per Hybrid Push con Device SDK, la latenza dipende dal ciclo di comunicazione dell'SDK stesso e varia in base al produttore del dispositivo. La latenza di DB Pull e File Processing dipende dalla frequenza con cui il software locale scrive nuovi record e da quanto rapidamente il Gateway rileva la modifica, generalmente entro pochi secondi dalla registrazione dell'evento da parte del dispositivo.

Conclusione: adatta la modalità ai tuoi vincoli

La decisione sulla modalità di connessione per il Cams Biometric Gateway non è una questione di preferenza, ma di vincoli. Native Push è la risposta giusta se il tuo dispositivo è idoneo, perché offre il massimo delle funzionalità con la minima configurazione. Hybrid Push è la risposta per tutti gli altri casi e, al suo interno, la modalità Device SDK offre l'equivalente più vicino a Native Push in termini di accesso alle API.

Quando l'accesso completo all'SDK non è disponibile, DB Pull e File Processing sono percorsi pragmatici che consegnano comunque dati di presenza in tempo reale ai tuoi sistemi. La decisione sulla topologia è quindi una scelta separata, a livello infrastrutturale, che non modifica ciò che l'API può fare.

Inizia con l'albero decisionale, verifica la scelta con la matrice delle funzionalità, testa con il tuo hardware e chiarisci eventuali casi limite con il team di supporto Cams prima di andare in produzione.

Was this article helpful?