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