Support Hub/API & Integrations/Distribuzione dei dispositivi biometrici: Native Push vs.…
Translated from the English article and reviewed by a person. Read the English original
Developer

Distribuzione dei dispositivi biometrici: Native Push vs. Hybrid Push

Distribuzione dei dispositivi biometrici: Native Push vs. Hybrid Push

Panoramica: Comprendere le sfide di connettività dei dispositivi biometrici

I sistemi biometrici di rilevazione presenze e i dispositivi di controllo accessi operano in ambienti diversi, con infrastrutture di rete, capacità di connettività e requisiti di sicurezza differenti. Le organizzazioni affrontano una sfida critica: come integrare i dispositivi biometrici, siano essi lettori di impronte digitali, terminali di riconoscimento facciale, lettori di iride o lettori di vene palmari, nei loro sistemi HRMS (Human Resource Management Systems), nelle piattaforme ERP (Enterprise Resource Planning) o nei software di gestione delle presenze già in uso, quando questi dispositivi provengono da produttori diversi con protocolli di comunicazione incompatibili.

Il Biometric Gateway affronta questa sfida fondamentale di integrazione attraverso un'architettura di distribuzione adattiva. Questa architettura seleziona automaticamente il metodo di comunicazione ottimale in base alle capacità del dispositivo, alla topologia di rete e ai vincoli infrastrutturali, garantendo che ogni dispositivo biometrico, indipendentemente da produttore, modello, età o capacità di connettività, possa integrarsi con qualsiasi sistema di gestione delle presenze o piattaforma di gestione del personale.

La sfida della compatibilità dei dispositivi: perché il supporto universale è importante

Frammentazione dei produttori nell'hardware biometrico

Il mercato globale dei dispositivi biometrici comprende centinaia di produttori che realizzano migliaia di modelli di dispositivi:

  • Dispositivi ZKTeco: inclusi F18, K40, controller di accesso InBio, serie SpeedFace
  • Suprema BioStar: terminali di riconoscimento facciale BioEntry, BioLite, FaceStation
  • Terminali biometrici Anviz: dispositivi per volto e impronte FacePass, CrossChex, VF30 Pro
  • eSSL (Matrix Comsec): lettori multi-biometrici X990, K21 Pro, MB360
  • Realtime (Startek): macchine per presenze con impronte digitali e RFID T502, T9, T52
  • Virdi: sistemi di controllo accessi e rilevazione presenze AC-2100, AC-5000
  • Nitgen: scanner di impronte digitali eNBioAccess, Fingkey Hamster
  • Morpho (IDEMIA): dispositivi di autenticazione tramite impronte digitali MSO 1300, serie Sigma
  • Mantra: sensori di impronte MFS100, MFS110 e tablet MADT50
  • Secugen: lettori di impronte Hamster Plus, OptiMouse
  • Hikvision: terminali di riconoscimento facciale della serie DS-K1T
  • Time Watch: terminali di presenza SG-100, SG-300
  • Biomax: dispositivi per vene palmari e impronte N-BM180, Bio5000

Ogni produttore sviluppa protocolli di comunicazione, formati dei dati e metodi di integrazione proprietari. Gli approcci di integrazione tradizionali richiedono sforzi di sviluppo separati per ogni produttore di dispositivi, creando un vincolo di fornitore (vendor lock-in) e limitando la libertà di scelta del cliente nella selezione dell'hardware.

Variazioni dell'infrastruttura di rete

Le organizzazioni distribuiscono i sistemi biometrici su architetture di rete sostanzialmente diverse:

  • Ambienti connessi al cloud: i dispositivi hanno accesso diretto a internet tramite WiFi, Ethernet o connettività cellulare
  • Reti air-gapped: stabilimenti produttivi, installazioni della difesa o uffici governativi sicuri in cui i dispositivi biometrici operano su reti isolate senza accesso a internet
  • Distribuzioni DMZ (Demilitarized Zone): architetture di sicurezza aziendali in cui i dispositivi di controllo accessi biometrici si trovano in segmenti di rete separati sia dalle reti interne sia da internet pubblico
  • Solo accesso VPN: sedi remote, filiali o punti vendita in cui i dispositivi si connettono tramite reti private virtuali (VPN)
  • Reti con proxy: ambienti aziendali in cui tutte le connessioni in uscita devono passare attraverso server proxy con autenticazione
  • Ambienti protetti da firewall: organizzazioni con politiche firewall restrittive che bloccano le connessioni in ingresso o limitano il traffico in uscita a porte e protocolli specifici

Le soluzioni tradizionali di integrazione biometrica presuppongono configurazioni di rete specifiche, costringendo le organizzazioni a modificare la propria infrastruttura per soddisfare i requisiti di connettività dei dispositivi. Ciò comporta rischi per la sicurezza, violazioni di conformità e ritardi nell'implementazione.

Verifica della compatibilità dei dispositivi: il primo passo

Dispositivi nativi Cams Biometrics

Tutti i dispositivi biometrici prodotti da Cams Biometrics includono di serie la funzionalità di native push. Questi dispositivi, inclusi terminali di rilevazione presenze con impronte digitali, sistemi di riconoscimento facciale e lettori biometrici multimodali, vengono forniti con connettività cloud preconfigurata e supportano la Biometric Web API completa senza richiedere l'installazione di software aggiuntivo o aggiornamenti di protocollo.

Le funzionalità native includono:

  • Invio in tempo reale delle transazioni tramite webhook HTTPS
  • Comunicazione REST API bidirezionale per la gestione dei dispositivi
  • Accodamento automatico offline dei dati e sincronizzazione
  • Registrazione remota degli utenti con trasferimento dei template biometrici
  • Configurazione dei dispositivi e aggiornamenti firmware basati sul cloud

Processo di verifica dei dispositivi di terze parti

Per i dispositivi biometrici di altri produttori (hardware non Cams), la verifica di compatibilità avviene tramite la piattaforma developer.camsbiometrics.com. Questo portale di verifica testa la compatibilità di comunicazione con i dispositivi dei produttori ufficialmente partner.

Il processo di verifica:

  1. Registrazione del dispositivo: inserire il numero di modello, il numero di serie e i dati del produttore del dispositivo
  2. Test del protocollo: test automatizzati verificano la capacità del dispositivo di comunicare utilizzando protocolli standardizzati di scambio dei dati biometrici
  3. Convalida della comunicazione: il sistema conferma che il dispositivo è in grado di inviare transazioni di presenza, accettare dati di registrazione degli utenti e rispondere ai comandi di configurazione secondo gli accordi di protocollo reciproci
  4. Determinazione della compatibilità: in base ai risultati dei test, il sistema stabilisce se il dispositivo è idoneo alla distribuzione Native Push o se richiede una distribuzione Hybrid

Esiti della verifica:

  • Verifica riuscita: il dispositivo dimostra piena conformità al protocollo → distribuzione Native Push abilitata
  • Verifica fallita o problemi rilevati: il dispositivo non soddisfa i requisiti del protocollo, ha un firmware incompatibile o presenta errori di comunicazione → distribuzione Hybrid consigliata

Questa verifica garantisce che la scelta della modalità di distribuzione si basi sulla capacità tecnica effettivamente testata e non su ipotesi riguardanti le specifiche del dispositivo o le dichiarazioni del produttore.

Perché alcuni dispositivi richiedono la distribuzione Hybrid

I dispositivi non superano la verifica di compatibilità per diversi motivi tecnici:

  • Protocolli proprietari: il dispositivo utilizza metodi di comunicazione specifici del produttore incompatibili con i protocolli push standardizzati
  • Limitazioni del firmware: le versioni firmware meno recenti non dispongono di funzionalità di connettività cloud o supporto ai webhook
  • Vincoli hardware: il processore o la memoria del dispositivo sono insufficienti per mantenere connessioni cloud persistenti
  • Problemi di convalida dei certificati: l'implementazione SSL/TLS del dispositivo non è compatibile con i moderni requisiti dei certificati
  • Incompatibilità dei formati dei dati: il dispositivo trasmette i dati di presenza in formati non standard che richiedono una conversione
  • Limitazioni di connettività: lo stack di rete del dispositivo non supporta i protocolli richiesti (HTTP/2, WebSocket, ecc.)

Quando i dispositivi non possono superare la verifica, Hybrid Push Service fornisce percorsi di comunicazione alternativi che funzionano entro le capacità e i limiti effettivi del dispositivo.

Opzione di distribuzione 1: Native Push (Web API completa)

Che cos'è la distribuzione Native Push?

Native Push è il metodo di integrazione cloud diretta in cui i dispositivi biometrici comunicano direttamente con la piattaforma cloud del Biometric Gateway utilizzando la Biometric Web API. Questo metodo di distribuzione offre l'insieme completo di funzionalità con le massime prestazioni e la minima latenza.

Native Push significa che il dispositivo stesso:

  • Stabilisce connessioni HTTPS direttamente con gli endpoint API del cloud
  • Invia le transazioni di presenza immediatamente al momento in cui si verificano
  • Riceve comandi REST API per la gestione degli utenti e la configurazione del dispositivo
  • Mantiene una comunicazione bidirezionale per il controllo in tempo reale
  • Gestisce autonomamente l'accodamento dei dati offline e la sincronizzazione automatica

Architettura tecnica di Native Push

Flusso di comunicazione:

Dispositivo biometrico (terminale impronte/volto) 
    ↓ [HTTPS/TLS 1.2+]
    ↓ [Richieste POST webhook in tempo reale]
    ↓
Cloud API Gateway (api.camsbiometrics.com)
    ↓ [Invio webhook all'endpoint del partner]
    ↓
Applicazione partner (HRMS/ERP/sistema di presenze)

Dettagli del protocollo:

  • Trasporto: HTTPS su TCP/IP con crittografia TLS 1.2 o superiore
  • Autenticazione: autenticazione basata su chiave API con firma delle richieste
  • Formato dei dati: payload JSON per i dati delle transazioni e le richieste API
  • Consegna webhook: richieste POST agli URL di callback configurati dal partner
  • Metodi API: interfaccia HTTP RESTful per le operazioni sui dispositivi

Funzionalità di Native Push: insieme completo

Consegna delle transazioni di presenza in tempo reale

Quando il dispositivo è online (connesso a internet):

  • Si verifica un evento di presenza (scansione dell'impronta, riconoscimento facciale, passaggio della tessera RFID)
  • Il dispositivo genera un record di transazione con timestamp, ID utente e punteggio di corrispondenza biometrica
  • Il dispositivo invia immediatamente una richiesta HTTPS POST alla cloud API (latenza < 1 secondo)
  • La cloud API convalida la transazione, elabora i dati e attiva il webhook verso l'applicazione partner
  • L'applicazione partner riceve il record di presenza in tempo reale per l'elaborazione immediata

Quando il dispositivo è offline (nessuna connessione internet):

  • Il dispositivo memorizza le transazioni di presenza nella memoria locale (la capacità di memorizzazione interna varia in base al modello, in genere 50.000-100.000 record)
  • Il dispositivo continua a funzionare normalmente, registrando le presenze biometriche senza interruzioni
  • Quando la connessione internet viene ripristinata (riconnessione WiFi, ricollegamento del cavo Ethernet, ritorno del segnale cellulare)
  • Il dispositivo rileva automaticamente il ripristino della connettività
  • Il dispositivo accoda tutte le transazioni offline memorizzate e le invia alla cloud API in ordine cronologico
  • Nessun intervento manuale richiesto, nessuna perdita di dati, sincronizzazione automatica completa

Comunicazione REST API bidirezionale

La distribuzione Native Push fornisce accesso REST API completo per la gestione programmatica dei dispositivi. Sulla base della documentazione della Biometric Web API, sono disponibili le seguenti operazioni:

Operazioni di consegna dei dati in tempo reale:

  • Webhook delle transazioni di presenza: invio automatico degli eventi di verifica biometrica (entrata, uscita, inizio pausa, fine pausa) con identificazione del dipendente, timestamp, metodo di verifica, posizione del dispositivo e punteggio di qualità della corrispondenza
  • Notifiche di eventi: avvisi in tempo reale per eventi del dispositivo, inclusi rilevamento di manomissioni, avvisi di batteria scarica, allarmi di porta forzata, tentativi di accesso non validi ed errori di sistema
  • Aggiornamenti di stato: monitoraggio continuo dello stato del dispositivo, inclusi cambiamenti di stato online/offline, utilizzo della memoria, stato della connettività di rete e avvisi operativi

Operazioni di registrazione e gestione degli utenti:

  • Aggiunta di nuovi utenti ai dispositivi: registrazione dei dipendenti con informazioni anagrafiche, inclusi ID dipendente, nome completo, assegnazione al reparto, classificazione del ruolo e permessi di accesso
  • Registrazione remota dei template biometrici: caricamento di impronte digitali, dati di riconoscimento facciale, scansioni dell'iride o template di vene palmari dalle postazioni di registrazione centralizzate verso i dispositivi distribuiti
  • Recupero delle banche dati utenti: interrogazione degli elenchi completi dei dipendenti dai dispositivi, inclusi stato di registrazione, livelli di accesso assegnati, stati attivo/inattivo e ultimi timestamp di verifica
  • Aggiornamento delle informazioni utente: modifica dei dati dei dipendenti, cambio di assegnazione al reparto, adeguamento dei permessi di accesso, aggiornamento dei periodi di validità e revisione dei requisiti di autenticazione
  • Eliminazione delle registrazioni utente: rimozione dei dipendenti dai dispositivi, eliminazione dei template biometrici, revoca dei permessi di accesso e cancellazione dei record di autenticazione
  • Operazioni massive sugli utenti: caricamento simultaneo di più record dipendenti, aggiornamento in blocco dei permessi di accesso su flotte di dispositivi, eliminazione in batch dei dipendenti cessati e sincronizzazione delle banche dati utenti tra le sedi
  • Configurazione dei livelli di accesso: definizione di regole di accesso basate sull'orario, impostazione delle modalità di autenticazione (solo impronta, volto+impronta, tessera+verifica biometrica), configurazione delle soglie di verifica e definizione dei permessi di override

Operazioni di configurazione e controllo dei dispositivi:

  • Interrogazione dello stato del dispositivo: recupero di informazioni in tempo reale, inclusi versione del firmware, numero di serie, identificazione del modello, capacità di memoria, numero di utenti attuali, utilizzo dello storage dei template, configurazione di rete e timestamp dell'ultima comunicazione
  • Configurazione dei parametri operativi: regolazione delle soglie di sensibilità della verifica, impostazione dei tempi di timeout dell'autenticazione, configurazione dei requisiti di autenticazione multifattore, definizione delle politiche di blocco dopo tentativi falliti e definizione dei parametri di sicurezza
  • Gestione delle regole di presenza: impostazione dei turni di lavoro, definizione degli orari dei turni, configurazione del calcolo degli straordinari, definizione delle regole per le pause e specifica dei calendari festivi
  • Controllo dei permessi di accesso: definizione della durata di sblocco delle porte, impostazione dei tempi di ri-chiusura, configurazione delle regole anti-passback, definizione di zone di accesso temporali (permessi basati sul tempo) e gestione dei protocolli di accesso per i visitatori
  • Pianificazione di azioni automatizzate: configurazione dei programmi di campanelle/allarmi per i cambi turno, impostazione dei tempi degli annunci vocali, definizione dei programmi automatici di blocco/sblocco delle porte e impostazione della reportistica periodica di stato
  • Personalizzazione delle impostazioni di visualizzazione: regolazione della luminosità dello schermo, impostazione dei timeout, configurazione delle preferenze linguistiche, caricamento di loghi personalizzati e definizione dei messaggi di benvenuto
  • Gestione delle impostazioni di comunicazione: configurazione dei parametri di rete (indirizzo IP, subnet mask, gateway, server DNS), impostazione delle credenziali WiFi, regolazione delle modalità di connettività e definizione dei protocolli di failover

Operazioni di recupero dei dati di presenza:

  • Interrogazione dei record storici: recupero delle transazioni di presenza per intervallo di date, filtro per ID dipendente, ricerca per reparto, interrogazione di dispositivi specifici ed estrazione dei record per tipo di verifica
  • Download dei log delle transazioni: esportazione dei record completi di timbratura con timestamp, identificativi dei dipendenti, stato di entrata/uscita, modalità di verifica, posizioni dei dispositivi e punteggi di corrispondenza
  • Accesso alle tracce di audit: revisione degli eventi di sistema, monitoraggio delle modifiche di configurazione, controllo delle attività di registrazione degli utenti ed esame delle decisioni di controllo accessi
  • Generazione di riepiloghi delle presenze: calcolo delle ore lavorate, aggregazione delle presenze per reparto, calcolo degli straordinari, monitoraggio dei ritardi e identificazione delle uscite anticipate

Operazioni di amministrazione del sistema:

  • Gestione del firmware: verifica delle versioni correnti, avvio di aggiornamenti remoti, pianificazione delle finestre di manutenzione e verifica del completamento degli aggiornamenti
  • Operazioni diagnostiche: recupero dei log di sistema, accesso ai messaggi di errore, revisione dello storico della connettività di rete, esame dei fallimenti di autenticazione e analisi delle metriche di prestazione
  • Backup e ripristino: esportazione delle configurazioni dei dispositivi, salvataggio delle banche dati utenti, backup delle impostazioni di sistema e ripristino da stati precedenti
  • Coordinamento multi-dispositivo: sincronizzazione dell'orario tra le flotte di dispositivi, distribuzione delle configurazioni ai gruppi di dispositivi, coordinamento degli aggiornamenti delle banche dati utenti e gestione delle politiche di accesso centralizzate

Flusso completo di registrazione biometrica

Registrazione remota (dal cloud al dispositivo):

  1. L'applicazione partner acquisisce i dati biometrici (scansione dell'impronta, foto del volto) in qualsiasi luogo (ufficio HR, postazione di registrazione remota, app mobile)
  2. L'applicazione carica il template biometrico sulla cloud API insieme all'identificativo del dipendente e alle metriche di qualità del template
  3. La cloud API convalida la qualità del template e verifica la presenza di registrazioni duplicate in tutta la banca dati per prevenire conflitti di identità
  4. La cloud API invia il template convalidato al/i dispositivo/i biometrico/i di destinazione in base alle sedi assegnate al dipendente
  5. Il dispositivo riceve il template, lo memorizza nella memoria locale, lo indicizza per una verifica rapida e rende l'utente immediatamente verificabile
  6. Il dipendente può autenticarsi al dispositivo senza una presenza fisica preventiva, consentendo l'abilitazione all'accesso il giorno stesso

Registrazione locale (direttamente sul dispositivo):

  1. L'amministratore aggiunge l'utente al dispositivo tramite l'interfaccia locale (tastierino, touchscreen o terminale di registrazione collegato)
  2. L'utente scansiona l'impronta più volte (in genere 3 acquisizioni) oppure registra il volto direttamente sul terminale biometrico
  3. Il dispositivo acquisisce il template biometrico, esegue una valutazione della qualità e verifica l'unicità del template
  4. Il dispositivo memorizza il template nella memoria locale non volatile e invia immediatamente i dati di registrazione dell'utente al cloud
  5. La cloud API sincronizza la registrazione dell'utente su più dispositivi, se configurato (distribuzione automatica dei template)
  6. L'applicazione partner riceve la notifica di registrazione dell'utente tramite webhook, comprensiva di ID dipendente, timestamp di registrazione, posizione del dispositivo e punteggio di qualità del template

Controllo e configurazione dei dispositivi

Operazioni remote:

  • Aggiornamenti firmware: invio del firmware aggiornato dal cloud ai dispositivi durante le finestre di manutenzione programmate, verifica della compatibilità delle versioni, monitoraggio dell'avanzamento dell'aggiornamento e conferma dell'installazione riuscita
  • Regole di controllo accessi: aggiornamento delle fasce orarie consentite per i gruppi di dipendenti, impostazione di restrizioni specifiche per reparto, configurazione delle politiche di accesso nei giorni festivi e definizione delle procedure di autenticazione per i visitatori
  • Programmi di campanelle/allarmi: configurazione dei segnali di cambio turno per gli ambienti produttivi, impostazione degli allarmi per le pause, definizione dei programmi delle campanelle scolastiche e personalizzazione degli annunci audio
  • Annunci vocali: selezione delle preferenze linguistiche, caricamento di messaggi audio personalizzati, configurazione degli eventi che attivano gli annunci (autenticazione riuscita, accesso negato, avvisi di sistema) e regolazione dei livelli del volume
  • Personalizzazione del display: impostazione della luminosità dello schermo in base all'ora del giorno, configurazione dei timeout per il risparmio energetico, regolazione dei formati di lingua e data, caricamento dei loghi aziendali e definizione dei messaggi di benvenuto
  • Modalità di verifica: passaggio tra verifica 1:1 (tessera + biometria) e identificazione 1:N (solo biometria), regolazione delle soglie di corrispondenza per bilanciare sicurezza e comodità, attivazione dell'autenticazione multifattore e configurazione dei metodi di verifica di backup

Gestione multi-dispositivo:

  • Controllo centralizzato della flotta: gestione di centinaia o migliaia di dispositivi da un'unica interfaccia API, senza accesso individuale ai singoli dispositivi
  • Registrazione massiva degli utenti: aggiunta di un nuovo dipendente in tutte le sedi pertinenti contemporaneamente, garantendo l'accesso immediato in tutta la struttura o nell'intera organizzazione
  • Configurazione sincronizzata: invio di impostazioni identiche ai gruppi di dispositivi (tutti i terminali della reception, tutti i dispositivi dell'area produttiva, tutti i punti di accesso dei dirigenti) mantenendo la coerenza
  • Diagnostica remota: risoluzione dei problemi di connettività, revisione dei log degli errori, verifica dell'utilizzo della memoria e identificazione dei dispositivi malfunzionanti senza necessità di sopralluoghi
  • Monitoraggio automatizzato: ricezione di avvisi proattivi per eventi di dispositivo offline, condizioni di batteria scarica, avvisi di memoria piena e anomalie di autenticazione

Requisiti di rete per Native Push

Connettività internet:

  • I dispositivi richiedono accesso a internet (WiFi, Ethernet, cellulare 4G/5G o altra connettività IP)
  • La connessione può essere intermittente: i dispositivi gestiscono le disconnessioni temporanee in modo corretto tramite l'accodamento automatico
  • Larghezza di banda minima: 10-50 Kbps per dispositivo (una tipica transazione di presenza occupa 1-2 KB)
  • Tolleranza alla latenza: funziona con connessioni satellitari, cellulari 3G/4G e WiFi d'ufficio standard (fino a 5000 ms accettabili)

Configurazione del firewall:

  • Il traffico HTTPS in uscita (porta 443) deve essere consentito dalla sottorete dei dispositivi verso api.camsbiometrics.com
  • Connessioni in ingresso non richieste (i dispositivi avviano tutte le connessioni come client)
  • Nessun port forwarding necessario (modello di comunicazione solo in uscita)
  • Compatibile con NAT (Network Address Translation): i dispositivi dietro router NAT funzionano normalmente
  • Funziona dietro firewall aziendali con politiche standard di accesso web in uscita

Risoluzione DNS:

  • I dispositivi devono risolvere il nome di dominio api.camsbiometrics.com in un indirizzo IP
  • Sono accettabili i server DNS standard (Google DNS 8.8.8.8, DNS dell'organizzazione, DNS del provider internet, ecc.)
  • Si consiglia un DNS secondario di riserva per garantire l'affidabilità

Quando usare la distribuzione Native Push

Scenari ideali per Native Push:

  • Nuove installazioni di sistemi biometrici con dispositivi moderni compatibili con il cloud
  • Organizzazioni con connettività internet standard presso le sedi dei dispositivi
  • Strategie IT cloud-first che privilegiano l'architettura SaaS (Software-as-a-Service)
  • Distribuzioni multi-sede (catene di negozi al dettaglio, uffici distribuiti, reti di filiali)
  • Applicazioni per forza lavoro mobile che richiedono visibilità delle presenze in tempo reale
  • Ambienti in cui i dispositivi possono raggiungere internet (direttamente o tramite la rete aziendale)
  • Situazioni che richiedono la piena funzionalità API (gestione remota degli utenti, configurazione dei dispositivi)

Organizzazioni che utilizzano Native Push:

  • Catene di negozi al dettaglio con terminali di rilevazione presenze tramite impronta in ogni punto vendita
  • Uffici aziendali con controllo accessi tramite riconoscimento facciale agli ingressi dell'edificio
  • Istituti scolastici con sistemi di rilevazione presenze biometrici nelle aule
  • Strutture sanitarie con autenticazione tramite vene palmari per l'accesso controllato ai farmaci
  • Aziende di logistica con terminali a impronta presso le banchine di carico dei magazzini
  • Centri BPO (Business Process Outsourcing) con sistemi di presenza multimodali
  • Catene alberghiere con rilevazione biometrica degli orari per il personale di housekeeping e della reception

Opzione di distribuzione 2: Hybrid Push Service

Che cos'è la distribuzione Hybrid Push?

Hybrid Push Service è l'architettura di integrazione alternativa utilizzata quando i dispositivi biometrici non possono supportare la distribuzione Native Push. Questo accade quando i dispositivi non superano la verifica di compatibilità su developer.camsbiometrics.com, oppure quando l'infrastruttura di rete impedisce ai dispositivi di mantenere una connettività cloud diretta.

Hybrid Push introduce un componente intermedio:

  • Un computer, un server o un dispositivo edge (PC Windows, server Linux, Raspberry Pi, ecc.) si colloca tra i dispositivi biometrici e il cloud
  • Questo intermediario esegue un software (SDK, servizio locale o connettore di database) che comunica con i dispositivi utilizzando i protocolli da essi supportati
  • L'intermediario dispone di connettività internet e comunica con la cloud API
  • I dispositivi biometrici possono avere o non avere accesso a internet

Differenza architetturale fondamentale:

  • Native Push: il dispositivo comunica direttamente con il cloud
  • Hybrid Push: il dispositivo comunica con il computer intermedio, il quale comunica con il cloud

Perché esiste Hybrid Push: risolvere i problemi di incompatibilità

Incompatibilità a livello di dispositivo:

  • Terminali biometrici legacy (vecchi di 5-10+ anni) privi di firmware per la connettività cloud
  • Dispositivi che utilizzano RS232, RS485, Wiegand o altri protocolli di comunicazione legacy
  • Scanner di impronte progettati solo per la connessione a un PC locale (lettori desktop collegati via USB)
  • Pannelli di controllo accessi con protocolli di rete proprietari
  • Dispositivi di produttori privi di supporto API standardizzato

Vincoli dell'infrastruttura di rete:

  • Reti di produzione air-gapped in cui i dispositivi non possono accedere a internet per motivi di sicurezza
  • Installazioni governative o della difesa che vietano la connettività internet dei dispositivi
  • Ambienti sanitari con requisiti di isolamento di rete HIPAA
  • Istituti finanziari con obblighi di segmentazione della rete PCI-DSS
  • Stabilimenti industriali con reti OT (Operational Technology) separate dalle reti IT

Restrizioni delle politiche di sicurezza:

  • Organizzazioni che vietano, come politica di sicurezza, l'accesso a internet dei dispositivi IoT
  • Requisiti di conformità che impongono l'elaborazione dei dati in sede
  • Normative sulla sovranità dei dati che impediscono la trasmissione dei dati al cloud
  • Architetture di rete zero-trust che bloccano le comunicazioni dal dispositivo verso internet

Architettura Hybrid Push: quattro modalità di connessione

La distribuzione Hybrid Push si adatta a diverse configurazioni infrastrutturali attraverso quattro modalità distinte. La scelta della modalità dipende da ciò che consente la topologia della rete e da dove è possibile l'integrazione.

Modalità A: connessione hardware tramite port forwarding (basata su SDK)

Che cosa significa questa modalità:

Questa distribuzione utilizza l'SDK di Cams Biometrics (Software Development Kit) in esecuzione su un computer intermedio dotato di connettività internet. L'SDK comunica direttamente con l'hardware dei dispositivi biometrici utilizzando il protocollo nativo del dispositivo. Il port forwarding nel router di rete consente all'SDK di raggiungere i dispositivi anche se si trovano su segmenti di rete diversi.

Architettura tecnica:

Dispositivo biometrico (su rete locale 192.168.1.x)
    ↓ [Protocollo nativo del dispositivo: TCP/IP, RS485, ecc.]
    ↓ [Comunicazione hardware diretta]
    ↓
Computer intermedio con SDK (dispone di accesso a internet)
    ↑ [Port forwarding: il router inoltra la porta 4370 all'IP del dispositivo]
    ↓ [HTTPS verso il cloud ogni 30 secondi]
    ↓
Cloud API Gateway (api.camsbiometrics.com)
    ↓ [Webhook verso il partner]
    ↓
Applicazione partner (HRMS/ERP)

Come fluiscono i dati:

  1. Il dipendente scansiona l'impronta sul dispositivo biometrico
  2. Il dispositivo memorizza la transazione localmente (nessun invio immediato al cloud: il dispositivo non è compatibile con il cloud)
  3. L'SDK in esecuzione sul computer intermedio interroga il dispositivo ogni 30 secondi: "Ci sono nuove transazioni?"
  4. Il dispositivo risponde con le transazioni raccolte dall'ultima interrogazione
  5. L'SDK riceve i dati delle transazioni, li formatta e invia una richiesta HTTPS alla cloud API
  6. La cloud API convalida i dati e attiva un POST webhook verso l'endpoint dell'applicazione partner
  7. Il partner riceve il record di presenza con un ritardo massimo di 30 secondi rispetto all'orario effettivo della scansione

Comportamento online (il computer intermedio ha accesso a internet):

  • L'SDK interroga i dispositivi ogni 30 secondi
  • Le nuove transazioni vengono raccolte e inviate al cloud con una latenza di 30 secondi
  • I webhook vengono consegnati all'applicazione partner ogni 30 secondi (se sono presenti nuovi dati)

Comportamento offline (il computer intermedio perde l'accesso a internet):

  • L'SDK continua a interrogare i dispositivi ogni 30 secondi, raccogliendo le transazioni
  • L'SDK memorizza le transazioni raccolte in una coda locale sul computer intermedio
  • Quando la connessione internet del computer viene ripristinata, l'SDK invia automaticamente al cloud le transazioni accodate
  • Tutti i dati accodati vengono consegnati tramite webhook con intervalli di 30 secondi tra un lotto e l'altro
  • Nessuna perdita di dati, ripristino automatico completo

Dipendenze per la disponibilità dei dati:

  • Connettività computer-dispositivo: l'SDK deve raggiungere i dispositivi per raccogliere le transazioni (LAN, WiFi o port forwarding)
  • Connettività dispositivo-computer: se il dispositivo perde la connessione di rete con il computer (cavo Ethernet scollegato, WiFi non disponibile), l'SDK non può raccogliere le transazioni fino al ripristino della connettività
  • Connettività computer-cloud: è necessaria una connessione internet sul computer intermedio per l'invio al cloud

Casi d'uso per la Modalità A:

  • Filiali con server locale e capacità di port forwarding
  • Punti vendita con PC di back-office collegato al terminale di rilevazione presenze
  • Piccole imprese con dispositivi sulla stessa LAN del computer dell'ufficio
  • Sedi distribuite in cui la configurazione del router consente il port forwarding

Modalità B: connessione al database tramite port forwarding

Che cosa significa questa modalità:

Questa distribuzione si integra a livello di database anziché direttamente con l'hardware biometrico. Molti dispositivi biometrici memorizzano le transazioni di presenza in un database locale (Microsoft SQL Server, MySQL, SQLite, Access, ecc.). Il computer intermedio si connette a questo database tramite port forwarding, legge i record delle transazioni e li invia al cloud.

Architettura tecnica:

Dispositivo biometrico (scrive nel database)
    ↓ [Dispositivo-DB: qualsiasi protocollo utilizzi il dispositivo]
    ↓
Server database (SQL Server, MySQL, ecc.)
    ↑ [Port forwarding: consente all'intermediario di raggiungere il DB]
    ↓ [Query SQL ogni 30 secondi]
    ↓
Computer intermedio con connettore DB (dispone di internet)
    ↓ [HTTPS verso il cloud ogni 30 secondi]
    ↓
Cloud API Gateway (api.camsbiometrics.com)
    ↓ [Webhook verso il partner]
    ↓
Applicazione partner (HRMS/ERP)

Come fluiscono i dati:

  1. Il dipendente scansiona l'impronta sul dispositivo biometrico
  2. Il dispositivo scrive il record di presenza in una tabella del database (utilizzando la propria connessione al database)
  3. Il computer intermedio esegue il software del connettore che interroga il database ogni 30 secondi
  4. Il connettore esegue una query SQL per recuperare dal database i nuovi record di presenza non sincronizzati
  5. Il connettore recupera i nuovi record, formatta i dati e li invia alla cloud API tramite HTTPS
  6. Il connettore aggiorna il database contrassegnando i record come sincronizzati, per evitare trasmissioni duplicate
  7. La cloud API riceve i dati e attiva un webhook verso l'applicazione partner

Comportamento online (il computer intermedio ha accesso a internet):

  • Il connettore di database interroga il database ogni 30 secondi
  • I nuovi record del database vengono inviati al cloud con una latenza di 30 secondi
  • I webhook vengono consegnati all'applicazione partner con il ritardo dell'intervallo di interrogazione

Comportamento offline (il computer intermedio perde l'accesso a internet):

  • Il connettore continua a interrogare il database ogni 30 secondi
  • Il connettore contrassegna i record come "in attesa di sincronizzazione" nel database
  • Al ripristino della connessione internet, il connettore invia al cloud tutti i record in attesa
  • I dati accodati vengono consegnati automaticamente tramite webhook

Dipendenze per la disponibilità dei dati:

  • Connettività dispositivo-database: il dispositivo deve scrivere correttamente nel database (se il dispositivo perde la connessione al DB, le transazioni non vengono memorizzate)
  • Connettività computer-database: il connettore deve raggiungere il server del database tramite la rete (port forwarding o rete locale)
  • Connettività database-computer: se il server del database non è raggiungibile (problema di rete, server fuori servizio), il connettore non può leggere i nuovi record
  • Connettività computer-cloud: è necessaria una connessione internet sul computer intermedio per l'invio dei webhook

Limitazione: nessun supporto REST API

La Modalità B fornisce solo il flusso dei dati delle transazioni. Poiché l'integrazione avviene a livello di database, il sistema non può inviare comandi ai dispositivi biometrici. Le operazioni REST API (aggiunta di utenti, configurazione del dispositivo, eliminazione di registrazioni) non sono disponibili in questa modalità.

Perché esiste questa limitazione:

L'invio di comandi ai dispositivi richiede protocolli di comunicazione a livello hardware. L'integrazione tramite database si limita a leggere i record delle transazioni; non può controllare il comportamento del dispositivo né scrivere sui dispositivi i dati di registrazione degli utenti tramite il database.

Casi d'uso per la Modalità B:

  • Sistemi legacy in cui il produttore del dispositivo fornisce un output su database SQL
  • Ambienti in cui l'accesso al database è consentito ma l'accesso al dispositivo è limitato
  • Integrazione con software di rilevazione presenze esistente basato su database
  • Organizzazioni con controllo del DBA (Database Administrator) sull'accesso ai dati

Modalità C: connessione hardware tramite servizio locale

Che cosa significa questa modalità:

Questa distribuzione installa un servizio locale (servizio Windows o daemon Linux) su un computer intermedio all'interno della stessa rete dei dispositivi biometrici. Il servizio comunica direttamente con l'hardware dei dispositivi senza richiedere il port forwarding. Funziona in reti completamente isolate in cui l'accesso esterno non è consentito.

Architettura tecnica:

Dispositivo biometrico (su rete isolata, senza internet)
    ↓ [LAN/WiFi: rete locale 192.168.1.x]
    ↓ [Comunicazione con il protocollo nativo del dispositivo]
    ↓
Computer intermedio con servizio locale
    ↑ [Stessa rete locale, nessun port forwarding necessario]
    ↓ [HTTPS verso il cloud ogni 30 secondi]
    ↓
Cloud API Gateway (api.camsbiometrics.com)
    ↓ [Webhook verso il partner]
    ↓
Applicazione partner (HRMS/ERP)

Come fluiscono i dati:

  1. Un dipendente dell'area produttiva scansiona l'impronta sul terminale di rilevazione presenze
  2. Il dispositivo memorizza la transazione nella memoria locale (dispositivo su rete di produzione isolata)
  3. Il servizio locale in esecuzione sul computer intermedio (anch'esso sulla rete di produzione) interroga il dispositivo ogni 30 secondi
  4. Il servizio raccoglie le nuove transazioni utilizzando il protocollo di comunicazione del dispositivo
  5. Il servizio invia i dati raccolti alla cloud API tramite la connessione internet del computer intermedio
  6. La cloud API attiva un webhook verso l'HRMS basato sul cloud del partner

Comportamento online (il computer intermedio ha accesso a internet):

  • Il servizio locale interroga i dispositivi ogni 30 secondi
  • Le transazioni vengono raccolte e inviate al cloud con una latenza di 30 secondi
  • I webhook vengono consegnati all'applicazione partner agli intervalli di interrogazione

Comportamento offline (il computer intermedio perde l'accesso a internet):

  • Il servizio continua a interrogare i dispositivi e a raccogliere le transazioni localmente
  • Il servizio accoda i dati nella memoria del computer intermedio
  • Al ripristino della connessione internet, il servizio sincronizza automaticamente con il cloud i dati accodati
  • Tutti i record di presenza vengono consegnati tramite webhook, senza intervento manuale

Dipendenze per la disponibilità dei dati:

  • Connettività computer-dispositivo: il servizio deve raggiungere i dispositivi sulla rete locale (se lo switch si guasta, il WiFi è disattivato o il cavo è scollegato, la raccolta si interrompe)
  • Funzionamento del dispositivo: i dispositivi continuano a registrare localmente le presenze durante eventuali problemi di rete
  • Connettività computer-cloud: per l'invio al cloud è necessaria una connessione internet sul computer intermedio (i dispositivi stessi non richiedono internet)

Casi d'uso per la Modalità C:

  • Stabilimenti produttivi con reti di produzione air-gapped
  • Installazioni governative che vietano l'accesso a internet dei dispositivi
  • Strutture sanitarie con reti di dispositivi medici isolate
  • Istituti finanziari con zone sicure separate
  • Ambienti industriali con isolamento della rete OT dalle reti IT

Modalità D: connessione al database tramite servizio locale

Che cosa significa questa modalità:

Il servizio locale si connette a un server di database sulla rete locale, leggendo le transazioni di presenza che i dispositivi biometrici scrivono nel database. Questa modalità combina l'integrazione tramite database con una distribuzione on-premises, adatta ad ambienti altamente vincolati.

Architettura tecnica:

Dispositivo biometrico (scrive nel server database locale)
    ↓ [Protocollo di connessione al database del dispositivo]
    ↓
Server database (su rete isolata, senza internet)
    ↓ [Query SQL ogni 30 secondi]
    ↓
Computer intermedio con servizio locale
    ↑ [Stessa rete locale, lettura dal database]
    ↓ [HTTPS verso il cloud ogni 30 secondi]
    ↓
Cloud API Gateway (api.camsbiometrics.com)
    ↓ [Webhook verso il partner]
    ↓
Applicazione partner (HRMS/ERP)

Come fluiscono i dati:

  1. Il dipendente si autentica tramite riconoscimento facciale al terminale di controllo accessi
  2. Il dispositivo scrive l'evento di accesso nel database locale SQL Server
  3. Il servizio locale interroga il database ogni 30 secondi con una query SQL
  4. Il servizio recupera i nuovi record e formatta i dati
  5. Il servizio invia i dati alla cloud API tramite la connessione internet del computer intermedio
  6. La cloud API invia il webhook all'applicazione cloud del partner

Comportamento online (il computer intermedio ha accesso a internet):

  • Il servizio interroga il database ogni 30 secondi
  • I nuovi record del database vengono inviati al cloud con una latenza di 30 secondi
  • I webhook vengono consegnati agli intervalli di interrogazione

Comportamento offline (il computer intermedio perde l'accesso a internet):

  • Il servizio continua a interrogare il database, contrassegnando i record come in attesa
  • I dati vengono accodati per la sincronizzazione con il cloud al ripristino di internet
  • Ripristino automatico, nessuna perdita di dati

Dipendenze per la disponibilità dei dati:

  • Connettività dispositivo-database: il dispositivo deve scrivere correttamente nel database (se il dispositivo perde la connessione al DB, le transazioni non vengono memorizzate)
  • Connettività database-servizio: il servizio deve raggiungere il server del database sulla rete locale (se il server del database è fuori servizio, non è possibile leggere i record)
  • Connettività computer-cloud: connessione internet sul computer intermedio per la consegna dei webhook (database e dispositivi non richiedono internet)

Limitazione: nessun supporto REST API

Come la Modalità B, anche la Modalità D fornisce solo il flusso dei dati delle transazioni. Non sono disponibili API per il controllo dei dispositivi, la gestione degli utenti o la configurazione, a causa dei vincoli dell'integrazione a livello di database.

Casi d'uso per la Modalità D:

  • Settori altamente regolamentati con requisiti di sovranità dei dati
  • Obblighi di elaborazione dei dati esclusivamente on-premises
  • Sistemi legacy basati su database con isolamento di rete
  • Organizzazioni che vietano qualsiasi connettività internet dei dispositivi

Confronto delle capacità di Hybrid Push

CapacitàModalità A: Port Fwd hardwareModalità B: Port Fwd databaseModalità C: Servizio locale hardwareModalità D: Servizio locale database
Consegna delle transazioni✅ Polling ogni 30 sec✅ Polling ogni 30 sec✅ Polling ogni 30 sec✅ Polling ogni 30 sec
Accodamento offline✅ Sul computer✅ Sul computer✅ Sul computer✅ Sul computer
Aggiunta utenti✅ Senza biometria*❌ Non supportato✅ Senza biometria*❌ Non supportato
Recupero dati utente❌ Non supportato❌ Non supportato❌ Non supportato❌ Non supportato
Configurazione dispositivo⚠️ Limitata❌ Non supportato⚠️ Limitata❌ Non supportato
Registrazione biometrica⚠️ Solo sul dispositivo locale⚠️ Solo sul dispositivo locale⚠️ Solo sul dispositivo locale⚠️ Solo sul dispositivo locale
Port forwarding richiesto✅ Sì✅ Sì❌ No❌ No
Internet del dispositivo richiesto❌ No❌ No❌ No❌ No
Internet del computer richiesto✅ Sì✅ Sì✅ Sì✅ Sì

*Chiarimento importante su "Aggiunta utenti senza biometria":

Nelle Modalità Hybrid A e C, il sistema può creare record utente sul dispositivo biometrico (nome, ID dipendente, numero di tessera, reparto, permessi di accesso), ma non può caricare remotamente i template biometrici. I dipendenti devono recarsi fisicamente al dispositivo per registrare la propria impronta, il volto o l'iride. Questa limitazione esiste perché i dispositivi con distribuzione hybrid non dispongono della connettività cloud necessaria per il trasferimento remoto dei template biometrici.

Comprendere la latenza di 30 secondi

Perché 30 secondi invece del tempo reale?

La distribuzione hybrid utilizza un'architettura a polling anziché un'architettura push:

  • Native Push (tempo reale): il dispositivo invia proattivamente i dati al cloud non appena si verifica un evento
  • Hybrid Push (30 sec): il computer intermedio chiede ripetutamente ai dispositivi "ci sono nuovi dati?" ogni 30 secondi

Meccanismo di polling:

Secondo 0: il servizio controlla i dispositivi - trova 3 nuove transazioni - le invia al cloud
Secondo 30: il servizio controlla i dispositivi - trova 1 nuova transazione - la invia al cloud
Secondo 60: il servizio controlla i dispositivi - trova 0 nuove transazioni - nessun webhook inviato
Secondo 90: il servizio controlla i dispositivi - trova 5 nuove transazioni - le invia al cloud

Perché non interrogare ogni secondo?

Un polling più frequente consuma più banda di rete, aumenta il carico sul processore del dispositivo e offre un vantaggio minimo per i tipici casi d'uso di rilevazione presenze. I sistemi di presenza in genere non richiedono una precisione inferiore al secondo: una latenza di 30 secondi è sufficiente per l'elaborazione delle paghe, il monitoraggio dei turni e la registrazione degli accessi.

È possibile personalizzare l'intervallo di polling?

La frequenza di polling può essere modificata (10 secondi, 60 secondi, ecc.) in base a requisiti specifici, anche se 30 secondi rappresentano il miglior equilibrio tra prestazioni quasi in tempo reale ed efficienza delle risorse di sistema.

Comprendere i limiti della registrazione biometrica nella modalità Hybrid

Perché le biometrie non possono essere registrate da remoto nelle modalità Hybrid?

L'acquisizione del template biometrico richiede:

  1. Hardware sensore di alta qualità (lettore ottico di impronte, telecamera IR per il volto, scanner dell'iride)
  2. Presenza fisica per il corretto posizionamento del dito, del volto o per l'allineamento dello sguardo
  3. Acquisizioni multiple per la verifica della qualità del template (in genere 3-5 scansioni per dito)
  4. Rilevamento della persona in carne e ossa (live detection) per prevenire lo spoofing (verifica della biometria reale rispetto a quella falsa)

I dispositivi con distribuzione hybrid operano offline o con connettività limitata. Non possono ricevere template biometrici dal cloud perché:

  • Sicurezza: i template biometrici trasmessi sulla rete creano un rischio di intercettazione
  • Qualità: il caricamento remoto dei template non consente di verificare la qualità dell'acquisizione biometrica
  • Capacità del dispositivo: i dispositivi con distribuzione hybrid spesso non dispongono del firmware per la ricezione remota dei template
  • Limitazione del protocollo: i dispositivi legacy non supportano formati di template standardizzati

Flusso di lavoro per la registrazione degli utenti nella distribuzione Hybrid:

  1. L'amministratore crea il record utente (solo Modalità A/C): il sistema aggiunge al dispositivo nome, ID e reparto del dipendente senza dati biometrici
  2. La API crea il record utente sul dispositivo biometrico senza template biometrico
  3. Il dipendente si reca fisicamente al terminale biometrico
  4. Registrazione locale: il dipendente scansiona l'impronta 3 volte sul dispositivo oppure registra il volto
  5. Il dispositivo acquisisce il template biometrico e lo memorizza localmente
  6. Il dispositivo verifica la qualità del template e lo salva nella memoria non volatile
  7. Il dipendente può ora autenticarsi al dispositivo per la rilevazione delle presenze

Registrazione degli utenti nelle modalità database (B/D):

Poiché le modalità database non dispongono di una API per la gestione degli utenti, la registrazione degli utenti avviene interamente tramite l'interfaccia locale del dispositivo:

  1. L'amministratore utilizza il tastierino o il touchscreen del dispositivo per aggiungere l'utente
  2. Il dipendente si registra direttamente sul dispositivo per la parte biometrica
  3. Il dispositivo scrive il record di registrazione nel database
  4. Il servizio intermedio legge la registrazione dell'utente dal database e, facoltativamente, la sincronizza con l'applicazione partner

Confronto completo delle capacità: Native Push vs. Hybrid Push

Matrice dettagliata delle funzionalità

Categoria di funzionalitàNative Push (Web API)Hybrid Modalità A/C (Hardware)Hybrid Modalità B/D (Database)
Consegna delle transazioni di presenza
Dispositivo online, internet disponibileIstantanea (< 1 secondo)Intervallo di polling di 30 secondiIntervallo di polling di 30 secondi
Dispositivo online, internet non disponibileAccodata sul dispositivo, invio automatico alla riconnessioneAccodata sul computer, invio automatico alla riconnessione del computerAccodata sul computer, invio automatico alla riconnessione del computer
Dispositivo offline (spento)Accodata sul dispositivo all'accensioneNon raccoglibile finché il dispositivo non si accendeNon raccoglibile finché il dispositivo non scrive nel DB
Consegna di webhook/callback
Metodo di consegnaPOST HTTPS in tempo realePOST HTTPS basato su pollingPOST HTTPS basato su polling
URL del webhookEndpoint configurato dal partnerEndpoint configurato dal partnerEndpoint configurato dal partner
Formato dei datiJSON con tutti i dettagli della transazioneJSON con tutti i dettagli della transazioneJSON con tutti i dettagli della transazione
Meccanismo di nuovo tentativoNuovo tentativo automatico in caso di erroreNuovo tentativo automatico in caso di erroreNuovo tentativo automatico in caso di errore
Operazioni di gestione utenti
Aggiunta utente con dati anagrafici✅ Supporto completo✅ Supporto base❌ Non disponibile
Registrazione remota dei template biometrici✅ Caricamento dal cloud❌ Solo registrazione locale❌ Solo registrazione locale
Recupero della banca dati utenti dal dispositivo✅ Elenco completo❌ Non disponibile❌ Non disponibile
Aggiornamento delle informazioni utente✅ Modifica completa⚠️ Limitata tramite dispositivo❌ Non disponibile
Eliminazione delle registrazioni utente✅ Rimozione dal cloud⚠️ Limitata tramite dispositivo❌ Non disponibile
Caricamento massivo di utenti✅ Operazioni di massa❌ Non disponibile❌ Non disponibile
Sincronizzazione tra dispositivi✅ Sincronizzazione automatica❌ Non disponibile❌ Non disponibile
Operazioni di gestione dei dispositivi
Interrogazione dello stato e della salute del dispositivo✅ Diagnostica completa⚠️ Dati limitati❌ Non disponibile
Configurazione dei parametri del dispositivo✅ Controllo completo⚠️ Solo impostazioni base❌ Non disponibile
Aggiornamenti firmware remoti✅ Supportati❌ Non disponibile❌ Non disponibile
Recupero dei log di sistema del dispositivo✅ Accesso completo❌ Non disponibile❌ Non disponibile
Invio di comandi al dispositivo✅ Tutti i comandi⚠️ Comandi limitati❌ Non disponibile
Gestione delle pianificazioni di accesso✅ Pianificazione completa⚠️ Supporto base❌ Non disponibile
Operazioni sui dati di presenza
Webhook delle transazioni in tempo reale✅ Invio istantaneo✅ Consegna in 30 sec✅ Consegna in 30 sec
Interrogazione dello storico delle presenze✅ Interrogazioni per intervallo completo⚠️ Solo tramite webhook⚠️ Solo tramite webhook
Inserimento manuale delle presenze✅ Supporto API❌ Non disponibile❌ Non disponibile
Eliminazione/modifica dei record✅ Supportate❌ Non disponibili❌ Non disponibili
Requisiti di rete
Accesso a internet del dispositivo richiesto✅ Sì (anche intermittente)❌ No❌ No
Computer intermedio richiesto❌ No✅ Sì✅ Sì
Internet dell'intermedio richiesto❌ N/D✅ Sì✅ Sì
Port forwarding richiesto❌ No✅ Solo Modalità A/B❌ Modalità C/D
Configurazione del firewallSolo porta 443 in uscitaPorta 443 in uscita dal computerPorta 443 in uscita dal computer
Resilienza offline
Dove si accodano i dati durante l'offlineMemoria interna del dispositivoMemoria del computer intermedioMemoria del computer intermedio
Sincronizzazione automatica alla riconnessione✅ Sì✅ Sì✅ Sì
Capacità massima di archiviazione offline50.000-100.000 record (dipende dal dispositivo)Limitata dallo spazio su disco del computerLimitata dallo spazio su disco del computer
Caratteristiche di prestazione
Latenza media (online)< 1 secondo~30 secondi~30 secondi
Banda per dispositivo10-50 KbpsMinima (solo computer-cloud)Minima (solo computer-cloud)
ScalabilitàMigliaia di dispositiviLimitata dalla capacità del computerLimitata dalla capacità del computer

Raccomandazioni sui casi d'uso

Scegliere Native Push quando:

  • ✅ Si distribuisce un nuovo sistema biometrico con dispositivi moderni
  • ✅ I dispositivi superano la verifica di compatibilità su developer.camsbiometrics.com
  • ✅ I dispositivi possono accedere a internet (direttamente o tramite la rete aziendale)
  • ✅ La visibilità delle presenze in tempo reale è importante
  • ✅ È necessaria la gestione remota degli utenti
  • ✅ Strategia IT cloud-first
  • ✅ Distribuzione multi-sede (retail, filiali)
  • ✅ Preferenza per il SaaS (Software-as-a-Service)
  • ✅ Si desidera un investimento minimo in infrastruttura IT

Scegliere Hybrid Modalità A (Port Forwarding hardware) quando:

  • ⚠️ I dispositivi non hanno superato la verifica di compatibilità
  • ⚠️ Dispositivi legacy senza firmware cloud
  • ⚠️ La rete consente la configurazione del port forwarding
  • ⚠️ È possibile l'integrazione a livello di dispositivo
  • ⚠️ È necessaria una gestione utenti di base
  • ⚠️ È accettabile una latenza di 30 secondi
  • ⚠️ È disponibile un computer intermedio

Scegliere Hybrid Modalità B (Port Forwarding database) quando:

  • ⚠️ I dispositivi scrivono in un database (SQL Server, MySQL, ecc.)
  • ⚠️ È concesso l'accesso al database ma l'accesso al dispositivo è limitato
  • ⚠️ Il port forwarding verso il server del database è fattibile
  • ⚠️ È richiesto solo il flusso dei dati delle transazioni (non è necessario controllare il dispositivo)
  • ⚠️ Software di rilevazione presenze esistente basato su database
  • ⚠️ Il DBA controlla tutto l'accesso ai dati

Scegliere Hybrid Modalità C (Servizio locale hardware) quando:

  • ⚠️ Rete air-gapped o dispositivi isolati
  • ⚠️ La politica di sicurezza vieta l'accesso a internet dei dispositivi
  • ⚠️ Il port forwarding non è consentito o non è possibile
  • ⚠️ È disponibile un server/PC on-premises con accesso a internet
  • ⚠️ È possibile l'integrazione a livello di dispositivo
  • ⚠️ Produzione, governo, sanità con isolamento di rete
  • ⚠️ È necessario un controllo di base del dispositivo

Scegliere Hybrid Modalità D (Servizio locale database) quando:

  • ⚠️ È richiesta un'integrazione solo tramite database
  • ⚠️ Rete completamente isolata (dispositivi e database)
  • ⚠️ Requisiti di sovranità dei dati o di conformità
  • ⚠️ Obbligo di elaborazione on-premises
  • ⚠️ Solo flusso delle transazioni (non è necessario il controllo API)
  • ⚠️ Sistemi legacy senza un percorso di modernizzazione

Requisiti infrastrutturali e dipendenze di rete

Requisiti infrastrutturali di Native Push

Nella sede del dispositivo:

  • Connettività internet (WiFi, Ethernet, 4G/5G cellulare o satellitare)
  • La connessione di rete può essere intermittente (i dispositivi accodano i dati durante le disconnessioni)
  • Banda minima: 10-50 Kbps per dispositivo
  • Latenza di rete: < 5000 ms accettabili (funziona con il satellite)

Regole del firewall:

  • Consentire HTTPS in uscita (TCP porta 443) dalla sottorete dei dispositivi verso api.camsbiometrics.com
  • Nessuna regola in ingresso necessaria (i dispositivi avviano tutte le connessioni)
  • Compatibile con NAT/PAT (Network/Port Address Translation)

Requisiti DNS:

  • I dispositivi devono risolvere il dominio api.camsbiometrics.com
  • Sono accettabili i server DNS aziendali standard
  • Alternativa: configurare un DNS statico (8.8.8.8 Google DNS, ecc.)

Compatibilità della topologia di rete:

  • ✅ Accesso diretto a internet
  • ✅ Server proxy aziendali (con autenticazione)
  • ✅ NAT/Firewall con HTTPS in uscita consentito
  • ✅ Tunnel VPN
  • ✅ Cloud VPC (Virtual Private Cloud) con gateway internet
  • ❌ Reti air-gapped (usare la modalità Hybrid)
  • ❌ Reti che bloccano tutte le connessioni in uscita (usare la modalità Hybrid)

Requisiti infrastrutturali della Modalità Hybrid A

Specifiche del computer intermedio:

  • OS: Windows 10/11, Windows Server 2016+, Ubuntu 20.04+, CentOS 8+ o Debian 11+
  • CPU: dual-core 2,0 GHz minimo (quad-core consigliato per più di 50 dispositivi)
  • RAM: 4 GB minimo (consigliati 8 GB)
  • Storage: 20 GB disponibili (per l'SDK e l'accodamento dei dati)
  • Rete: Ethernet o WiFi con connettività stabile

Topologia di rete:

Internet (Cloud API)
    ↑
    | [HTTPS in uscita]
    |
Computer intermedio (dispone di accesso a internet)
    ↑
    | [Port forwarding tramite router/firewall]
    |
Router/Firewall (inoltra la porta 4370 al dispositivo)
    ↑
    | [Rete locale o routing tra sottoreti]
    |
Dispositivo/i biometrico/i (non richiede internet)

Configurazione del port forwarding:

  • Configurare il router per inoltrare la porta TCP (in genere 4370, a seconda del dispositivo) all'indirizzo IP del dispositivo
  • Si consigliano IP statico o prenotazione DHCP per i dispositivi biometrici
  • Il port forwarding dall'interfaccia WAN (rete geografica) non è necessario: solo inoltro interno

Connettività computer-dispositivo:

  • Dispositivi sulla stessa sottorete LAN dell'intermedio: comunicazione diretta
  • Dispositivi su sottorete diversa: sono necessari port forwarding o routing
  • Protocolli supportati: TCP/IP, RS485 (con convertitore), USB (connessione locale)

Connettività computer-cloud:

  • Connessione internet stabile sul computer intermedio
  • HTTPS in uscita (porta 443) verso api.camsbiometrics.com
  • Banda minima: 100 Kbps (aumenta con il numero di dispositivi)

Requisiti infrastrutturali della Modalità Hybrid B

Specifiche del computer intermedio:

  • OS: Windows 10/11, Windows Server 2016+, Ubuntu 20.04+, CentOS 8+
  • CPU: dual-core 2,0 GHz minimo
  • RAM: 4 GB minimo (8 GB per database di grandi dimensioni)
  • Storage: 10 GB disponibili
  • Client database: SQL Server tools, MySQL Connector, client PostgreSQL (a seconda del tipo di database)

Topologia di rete:

Internet (Cloud API)
    ↑
    | [HTTPS in uscita]
    |
Computer intermedio (dispone di accesso a internet)
    ↑
    | [Connessione SQL tramite port forwarding]
    |
Router/Firewall (inoltra la porta SQL al server del database)
    ↑
    | [Rete del database]
    |
Server database (SQL Server: 1433, MySQL: 3306, ecc.)
    ↑
    | [Protocollo di database specifico del dispositivo]
    |
Dispositivo/i biometrico/i (scrivono nel database)

Requisiti di accesso al database:

  • Credenziali del database: nome utente e password con permessi SELECT e UPDATE
  • Stringa di connessione al database: IP del server, porta, nome del database
  • Port forwarding: il router inoltra la porta del database (1433, 3306, ecc.) al server del database
  • Database supportati: SQL Server, MySQL, PostgreSQL, Oracle, SQLite, MS Access

Connettività computer-database:

  • Percorso di rete dal computer intermedio al server del database
  • Porta del database accessibile (direttamente o tramite port forwarding)
  • Le regole del firewall del database consentono l'IP del computer

Connettività computer-cloud:

  • Accesso a internet sul computer intermedio
  • HTTPS in uscita (porta 443) consentito

Importante: dipendenza dispositivo-database

La disponibilità dei dati dipende dalla corretta scrittura dei dispositivi nel database:

  • Se il dispositivo perde la connessione di rete al server del database, le transazioni non vengono memorizzate
  • Se il server del database va in crash, le transazioni vanno perse fino al ripristino
  • Il database deve essere accessibile ai dispositivi per la registrazione delle transazioni
  • Si consigliano backup e ridondanza per il server del database

Requisiti infrastrutturali della Modalità Hybrid C

Specifiche del computer intermedio:

  • OS: Windows 10/11, Windows Server 2016+, Ubuntu 20.04+, CentOS 8+
  • CPU: dual-core 2,0 GHz minimo (quad-core per più di 100 dispositivi)
  • RAM: 4 GB minimo (8 GB consigliati)
  • Storage: 20 GB disponibili
  • Rete: si consigliano due interfacce di rete (una per i dispositivi locali, una per internet)

Topologia di rete:

Internet (Cloud API)
    ↑
    | [HTTPS in uscita tramite l'interfaccia connessa a internet]
    |
Computer intermedio (dual-homed: rete locale + internet)
    |
    | [Interfaccia di rete locale - nessun port forwarding necessario]
    ↓
Switch di rete locale/WiFi (isolato da internet)
    ↓
Dispositivo/i biometrico/i (su rete isolata, senza internet)

Configurazione del computer dual-homed:

Opzione 1: due interfacce di rete fisiche

  • NIC 1: collegata alla rete locale isolata con i dispositivi biometrici (192.168.1.x)
  • NIC 2: collegata alla rete aziendale con accesso a internet (10.0.0.x)
  • Il servizio locale comunica con i dispositivi tramite NIC 1
  • Il servizio locale invia i dati al cloud tramite NIC 2

Opzione 2: WiFi + Ethernet

  • Ethernet: collegata alla rete isolata dei dispositivi
  • WiFi: collegato a una rete wireless con accesso a internet
  • Il servizio si associa all'interfaccia appropriata per ciascuna comunicazione

Connettività computer-dispositivo:

  • Stessa sottorete locale (nessun routing necessario)
  • Dispositivi raggiungibili tramite LAN (test ping: ping 192.168.1.100)
  • Nessun port forwarding necessario (accesso locale diretto)
  • Protocolli supportati: TCP/IP, RS485 (con convertitore USB), Wiegand (con controller)

Connettività computer-cloud:

  • Accesso a internet tramite un'interfaccia di rete separata
  • HTTPS in uscita (porta 443) verso api.camsbiometrics.com
  • Rete aziendale o connessione internet diretta

Considerazioni per le reti air-gapped:

  • Dispositivi biometrici su una rete completamente isolata (senza accesso a internet)
  • Il computer intermedio collega la rete isolata con internet
  • Garantisce la conformità alle politiche di sicurezza che vietano l'accesso a internet dei dispositivi IoT
  • Flussi dei dati: dispositivi → rete locale → computer → internet → cloud

Requisiti infrastrutturali della Modalità Hybrid D

Specifiche del computer intermedio:

  • OS: Windows 10/11, Windows Server 2016+, Ubuntu 20.04+
  • CPU: dual-core 2,0 GHz minimo
  • RAM: 4 GB minimo (8 GB per database di grandi dimensioni)
  • Storage: 10 GB disponibili
  • Client database: strumenti adeguati al tipo di database

Topologia di rete:

Internet (Cloud API)
    ↑
    | [HTTPS in uscita tramite l'interfaccia connessa a internet]
    |
Computer intermedio (dual-homed: rete locale + internet)
    |
    | [Interfaccia di rete locale - accesso diretto al database]
    ↓
Rete locale (isolata da internet)
    ↓
Server database (senza accesso a internet)
    ↑
    | [Protocollo di database del dispositivo]
    |
Dispositivo/i biometrico/i (rete isolata, senza internet)

Accesso al database:

  • Server del database su una rete locale isolata
  • Computer intermedio sulla stessa rete (accesso SQL diretto)
  • Nessun port forwarding necessario (stessa sottorete)
  • Credenziali del database con permessi SELECT e UPDATE

Connettività computer-database:

  • Accesso alla rete locale verso il server del database
  • Porta del database raggiungibile (1433, 3306, ecc.)
  • Il firewall del database consente l'IP del computer locale

Connettività computer-cloud:

  • Internet tramite un'interfaccia di rete separata
  • HTTPS in uscita (porta 443) consentito

Dipendenza dispositivo-database:

  • I dispositivi scrivono le transazioni nel server del database locale
  • Il database deve essere accessibile ai dispositivi sulla rete locale
  • Se il dispositivo perde la connessione al database, le transazioni non vengono memorizzate
  • La disponibilità del server del database è fondamentale per la disponibilità dei dati

Dipendenze di connettività e flusso dei dati

Comprendere le dipendenze critiche

Ogni modalità di distribuzione presenta specifiche dipendenze di connettività che determinano la disponibilità dei dati:

Dipendenze di connettività di Native Push

Punto di dipendenza singolo:

Dispositivo biometrico ←→ Internet ←→ Cloud API

Cosa deve funzionare affinché i dati fluiscano:

  1. Il dispositivo deve avere connettività internet
  2. Il dispositivo deve raggiungere api.camsbiometrics.com (risoluzione DNS, firewall che consente HTTPS)

Scenari di guasto:

  • Dispositivo offline (spento, cavo di rete scollegato): il dispositivo accoda internamente le transazioni e le invia automaticamente quando viene acceso e collegato
  • Internet non disponibile (interruzione del provider, guasto del router): il dispositivo accoda le transazioni e le invia automaticamente al ripristino di internet
  • Cloud API non disponibile (estremamente raro, manutenzione programmata): il dispositivo ritenta la connessione e accoda i dati finché l'API non è accessibile

Prevenzione della perdita di dati:

  • I dispositivi memorizzano 50.000-100.000 transazioni nella memoria interna
  • Meccanismo di nuovo tentativo automatico con backoff esponenziale
  • I dati persistono anche dopo lo spegnimento (memoria non volatile)

Dipendenze di connettività delle Modalità Hybrid A/C

Due punti di dipendenza:

Dispositivo ←→ Computer intermedio ←→ Internet ←→ Cloud API

Cosa deve funzionare affinché i dati fluiscano:

  1. Dispositivo-computer: il computer deve raggiungere il dispositivo (connettività LAN, port forwarding o accesso alla rete locale)
  2. Computer-cloud: il computer deve avere accesso a internet per inviare i webhook

Scenari di guasto:

Il dispositivo perde alimentazione:

  • Il dispositivo smette di registrare le transazioni
  • Il computer non può interrogare il dispositivo
  • Quando il dispositivo si riaccende, il computer riprende il polling e raccoglie le transazioni accodate

Il computer perde la connessione al dispositivo:

  • Il computer non può raccogliere nuove transazioni
  • I dispositivi continuano a registrare e a memorizzare localmente
  • Al ripristino della connettività, il computer interroga il dispositivo e recupera le transazioni accumulate

Il computer perde l'accesso a internet:

  • Il computer continua a interrogare i dispositivi e a raccogliere le transazioni
  • Il computer accoda localmente le transazioni raccolte
  • Al ripristino di internet, il computer invia automaticamente al cloud i dati accodati

Sia il dispositivo sia il computer offline:

  • Nessuna raccolta o trasmissione di dati
  • I dispositivi accodano internamente le transazioni
  • Quando entrambi tornano disponibili, il computer raccoglie i dati dei dispositivi e li invia al cloud

Limitazione della disponibilità dei dati: se un dispositivo è offline o non raggiungibile dal computer, il computer non può raccogliere le transazioni da quel dispositivo finché la connettività tra i due non viene ripristinata. Il computer può inviare al cloud solo ciò che ha raccolto con successo dai dispositivi.

Dipendenze di connettività delle Modalità Hybrid B/D

Tre punti di dipendenza:

Dispositivo ←→ Database ←→ Computer intermedio ←→ Internet ←→ Cloud API

Cosa deve funzionare affinché i dati fluiscano:

  1. Dispositivo-database: il dispositivo deve scrivere correttamente le transazioni nel database
  2. Database-computer: il computer deve leggere dal database (accesso in query)
  3. Computer-cloud: il computer deve avere accesso a internet per inviare i webhook

Scenari di guasto:

Il dispositivo perde la connessione al database:

  • Il dispositivo non può memorizzare le transazioni nel database
  • Le transazioni vanno perse o vengono accodate sul dispositivo (comportamento dipendente dal dispositivo)
  • Il computer non può recuperare dati che non sono mai stati scritti nel database

Il server del database va in crash:

  • I dispositivi non possono scrivere nuove transazioni
  • Il computer non può leggere le transazioni esistenti
  • I dati presenti nel database prima del crash potrebbero essere disponibili al ripristino del database

Il computer perde l'accesso al database:

  • Il computer non può leggere le nuove transazioni
  • I dispositivi continuano a scrivere nel database (se accessibile ai dispositivi)
  • Quando la connettività computer-database viene ripristinata, il computer legge i record accumulati

Il computer perde l'accesso a internet:

  • Il computer continua a leggere dal database
  • Il computer accoda localmente i record del database
  • Al ripristino di internet, il computer invia al cloud i dati accodati

Comprensione fondamentale per le Modalità B/D:

Il database funge da archivio intermedio tra i dispositivi e il computer. Il flusso dei dati dipende da:

  1. I dispositivi scrivono correttamente nel database
  2. Il database rimane accessibile al computer
  3. Il computer legge dal database e invia al cloud

Se i dispositivi non riescono a scrivere nel database (problema di rete, database non disponibile), le transazioni non vengono memorizzate e non possono essere recuperate in seguito. Questa è la limitazione critica delle modalità dipendenti dal database.

Gestione dei dati offline e ripristino automatico

Gestione offline di Native Push:

Esempio di scenario: interruzione di internet in un punto vendita

9:00 - Inizia l'interruzione di internet
9:05 - Il dipendente scansiona l'impronta → il dispositivo memorizza localmente (coda: 1 transazione)
9:15 - Il dipendente scansiona l'impronta → il dispositivo memorizza localmente (coda: 2 transazioni)
9:30 - Il dipendente scansiona l'impronta → il dispositivo memorizza localmente (coda: 3 transazioni)
11:00 - Internet ripristinata
11:00:05 - Il dispositivo rileva la connettività e invia automaticamente tutte e 3 le transazioni accodate
11:00:06 - La cloud API riceve le transazioni e attiva i webhook
11:00:07 - L'applicazione partner riceve tutti e 3 i record di presenza

Nessun intervento manuale richiesto. Il dispositivo gestisce l'accodamento, il rilevamento del ripristino della connettività e la sincronizzazione automatica.

Gestione offline delle Modalità Hybrid A/C:

Esempio di scenario: stabilimento produttivo con connettività intermittente al server

14:00 - Il computer intermedio perde l'accesso a internet (la rete locale è ancora operativa)
14:05 - Il servizio interroga i dispositivi, raccoglie 5 nuove transazioni, le accoda localmente
14:35 - Il servizio interroga i dispositivi, raccoglie 3 nuove transazioni, le accoda localmente (totale: 8)
15:05 - Il servizio interroga i dispositivi, raccoglie 2 nuove transazioni, le accoda localmente (totale: 10)
16:00 - Internet ripristinata sul computer
16:00:10 - Il servizio rileva la connettività e invia il primo lotto di transazioni accodate
16:00:40 - Il servizio invia il secondo lotto
16:01:10 - Il servizio invia il terzo lotto
16:01:40 - Tutti i dati accodati sono stati consegnati, il servizio riprende il polling normale ogni 30 secondi

Accodamento automatico nella memoria del computer, rilevamento automatico del ripristino di internet, consegna automatica a lotti dei dati accodati.

Gestione offline delle Modalità Hybrid B/D:

Esempio di scenario: struttura sanitaria con manutenzione del server del database

22:00 - Il server del database viene messo offline per manutenzione
22:30 - I dispositivi non possono scrivere nel database (transazioni perse se non memorizzate sul dispositivo)
23:00 - Il server del database torna online
23:00:05 - I dispositivi riprendono a scrivere nel database
23:30 - Il computer interroga il database e recupera le transazioni scritte dalle 23:00
23:30:05 - Il computer invia al cloud via webhook le transazioni recuperate

Differenza critica: le transazioni avvenute quando il database non è disponibile (dalle 22:00 alle 23:00) dipendono dal comportamento del dispositivo:

  • Dispositivi con accodamento interno: memorizzano le transazioni e le scrivono nel database quando è accessibile (nessuna perdita)
  • Dispositivi senza accodamento interno: le transazioni vanno perse durante l'indisponibilità del database

Per questo motivo le Modalità B/D richiedono un'attenta valutazione delle capacità dei dispositivi e dell'affidabilità del database.

Scenari reali di distribuzione ed esempi

Scenario 1: catena nazionale di negozi al dettaglio, Native Push

Profilo dell'organizzazione:

  • Oltre 500 punti vendita in tutto il paese
  • Terminali ZKTeco MultiBio 800 per volto + impronta in ogni sede
  • HRMS aziendale basato su cloud (SAP SuccessFactors)
  • Requisito: visibilità delle presenze in tempo reale per la gestione dei turni

Infrastruttura:

  • Ogni punto vendita dispone di una rete WiFi con accesso a internet
  • Il firewall aziendale consente HTTPS in uscita
  • Dispositivi verificati compatibili su developer.camsbiometrics.com

Distribuzione:

  • Modalità: Native Push con Web API completa
  • Configurazione dei dispositivi: dispositivi configurati con l'endpoint della cloud API, chiavi API univoche per sede
  • Rete: i dispositivi si connettono tramite il WiFi del negozio e comunicano direttamente con il cloud
  • Gestione utenti: il team HR carica i dati dei dipendenti tramite API, i dipendenti registrano le biometrie sui dispositivi del negozio

Flusso dei dati:

Il dipendente scansiona il volto alle 9:00:00
    ↓ [< 1 secondo]
Il dispositivo invia al cloud alle 9:00:00,5
    ↓ [< 0,5 secondi]
Il cloud attiva il webhook alle 9:00:01
    ↓ [< 1 secondo]
SAP SuccessFactors riceve la presenza alle 9:00:02
Latenza totale: 2 secondi dalla scansione all'HRMS

Benefici ottenuti:

  • I responsabili dei punti vendita vedono le presenze in tempo reale per la pianificazione dei turni
  • Avvisi immediati per ritardi o assenze ingiustificate
  • Controllo centralizzato di oltre 500 dispositivi dalla sede centrale
  • Risoluzione remota dei problemi e aggiornamenti di configurazione
  • Nessuna sincronizzazione manuale dei dati

Gestione delle interruzioni di internet nei punti vendita:

  • Internet del punto vendita non funziona alle 10:00
  • I dispositivi continuano a registrare le presenze localmente (memorizzate nella memoria del dispositivo)
  • Internet torna disponibile alle 14:00
  • I dispositivi inviano automaticamente in pochi secondi le 4 ore di presenze accodate
  • Nessuna perdita di dati, nessun intervento manuale

Scenario 2: stabilimento produttivo, Hybrid Modalità C (air-gapped)

Profilo dell'organizzazione:

  • Stabilimento di produzione di componenti automobilistici
  • 200 dipendenti su 3 turni
  • Area di produzione su rete isolata (air-gapped per sicurezza)
  • Dispositivi legacy Suprema BioEntry Plus (oltre 10 anni, senza capacità cloud)
  • L'ERP aziendale (Oracle) richiede l'integrazione delle presenze

Infrastruttura:

  • Rete di produzione: 192.168.10.x (completamente isolata, senza internet)
  • Rete aziendale: 10.0.5.x (con accesso a internet)
  • Un server gateway con due interfacce di rete collega entrambe le reti
  • La politica di sicurezza vieta qualsiasi accesso a internet per i dispositivi di produzione

Distribuzione:

  • Modalità: Hybrid Modalità C (servizio locale verso hardware)
  • Intermedio: Windows Server 2019 con due NIC (una per rete)
  • Servizio locale: Cams Local Service installato, interroga i dispositivi ogni 30 secondi
  • Accesso ai dispositivi: comunicazione TCP/IP diretta sulla rete di produzione (nessun port forwarding necessario)

Topologia di rete:

Area di produzione (isolata: 192.168.10.x)
    |
    |- Dispositivo biometrico 1: 192.168.10.101
    |- Dispositivo biometrico 2: 192.168.10.102
    |- Dispositivo biometrico 3: 192.168.10.103
    |- Gateway Server NIC 1: 192.168.10.200
          |
          |- (Stesso server fisico)
          |
    Gateway Server NIC 2: 10.0.5.50
    |
Rete aziendale (con internet: 10.0.5.x)
    |
Internet → Cloud API → ERP Oracle

Flusso dei dati:

9:00:00 - Il dipendente scansiona l'impronta sul dispositivo 1 (192.168.10.101)
9:00:00 - Il dispositivo memorizza localmente la transazione
9:00:15 - Il Local Service interroga il dispositivo 1: "Ci sono nuove transazioni?"
9:00:15,5 - Il dispositivo risponde con i dati della transazione
9:00:16 - Il servizio invia la transazione al cloud tramite NIC 2 (10.0.5.50)
9:00:17 - Il cloud attiva il webhook verso l'ERP Oracle
9:00:18 - L'ERP riceve il record di presenza
Latenza totale: circa 18 secondi (entro la finestra di polling di 30 secondi)

Benefici ottenuti:

  • Mantiene la politica di sicurezza air-gapped (i dispositivi non accedono mai a internet)
  • Funziona con dispositivi legacy che non potevano essere aggiornati
  • Dati di presenza centralizzati nonostante l'isolamento della rete
  • Il server gateway gestisce l'attraversamento del confine di sicurezza
  • Il team di sicurezza IT ha approvato la distribuzione (nessuna violazione delle politiche)

Gestione dell'offline del server gateway:

  • Il server gateway perde l'accesso a internet alle 14:00 (la rete di produzione è ancora operativa)
  • I dispositivi continuano a registrare le presenze sulla rete isolata
  • Il Local Service continua a interrogare i dispositivi e a raccogliere le transazioni
  • Il servizio accoda i dati raccolti nella memoria del server gateway
  • Internet torna disponibile alle 16:00
  • Il servizio invia automaticamente al cloud le 2 ore di dati accodati
  • L'ERP riceve tutti i record di presenza, nessuna perdita di dati

Scenario 3: sede aziendale multi-località, Hybrid Modalità A (port forwarding)

Profilo dell'organizzazione:

  • Società di servizi professionali con 50 filiali
  • Mix di dispositivi: eSSL K21 Pro, Anviz FacePass, modelli ZKTeco F18 meno recenti
  • Alcuni dispositivi verificati compatibili, altri non hanno superato la verifica
  • Politica aziendale: tutti i dispositivi devono usare lo stesso metodo di integrazione (coerenza)
  • Piattaforma HR basata su cloud (Workday)

Infrastruttura:

  • Ogni filiale dispone di un server locale (Windows Server o Linux)
  • Una VPN aziendale collega tutte le sedi
  • Dispositivi sulla rete locale di ciascuna filiale (192.168.x.x)
  • I server locali hanno accesso a internet
  • Port forwarding configurato sui router delle filiali

Distribuzione:

  • Modalità: Hybrid Modalità A (hardware tramite port forwarding con SDK)
  • Intermedio: server in ogni filiale con Cams SDK in esecuzione
  • Configurazione SDK: si connette ai dispositivi tramite port forwarding
  • Motivo della scelta hybrid: mix di dispositivi compatibili e non compatibili; distribuzione standardizzata in tutte le sedi

Esempio di configurazione di rete: filiale

Rete della filiale (192.168.1.x)
    |
    |- Dispositivo 1: 192.168.1.50 (eSSL K21 Pro - compatibile, ma usato in modalità hybrid per coerenza)
    |- Dispositivo 2: 192.168.1.51 (Anviz FacePass - verifica fallita, richiede hybrid)
    |- Server della filiale: 192.168.1.100 (esegue l'SDK, dispone di internet)
    |
Router della filiale (port forwarding)
    |- Inoltra la porta 4370 → 192.168.1.50
    |- Inoltra la porta 4371 → 192.168.1.51
    |
Internet → Cloud API → Workday

Configurazione del polling dell'SDK:

L'SDK interroga il dispositivo 1 ogni 30 secondi a 192.168.1.50:4370
L'SDK interroga il dispositivo 2 ogni 30 secondi a 192.168.1.51:4371

Flusso dei dati:

10:30:00 - Il dipendente si registra al dispositivo 2 (Anviz FacePass)
10:30:00 - Il dispositivo memorizza la transazione
10:30:15 - L'SDK interroga il dispositivo 2 e recupera la transazione
10:30:16 - L'SDK invia alla cloud API
10:30:17 - Il cloud attiva il webhook verso Workday
10:30:18 - Workday riceve la presenza
Latenza: circa 18 secondi

Flusso di gestione degli utenti:

L'HR aggiunge un nuovo dipendente in Workday
Workday attiva il sistema per creare l'utente
    ↓
Il sistema aggiunge l'utente al dispositivo 2 (senza biometria)
    ↓
Il dipendente visita la filiale e registra l'impronta localmente sul dispositivo 2
    ↓
Il dispositivo memorizza il template e il dipendente può ora autenticarsi

Benefici ottenuti:

  • Integrazione standardizzata in tutte le 50 filiali nonostante la compatibilità mista dei dispositivi
  • Funzionamento con dispositivi che non hanno superato la verifica del cloud
  • Gestione centralizzata dalla sede centrale
  • Esperienza utente coerente per il team HR
  • Un'unica integrazione mantenuta per tutti i tipi e le età dei dispositivi

Scenario 4: campus sanitario, Hybrid Modalità D (database, conformità)

Profilo dell'organizzazione:

  • Ospedale con 5 edifici e oltre 1.000 dipendenti
  • Terminali per impronte Realtime T502 (15 dispositivi in totale)
  • I dispositivi scrivono in un database SQL Server locale
  • La conformità HIPAA richiede l'elaborazione dei dati on-premises
  • Nessun dispositivo biometrico può accedere a internet (politica di sicurezza)
  • È necessaria un'integrazione con il sistema di gestione del personale dell'ospedale

Infrastruttura:

  • Tutti i dispositivi sulla rete interna dell'ospedale (172.16.x.x)
  • Database SQL Server 2019 nel data center dell'ospedale (172.16.10.50)
  • I dispositivi scrivono le presenze in una tabella del database
  • Server applicativo con accesso a internet per l'integrazione cloud (172.16.20.100)
  • Requisito di sovranità dei dati: i dati biometrici non lasciano mai la struttura

Distribuzione:

  • Modalità: Hybrid Modalità D (servizio locale verso database)
  • Intermedio: server applicativo con Cams Local Service in esecuzione
  • Accesso al database: il servizio legge da SQL Server ogni 30 secondi
  • Nessun controllo dei dispositivi: il servizio legge soltanto, non può gestire i dispositivi

Topologia di rete:

Rete interna dell'ospedale (172.16.x.x)
    |
    |- Dispositivi biometrici (15 dispositivi, vari edifici)
    |    ↓ [Scrivono le presenze in SQL Server]
    |
    |- SQL Server: 172.16.10.50
    |    ↑ [Il servizio legge la tabella delle presenze]
    |
    |- Server applicativo: 172.16.20.100 (dispone di internet)
         ↓ [HTTPS verso il cloud]
         |
Internet → Cloud API → Sistema di gestione del personale

Interrogazione del database:

-- Il servizio viene eseguito ogni 30 secondi
SELECT 
    PunchID, EmployeeID, PunchTime, DeviceID, VerifyMode
FROM AttendanceDB.dbo.PunchLog
WHERE SyncStatus = 'Pending'
ORDER BY PunchTime ASC;

-- Dopo l'invio riuscito al cloud
UPDATE AttendanceDB.dbo.PunchLog
SET SyncStatus = 'Synced', SyncTime = GETDATE()
WHERE PunchID IN (...);

Flusso dei dati:

7:00:00 - L'infermiere scansiona l'impronta sul dispositivo dell'Edificio A
7:00:00,5 - Il dispositivo scrive nella tabella delle presenze di SQL Server
7:00:15 - Il Local Service interroga il database e trova il nuovo record
7:00:16 - Il servizio invia la transazione al cloud
7:00:17 - Il cloud attiva il webhook verso il sistema del personale
7:00:18 - Il sistema del personale riceve la presenza
Latenza: circa 18 secondi dalla scansione al sistema

Conformità HIPAA mantenuta:

  • I template biometrici non lasciano mai la rete dell'ospedale (memorizzati solo sui dispositivi)
  • Solo le transazioni di presenza (timestamp, ID dipendente) vengono trasmesse al cloud
  • Nessun PHI (Protected Health Information) nei dati di presenza
  • I dispositivi sono isolati da internet (non possono essere gestiti da remoto)
  • I log di accesso al database vengono conservati per la traccia di audit

Limitazione accettata:

  • Nessuna funzionalità di gestione utenti (gli utenti vengono gestiti dall'interfaccia locale del dispositivo)
  • Nessuna configurazione remota dei dispositivi
  • Solo flusso dei dati delle transazioni (accettabile per i requisiti dell'ospedale)

Benefici ottenuti:

  • Piena conformità alle politiche di sicurezza dei dati sanitari
  • Integrazione con il sistema cloud per la gestione del personale senza violazioni delle politiche
  • Funziona con l'infrastruttura di database esistente
  • Nessuna modifica alla distribuzione dei dispositivi o ai flussi di lavoro degli utenti
  • Traccia di audit di tutti gli eventi di sincronizzazione dei dati

Scenario 5: installazione governativa, Hybrid Modalità C (sicurezza massima)

Profilo dell'organizzazione:

  • Struttura di un appaltatore della difesa con aree classificate
  • 50 dipendenti con nulla osta di sicurezza
  • Lettori di impronte Morpho MSO 1300 ai punti di controllo accessi
  • Struttura su rete isolata (requisiti SCIF - Sensitive Compartmented Information Facility)
  • Nessun dispositivo connesso a internet ammesso nelle aree sicure
  • È necessaria l'integrazione con il sistema di gestione degli appaltatori

Infrastruttura:

  • Rete dell'area sicura: 10.20.30.x (completamente isolata, nessuna connettività esterna)
  • Rete amministrativa: 10.50.60.x (accesso limitato a internet per i sistemi approvati)
  • Separazione fisica tra le reti imposta dalla politica di sicurezza
  • Data diode unidirezionale dalla rete sicura a quella amministrativa (valutato e scartato: il caso d'uso richiede una comunicazione bidirezionale)
  • Server dual-homed: unico sistema autorizzato a collegare le reti

Distribuzione:

  • Modalità: Hybrid Modalità C (servizio locale verso hardware)
  • Intermedio: server Windows rinforzato con due schede di rete (certificato per l'operatività tra domini)
  • Nulla osta di sicurezza: il server si trova fisicamente in una sala ad accesso controllato
  • Log di audit: tutti i trasferimenti di dati vengono registrati per la conformità di sicurezza

Architettura di rete:

Rete dell'area sicura (10.20.30.x - NESSUN INTERNET)
    |
    |- Punto di controllo accessi 1: 10.20.30.101
    |- Punto di controllo accessi 2: 10.20.30.102
    |- Punto di controllo accessi 3: 10.20.30.103
    |- NIC 1 del server dual-homed: 10.20.30.200
          |
          |- (Server fisico nella sala di controllo sicura)
          |
    NIC 2 del server dual-homed: 10.50.60.50
    |
Rete amministrativa (10.50.60.x - INTERNET LIMITATO)
    |
Internet (tramite gateway di sicurezza) → Cloud API → Sistema di gestione degli appaltatori

Controlli di sicurezza:

  • Il Local Service viene eseguito con permessi limitati (non può accedere all'area sicura oltre ai dispositivi definiti)
  • Tutti i trasferimenti di dati vengono registrati in un SIEM (Security Information and Event Management)
  • I template biometrici non vengono mai trasmessi (restano sui dispositivi della rete sicura)
  • Solo i dati di presenza non classificati (timestamp, numero del badge) attraversano il confine di rete
  • Audit di sicurezza mensili dei log di trasferimento dei dati
  • La password dell'account di servizio viene ruotata ogni trimestre

Flusso dei dati con registrazione di sicurezza:

8:00:00 - Il dipendente passa il badge al Punto di accesso 1 (verifica dell'impronta)
8:00:00,5 - Il dispositivo memorizza la transazione sulla rete sicura
8:00:15 - Il servizio interroga il dispositivo tramite la NIC sicura (10.20.30.200)
              [LOG DI AUDIT: il servizio ha acceduto al dispositivo 10.20.30.101]
8:00:15,5 - Il servizio riceve i dati della transazione
              [LOG DI AUDIT: dati recuperati: Badge 1234, Ora 08:00:00]
8:00:16 - Il servizio sanifica i dati (rimuove eventuali campi potenzialmente sensibili)
8:00:16,5 - Il servizio invia al cloud tramite la NIC amministrativa (10.50.60.50)
              [LOG DI AUDIT: dati trasmessi alla cloud API]
8:00:17 - La cloud API riceve e attiva il webhook
8:00:18 - Il sistema di gestione degli appaltatori riceve la presenza
              [LOG DI AUDIT: consegna del webhook confermata]

Benefici ottenuti:

  • Piena conformità ai requisiti di sicurezza SCIF
  • I dati biometrici restano sulla rete sicura isolata
  • Solo il server dual-homed approvato collega le reti
  • Traccia di audit completa per la conformità di sicurezza
  • Sistema di controllo accessi integrato con il sistema di gestione degli appaltatori senza compromettere la postura di sicurezza

Risposta agli incidenti di sicurezza: se il team di sicurezza rileva un'anomalia:

  1. Il servizio può essere disattivato immediatamente tramite la rete amministrativa
  2. I log di audit vengono esaminati per identificare i dati consultati o trasmessi
  3. I dispositivi dell'area sicura continuano a funzionare in modo autonomo (autenticazione locale)
  4. L'indagine viene completata prima della riattivazione del servizio

Parole chiave e concetti ottimizzati per la SEO

Questo articolo tratta soluzioni per:

Integrazione dei dispositivi biometrici: API per sistemi di rilevazione presenze tramite impronta, integrazione del riconoscimento facciale, connettività di scanner dell'iride, integrazione cloud dei lettori di vene palmari, API biometrica multimodale, integrazione dei sistemi di controllo accessi, API per dispositivi di rilevazione presenze, connettività cloud dei dispositivi biometrici, integrazione API per macchine di presenza, API per orologi timbratori biometrici

Produttori di dispositivi: integrazione API ZKTeco, integrazione cloud Suprema BioStar, connettività dei dispositivi Anviz, API di presenze eSSL Matrix, integrazione Realtime Startek, API di controllo accessi Virdi, API per impronte Nitgen, integrazione Morpho IDEMIA, connettività dei dispositivi Mantra, API Secugen, integrazione presenze Hikvision, integrazione Biomax, integrazione hardware biometrico

Sfide di integrazione: soluzione al vendor lock-in, compatibilità con protocolli proprietari, connettività cloud per dispositivi legacy, integrazione biometrica su reti air-gapped, integrazione di dispositivi con restrizioni firewall, sistema di presenze su rete isolata, interoperabilità dei dispositivi biometrici, integrazione biometrica multi-fornitore

Metodi di distribuzione: API biometrica cloud, integrazione biometrica on-premises, distribuzione cloud ibrida, edge computing per la biometria, connettore biometrico con servizio locale, integrazione delle presenze a livello di database, integrazione biometrica basata su webhook, API per le presenze in tempo reale

Architetture di rete: sistemi biometrici air-gapped, distribuzione biometrica in DMZ, integrazione delle presenze tramite VPN, connettività dei dispositivi con proxy restrittivi, integrazione biometrica dietro NAT e firewall, distribuzione su server dual-homed, soluzione biometrica su rete isolata

Conformità e sicurezza: integrazione biometrica conforme HIPAA, sistema di presenze PCI-DSS, soluzione biometrica per la sovranità dei dati, controllo accessi conforme SCIF, integrazione delle presenze con log di audit, architettura biometrica zero-trust, trasmissione sicura dei dati biometrici

Applicazioni aziendali: integrazione biometrica con HRMS, connettore ERP per le presenze, API biometrica per Workday, presenze SAP SuccessFactors, integrazione biometrica Oracle HCM, connettore per sistemi paghe, integrazione della gestione della forza lavoro, integrazione API per il tracciamento del tempo

Soluzioni per settore: presenze in stabilimento, integrazione biometrica per catene di negozi, controllo accessi in sanità, biometria per strutture governative, presenze negli istituti scolastici, gestione presenze BPO, integrazione per magazzini logistici, tracciamento orari nell'ospitalità

Funzionalità tecniche: webhook delle presenze in tempo reale, sincronizzazione dei template biometrici, registrazione remota degli utenti, API di configurazione dei dispositivi, gestione multi-dispositivo, accodamento dei dati offline, sincronizzazione automatica, recupero dei dati di presenza

Domande frequenti (FAQ)

D: Come faccio a sapere se i miei dispositivi supportano Native Push o richiedono Hybrid?

R: Per i dispositivi prodotti da Cams Biometrics, Native Push è integrato e pronto all'uso. Per i dispositivi di terze parti (ZKTeco, Suprema, Anviz, ecc.), visitare developer.camsbiometrics.com per eseguire la verifica di compatibilità. Inserire il modello e il numero di serie del dispositivo: il sistema testerà i protocolli di comunicazione. Se la verifica ha esito positivo, il dispositivo supporta Native Push. Se la verifica fallisce o mostra errori, è richiesta la distribuzione Hybrid.

D: È possibile combinare Native Push e Hybrid nella stessa organizzazione?

R: Sì. Le organizzazioni usano comunemente Native Push per i dispositivi moderni compatibili e la distribuzione Hybrid per i dispositivi legacy o non compatibili. Il Biometric Gateway supporta distribuzioni miste, inviando i webhook in formato uniforme indipendentemente dalla modalità di distribuzione sottostante. Il codice di integrazione del vostro HRMS o ERP non deve sapere quale modalità di distribuzione utilizza ciascun dispositivo.

D: Cosa succede ai dati di presenza se la connettività internet viene persa?

R:

  • Native Push: i dispositivi accodano le transazioni nella memoria interna (in genere 50.000-100.000 record). Quando internet torna disponibile, i dispositivi inviano automaticamente al cloud tutti i dati accodati.
  • Modalità Hybrid: il computer intermedio accoda localmente le transazioni. Quando la connessione internet del computer torna disponibile, invia automaticamente al cloud i dati accodati. Nota: nelle modalità Hybrid il computer deve poter raggiungere i dispositivi per raccogliere le transazioni durante il periodo offline.

D: I dipendenti possono registrare le biometrie da remoto senza recarsi al dispositivo?

R:

  • Native Push: sì. I template biometrici possono essere acquisiti in qualsiasi luogo e caricati tramite API. Il cloud invia i template ai dispositivi di destinazione, consentendo la registrazione remota.
  • Modalità Hybrid: no. I dipendenti devono recarsi fisicamente al dispositivo biometrico per registrare localmente impronte, volti o iridi. Il sistema può creare i record utente, ma l'acquisizione biometrica deve avvenire sul dispositivo.

D: Perché nella distribuzione Hybrid c'è un ritardo di 30 secondi?

R: La distribuzione Hybrid utilizza un'architettura a polling. Il computer intermedio o il servizio controlla i dispositivi ogni 30 secondi chiedendo "ci sono nuove transazioni?". Questo intervallo bilancia prestazioni quasi in tempo reale ed efficienza di rete. Un polling più rapido (ad esempio ogni 5 secondi) consuma più banda e risorse del dispositivo con un beneficio minimo per i tipici casi di rilevazione presenze. L'intervallo di 30 secondi può essere personalizzato se requisiti specifici lo richiedono.

D: Qual è la differenza tra la Modalità A e la Modalità C nella distribuzione Hybrid?

R: Entrambe si collegano all'hardware dei dispositivi, ma differiscono per i requisiti di rete:

  • Modalità A (Port Forwarding): richiede la configurazione del router/firewall per inoltrare le porte. Si usa quando il computer intermedio e i dispositivi si trovano su segmenti di rete o sottoreti diversi.
  • Modalità C (Servizio locale): non richiede port forwarding. Si usa quando il computer intermedio e i dispositivi si trovano sulla stessa rete locale oppure quando il port forwarding non è consentito dalla politica di rete.

Scegliere la Modalità A quando il port forwarding è disponibile e i dispositivi si trovano su reti diverse. Scegliere la Modalità C quando tutto si trova sulla stessa rete locale o quando la politica di rete vieta il port forwarding.

D: Le Modalità Hybrid B o D possono essere usate per la gestione degli utenti e la configurazione dei dispositivi?

R: No. Le Modalità B e D si integrano a livello di database, fornendo solo il flusso dei dati delle transazioni. Non possono inviare comandi ai dispositivi né gestire gli utenti. La registrazione degli utenti e la configurazione dei dispositivi devono essere eseguite tramite l'interfaccia locale del dispositivo o tramite il software del produttore del dispositivo. Queste modalità sono adatte quando sono necessari solo i dati delle transazioni di presenza e non è richiesto il controllo del dispositivo.

D: Quale larghezza di banda è richiesta per la connettività dei dispositivi biometrici?

R:

  • Native Push: 10-50 Kbps per dispositivo. Una tipica transazione di presenza occupa 1-2 KB. Anche le distribuzioni di grandi dimensioni (100 dispositivi) richiedono una banda minima (< 5 Mbps in totale).
  • Modalità Hybrid: la connessione computer-cloud richiede da 100 Kbps a 1 Mbps a seconda del numero di dispositivi. La banda dispositivo-computer dipende dal protocollo di comunicazione (di solito minima).

Le normali connessioni internet d'ufficio supportano facilmente centinaia di dispositivi.

D: Come gestisce il sistema la sincronizzazione dell'orologio e i fusi orari?

R:

  • Tutte le transazioni di presenza includono timestamp dell'ora locale del dispositivo
  • La cloud API accetta i timestamp e li converte in UTC per la memorizzazione
  • I webhook inviati alle applicazioni partner includono sia l'UTC sia l'ora locale del dispositivo
  • La configurazione del fuso orario viene gestita tramite API per le distribuzioni multi-sede
  • Si consiglia la sincronizzazione NTP (Network Time Protocol) per garantire la precisione dei dispositivi

D: Cosa succede se il computer intermedio si guasta in una distribuzione Hybrid?

R:

  • I dispositivi biometrici continuano a funzionare normalmente, registrando localmente le presenze
  • I dispositivi memorizzano le transazioni nella memoria locale
  • Quando viene installato un nuovo computer intermedio (o il computer guasto viene riparato):
    • Il computer interroga i dispositivi
    • I dispositivi forniscono tutte le transazioni memorizzate
    • Il computer invia al cloud i dati accumulati
    • Nessuna perdita di dati (entro i limiti della capacità di memoria del dispositivo)

Raccomandazione: monitorare il tempo di attività del computer intermedio e prevedere backup/ridondanza per le distribuzioni critiche.

D: Lo stesso template biometrico può essere usato su più dispositivi?

R:

  • Native Push: sì. Si carica il template biometrico una sola volta tramite API e il cloud lo distribuisce a tutti i dispositivi designati. Registrazione unica, autenticazione multi-dispositivo.
  • Modalità Hybrid: nessuna distribuzione automatica. Il dipendente deve registrarsi separatamente su ogni dispositivo, oppure l'organizzazione deve copiare manualmente i template tra i dispositivi tramite gli strumenti del produttore.

D: Come viene gestita la sicurezza dei dati durante la trasmissione?

R: Tutte le modalità utilizzano la crittografia HTTPS (TLS 1.2+) per la comunicazione con il cloud:

  • Native Push: comunicazione cifrata tra dispositivo e cloud
  • Modalità Hybrid: comunicazione cifrata tra computer e cloud
  • Consegna dei webhook alle applicazioni partner: HTTPS consigliato (configurabile)
  • Autenticazione API: firma basata su chiave con convalida della richiesta
  • Template biometrici: cifrati a riposo sui dispositivi, cifrati in transito se trasmessi

D: È possibile accedere ai dati storici di presenza?

R:

  • Native Push: sì, i record storici di presenza possono essere interrogati tramite API con filtri per intervallo di date, dipendente e dispositivo
  • Modalità Hybrid: i dati storici sono accessibili solo tramite webhook (consegna in tempo reale man mano che avvengono le transazioni). Le applicazioni partner dovrebbero memorizzare i dati ricevuti tramite webhook per l'accesso storico.

D: Quali funzioni di monitoraggio e diagnostica dei dispositivi sono disponibili?

R:

  • Native Push: stato completo del dispositivo disponibile (online/offline, utilizzo della memoria, versione del firmware, log degli errori, ora dell'ultima comunicazione, metriche di salute del dispositivo)
  • Modalità Hybrid A/C: stato limitato del dispositivo (ora dell'ultimo polling, numero di transazioni, stato di connettività di base)
  • Modalità Hybrid B/D: nessuna diagnostica del dispositivo (solo integrazione con il database)

Native Push offre capacità complete di monitoraggio e risoluzione dei problemi da remoto.

Supporto tecnico e assistenza all'implementazione

Domande sull'architettura di distribuzione, sulla compatibilità dei dispositivi o sulla pianificazione dell'integrazione? Pubblicate i dettagli del vostro scenario specifico in questa discussione del forum:

Includete nella vostra domanda:

  • Produttore e numeri di modello dei dispositivi
  • Topologia di rete attuale (accesso a internet, regole del firewall, reti isolate)
  • Requisiti di integrazione (tempo reale o latenza di 30 secondi accettabile, controllo del dispositivo necessario o solo flusso delle transazioni)
  • Vincoli di conformità o di sicurezza (requisiti air-gapped, sovranità dei dati, ecc.)
  • Numero di dispositivi e di sedi

Il team tecnico di Cams Biometrics monitora questo forum ogni giorno e fornisce raccomandazioni specifiche in base alla vostra infrastruttura e ai vostri requisiti.

Per la verifica di compatibilità dei dispositivi, visitate developer.camsbiometrics.com per testare i vostri dispositivi.

Per la documentazione dettagliata delle API, visitate la documentazione della Biometric Web API.


The Biometric Gateway | One API. Any Device. Any Network. Any ERP.

Architettura adattiva. Compatibilità universale. Nessun vincolo di fornitore.

Was this article helpful?