Support Hub/Learn & Insights/Il fornitore del vostro SDK funziona solo su Windows,…
Translated from the English article and reviewed by a person. Read the English original
Article

Il fornitore del vostro SDK funziona solo su Windows, ancora in questo decennio dell'IA?

Il fornitore del vostro SDK funziona solo su Windows, ancora in questo decennio dell'IA?

Se state leggendo questo articolo, il vostro team probabilmente lo ha già detto. Il vostro hardware biometrico funziona bene. Il dispositivo fa esattamente ciò che deve fare. Ma l'SDK distribuito dal produttore per comunicare con il dispositivo è una DLL di Windows compilata, richiede uno specifico runtime di Visual C++, non può essere eseguito in un container Docker e i vostri sviluppatori usano Mac o Linux. Il problema non è il dispositivo. Il problema è l'SDK. Questo articolo spiega con precisione perché succede, perché ogni soluzione alternativa tentata dal vostro team alla fine fallisce e come si presenta l'alternativa architetturale.

 

Le lamentele sono le stesse in tutti i team di ingegneria

I dettagli variano, ma lo schema è sempre lo stesso. Un'organizzazione integra l'hardware biometrico, scopre i vincoli dell'SDK in una fase avanzata del processo e dedica un notevole tempo di ingegneria per aggirare un problema che non dovrebbe esistere. Ecco come suonano queste lamentele nella pratica.

Ciò che dicono i team di ingegneria, ogni volta
“L'SDK viene fornito solo come DLL di Windows. Tutto il nostro backend gira su Linux. Abbiamo dovuto avviare una macchina virtuale Windows dedicata solo per eseguire l'integrazione biometrica.”
“Non possiamo containerizzarlo. Docker è escluso. Kubernetes è escluso. Ogni distribuzione è un processo manuale su una macchina che non può essere sostituita senza reinstallare l'SDK e ottenere una nuova licenza.”
“I vostri sviluppatori usano tutti Mac o Linux. Nessuno può eseguire l'integrazione in locale. Il test richiede l'accesso remoto all'unica macchina Windows in ufficio con l'SDK installato.”
“L'SDK richiede Visual C++ Redistributable 2010. Il nuovo sviluppatore ha impiegato tre giorni per configurare l'ambiente prima di scrivere una sola riga di codice di integrazione.”
“Abbiamo aggiornato il server a Windows Server 2022 e l'SDK ha smesso di funzionare. Al fornitore sono occorse due settimane per rilasciare una versione aggiornata e durante quel periodo non abbiamo avuto dati sulle presenze.”
“La nostra pipeline CI/CD non può testare affatto l'integrazione biometrica. Ogni test è manuale. Ogni rilascio dell'integrazione richiede che qualcuno sieda fisicamente davanti alla macchina Windows ed esegua il test.”

Perché gli SDK biometrici funzionano solo su Windows: il vero motivo

È tentante supporre che la comunicazione con l'hardware biometrico sia così complessa da richiedere API di sistema specifiche di Windows. Non è così. Il vero motivo per cui gli SDK biometrici funzionano solo su Windows è molto più semplice e molto più frustrante: quello è l'ambiente per cui l'SDK è stato originariamente scritto e da allora nessuno ha investito nel cambiarlo.

La maggior parte degli SDK per dispositivi biometrici è stata scritta in C o C++ agli inizi degli anni 2000, puntando a Windows come sistema operativo desktop dominante per le aziende di quell'epoca. Il risultato della compilazione era una DLL, una Dynamic Link Library, che è un formato binario specifico di Windows. La logica di comunicazione, cioè le funzioni che aprono una connessione TCP con il dispositivo, decodificano il formato binario dei pacchetti e restituiscono dati strutturati, era compilata in questa DLL e distribuita ai clienti.

All'epoca era una scelta ragionevole. Il software aziendale girava su Windows. I server giravano su Windows. Gli sviluppatori usavano Windows. Il formato DLL era il meccanismo di distribuzione standard per il codice compilato riutilizzabile in quell'ecosistema. Nulla di questa scelta era sbagliato nel suo contesto.

Il problema è che il contesto è cambiato completamente e l'SDK no. Linux è diventato il sistema operativo dominante per i server. Mac è diventato la workstation dominante per gli sviluppatori. I container Docker sono diventati l'unità di distribuzione standard. L'infrastruttura cloud-native ha sostituito i server Windows on-premises. Ma l'SDK biometrico è rimasto una DLL di Windows, perché riscriverlo per una distribuzione multipiattaforma richiede un investimento ingegneristico che il produttore dell'hardware ha poco incentivo commerciale a fare.

“L'SDK non è stato progettato per essere ostile a Linux o Mac. È stato progettato per un mondo in cui Linux e Mac non erano dove girava il software aziendale. Quel mondo non esiste più. L'SDK è rimasto indietro.”

Cosa blocca l'SDK solo per Windows in uno stack moderno

Le implicazioni di un SDK solo per Windows si ripercuotono su ogni livello di una moderna configurazione di sviluppo e distribuzione. Ciascun blocco qui sotto rappresenta un vincolo reale che i team di ingegneria incontrano quando cercano di integrare l'hardware biometrico in uno stack software di ultima generazione.

Docker e containerizzazione
I container Docker girano su Linux. Una DLL di Windows non può essere caricata all'interno di un container Linux. Qualsiasi servizio che debba richiamare l'SDK deve girare su una macchina Windows fisica o su un container Windows, che è più pesante, meno portabile e più costoso da gestire rispetto a un normale container Linux.
Server cloud Linux
AWS, Google Cloud e Azure offrono tutti macchine virtuali Linux come opzione server standard e più economica. Far girare una VM Windows dedicata solo a ospitare l'integrazione con l'SDK biometrico costa di più e aggiunge un carico operativo che non ha nulla a che fare con la funzione biometrica in sé.
Ambienti di sviluppo Mac
Gli sviluppatori non possono caricare, eseguire o testare l'SDK sulle proprie macchine locali. Ogni test dell'integrazione richiede l'accesso all'unica macchina Windows con l'SDK installato. I cicli di feedback dello sviluppo locale, un requisito di base dell'ingegneria produttiva, vengono eliminati per questa parte dello stack.
Pipeline CI/CD
Le pipeline di test automatizzate girano su agent Linux. Test unitari, test di integrazione e controlli di distribuzione automatizzati non possono includere alcun percorso di codice che richiami l'SDK. L'integrazione biometrica resta interamente fuori dal processo automatizzato di garanzia della qualità.
Funzioni serverless
AWS Lambda, Google Cloud Functions e Azure Functions girano su runtime Linux gestiti. Un'architettura serverless per l'integrazione biometrica è impossibile con una DLL di Windows. L'intera funzione deve essere sostituita con un processo Windows di lunga durata, il che vanifica il modello di costi e di gestione operativa del serverless.
Orchestrazione con Kubernetes
Kubernetes gestisce i container all'interno dei cluster. Un servizio che dipende da un SDK di Windows non può partecipare alla normale orchestrazione Kubernetes senza node pool Windows, che sono molto più complessi da configurare e più costosi da gestire rispetto ai normali node pool Linux.

Le soluzioni alternative create dai team e perché alla fine falliscono tutte

Di fronte a un SDK solo per Windows e a uno stack moderno, i team di ingegneria costruiscono soluzioni alternative. Ognuna risolve il problema immediato, creando però una nuova dipendenza strutturale che causerà un problema diverso in seguito.

01
La macchina virtuale Windows dedicata
Viene predisposta una macchina virtuale Windows specificamente per eseguire l'SDK. Il servizio di integrazione biometrica gira su questa VM ed espone un'API interna che il resto dello stack richiama. Questo crea un single point of failure permanente che non può essere sostituito automaticamente in caso di guasto, non può essere scalato orizzontalmente e deve essere aggiornato e mantenuto come responsabilità infrastrutturale separata.
Fallisce quando: la VM viene dismessa, aggiornata o migrata e l'SDK si interrompe.
02
Il wrapper di interoperabilità COM
Viene scritto in C# un sottile wrapper che carica la DLL e la espone come oggetto COM o come servizio HTTP locale che altri processi possono richiamare. Questo aggiunge un confine di linguaggio, un confine di processo e una nuova base di codice che deve essere mantenuta. Lo sviluppatore che l'ha scritto è di solito l'unica persona che lo capisce e, alla fine, lascia l'azienda.
Fallisce quando: l'SDK viene aggiornato e il wrapper si rompe, oppure lo sviluppatore originale lascia il team.
03
Wine su Linux
Wine è un livello di compatibilità che consente ad alcuni binari di Windows di girare su Linux. Alcuni team tentano di eseguire la DLL dell'SDK biometrico sotto Wine. Funziona in modo intermittente per SDK semplici e fallisce in modo imprevedibile per quelli complessi che si basano su chiamate di sistema specifiche di Windows. Il supporto del fornitore dell'SDK per le distribuzioni basate su Wine è inesistente.
Fallisce quando: l'SDK chiama un'API di Windows che Wine non implementa, evento comune.
04
Windows Subsystem for Linux
WSL2 consente ai processi Linux di girare su Windows e viceversa. Alcuni team installano l'SDK su una macchina Windows e lo espongono tramite un bridge WSL2. Si tratta di uno strumento di comodità per sviluppatori riutilizzato come approccio di integrazione in produzione. Non è progettato per carichi di lavoro di produzione e introduce instabilità al confine WSL sotto carico prolungato.
Fallisce quando: gli aggiornamenti di WSL interrompono il bridge oppure il carico causa instabilità nello strato di confine.
05
Python ctypes o cffi
La libreria ctypes di Python consente di chiamare direttamente dal codice Python funzioni C di una DLL compilata. Può funzionare su Windows per interfacce DLL semplici. Richiede una gestione manuale della memoria, un'attenta mappatura dei tipi e una conoscenza approfondita delle convenzioni di chiamata della DLL. È fragile, nella maggior parte dei casi non documentata e completamente non portabile su qualsiasi piattaforma non Windows.
Fallisce quando: l'interfaccia della DLL cambia in un aggiornamento, cosa che accadrà, senza alcuna garanzia di versionamento.
Lo schema comune a tutte le soluzioni alternative

Ogni soluzione alternativa accetta la DLL di Windows come vincolo fisso e costruisce intorno ad essa. Nessuna elimina il vincolo. Tutte aggiungono complessità, aumentano la superficie di manutenzione e introducono nuove modalità di guasto. La soluzione corretta non è costruire una soluzione alternativa migliore, ma eliminare completamente la dipendenza dalla DLL.

Come si presenta l'architettura alternativa

La DLL di Windows esiste perché il produttore del dispositivo doveva offrire agli sviluppatori un modo per comunicare con il protocollo binario proprietario del dispositivo senza esporre il protocollo stesso. La DLL è il livello di astrazione tra il formato binario sul cavo e il codice dello sviluppatore.

Questo livello di astrazione non deve necessariamente essere una DLL. Può essere un server HTTP che parla JSON. Il server gestisce il protocollo binario da un lato ed espone un'API dall'altro. Gli sviluppatori richiamano l'API usando librerie client HTTP standard, presenti su ogni piattaforma, in ogni linguaggio, all'interno di ogni container, attraverso ogni pipeline CI/CD, su ogni laptop di sviluppo indipendentemente dal sistema operativo.

Approccio SDK

DLL di Windows installata su una macchina specifica. Richiamata tramite FFI o wrapper specifici per linguaggio. Legata al sistema operativo e alla versione del runtime. Non può essere containerizzata. Non può essere testata in CI. Si interrompe con gli aggiornamenti del sistema operativo. Un SDK per ogni marca di dispositivo.

Approccio Biometric Gateway

Due tipi di API, ciascuno con un compito diverso. La Callback API invia dal dispositivo al vostro server eventi in tempo reale, con latenza zero. La RESTful API accetta comandi dal vostro server verso il dispositivo con un tempo di esecuzione di circa 15 secondi. Entrambe usano JSON su HTTP/HTTPS con crittografia AES-256 opzionale. Qualsiasi linguaggio, qualsiasi sistema operativo, completamente containerizzabile, testabile in qualsiasi ambiente CI.

Nessuno dei due tipi di API richiede modifiche al dispositivo. Il dispositivo continua a parlare il suo protocollo binario proprietario. Il Biometric Gateway si colloca tra i dispositivi e la vostra applicazione, gestendo internamente tutta la traduzione del protocollo. Il suo Protocol Engine gestisce l'elaborazione sicura dell'autenticazione, il logging delle transazioni di dati, la traduzione del protocollo e la cache offline e la coda per i casi in cui i dispositivi sono temporaneamente non raggiungibili. Il suo Standardised API Layer gestisce la gestione delle identità, l'integrazione di AI e MCP, la distribuzione dei callback, l'instradamento dei comandi REST e la normalizzazione dei dati per tutte le marche di dispositivi supportate.

Cosa cambia per il vostro team di sviluppo

Quando l'SDK viene sostituito da un'API, i cambiamenti pratici nel flusso di lavoro di sviluppo sono significativi. Non sono miglioramenti incrementali. Sono l'eliminazione di intere categorie di attriti che il vostro team ha ormai normalizzato.

Attività di sviluppo Con SDK Windows Con API
Configurazione dell'ambiente di sviluppo per un nuovo sviluppatore Da ore a giorni, VM Windows + installazione SDK + licenza + dipendenze runtime Pochi minuti, aggiungere un URL base dell'API e un token di autenticazione alle variabili d'ambiente
Sviluppo e test in locale Richiede accesso remoto alla macchina Windows con l'SDK Funziona su qualsiasi laptop, con qualsiasi sistema operativo e con qualsiasi strumento client HTTP
Integrazione nella pipeline CI/CD Non possibile su agent Linux standard Chiamate HTTP standard, funziona in qualsiasi ambiente CI
Distribuzione containerizzata Richiede un container Windows o una VM dedicata Qualsiasi container Linux, di qualsiasi dimensione, completamente orchestrabile
Aggiunta di una seconda marca di dispositivi Nuovo SDK, nuova DLL, nuovo wrapper, nuova documentazione Stessa superficie di Callback API e RESTful API indipendentemente dalla marca
Debug di un'operazione non riuscita Log del protocollo binario, spesso non documentati Codici di risposta HTTP standard e corpi di errore JSON
Impatto di un aggiornamento del sistema operativo o del runtime Può compromettere la compatibilità dell'SDK, richiede un aggiornamento del fornitore Nessun impatto sul codice client

I due tipi di API: cosa scrive effettivamente il vostro sviluppatore

Per rendere concreto il confronto, ecco come funzionano nella pratica i due tipi di API. La RESTful API è richiamata dal vostro server per inviare un comando al dispositivo. La Callback API è il contrario: il Gateway richiama il vostro server per inviare un evento in tempo reale. Il vostro sviluppatore scrive un ricevitore per uno e un chiamante per l'altra. Entrambe usano JSON su HTTP/HTTPS. Nessuna delle due richiede una DLL, una macchina Windows o l'installazione di un SDK.

Callback API, richiesta, inviata al vostro server dal Gateway
{
  "RealTime": {
    "OperationID": "9nu1wak5616p",
    "LabelName": "Burj Khalifa",
    "SerialNumber": "ZHM11xxxxxxxx",
    "PunchLog": {
      "Type": "CheckOut",
      "Temperature": "36.8",
      "FaceMask": false,
      "InputType": "Fingerprint",
      "UserId": "2",
      "LogTime": "2020-09-17 07:48:22 GMT +0530"
    },
    "AuthToken": "COJJ7eiIPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 04:19:03 GMT +0000"
  }
}
Callback API, risposta, il vostro server deve restituirla al Gateway
{ "status": "done" }

La chiamata API viene effettuata con qualsiasi libreria HTTP in qualsiasi linguaggio: requests di Python, fetch di Node, net/http di Go, cURL in uno script shell. Funziona in modo identico su un laptop Mac, su un runner CI Linux, su un container Docker in Kubernetes e su una funzione serverless. Il payload della Callback API arriva all'endpoint webhook esposto dal vostro server, nello stesso formato JSON indipendentemente dalla marca del dispositivo o dal tipo di input che ha generato l'evento. Impronta digitale, riconoscimento facciale, vena del palmo, card RFID, PIN, codice QR o codice a barre: la struttura che riceve il vostro server è sempre la stessa. Nessuna DLL. Nessuna dipendenza da runtime. Nessun requisito di Windows. Nessun file di licenza da gestire.

Cosa significa questo per il vostro team in particolare

Uno sviluppatore che entra nel vostro team la settimana prossima può clonare il repository, aggiungere le credenziali del Gateway al proprio file di ambiente ed effettuare la prima chiamata andata a buon fine verso un dispositivo biometrico nel giro di pochi minuti dal momento in cui si siede alla postazione. Per la RESTful API scrive una normale POST HTTP. Per la Callback API scrive un normale ricevitore HTTP. Nessuna delle due richiede una macchina Windows, un programma di installazione dell'SDK, una chiave di licenza del fornitore o qualsiasi conoscenza dei protocolli binari dei dispositivi. Si integrano con il Gateway esattamente come si integrano con qualsiasi altro servizio JSON del vostro stack.

Domande frequenti

Sostituire l'SDK con un'API significa perdere qualche funzionalità del dispositivo?
Cams Biometrics Gateway espone 38 operazioni biometriche su entrambi i tipi di API. La RESTful API gestisce i comandi che il vostro server invia al dispositivo, come l'aggiunta di utenti, l'eliminazione di record, il caricamento dei log e la registrazione di dati biometrici. La Callback API consegna dal dispositivo al vostro server eventi in tempo reale, inclusi i timbrature di presenza provenienti da impronta digitale, riconoscimento facciale, vena del palmo, card RFID, PIN, codice QR e codice a barre. Nella maggior parte dei casi il Gateway offre più funzionalità di una specifica versione dell'SDK del produttore, perché lavora direttamente con il protocollo del dispositivo. Verificate la compatibilità per il vostro specifico modello di dispositivo con il team di supporto Cams prima della migrazione.
Abbiamo già costruito un wrapper significativo intorno all'SDK. Quanto di questo dobbiamo buttare via?
La logica di business del vostro wrapper, le regole su quali dipendenti ottengono quali livelli di accesso, la corrispondenza tra i vostri ID HRMS e gli ID utente del dispositivo, la gestione degli errori e la logica di retry: tutto questo è riutilizzabile. Ciò che viene sostituito è lo strato che chiama le funzioni della DLL. Invece di chiamare le funzioni dell'SDK, si effettuano richieste HTTP. La logica sopra questo strato resta invariata. Nella maggior parte dei casi la sostituzione dell'SDK è un cambiamento più limitato di quanto possa sembrare dall'esterno.
Un'API è meno affidabile di una connessione diretta tramite SDK?
Non intrinsecamente. Il Gateway mantiene una connessione persistente con il dispositivo e include una cache offline e una coda che memorizzano le operazioni quando un dispositivo è temporaneamente non raggiungibile. Gli eventi non vanno persi durante le interruzioni di connettività e vengono consegnati al vostro endpoint Callback quando la connessione viene ripristinata. L'affidabilità della connessione al dispositivo è determinata dall'infrastruttura del Gateway, non dal fatto che la vostra applicazione comunichi con esso tramite HTTP o tramite chiamate DLL. Un gateway ben gestito avrà una disponibilità superiore a quella che la maggior parte dei team ottiene con un'installazione autogestita dell'SDK su una singola VM Windows.
E la latenza? Il passaggio di rete aggiuntivo introduce un ritardo significativo?
Per la maggior parte delle operazioni biometriche il passaggio di rete aggiuntivo richiede pochi millisecondi. I callback di presenza vengono consegnati in tempo reale dal Gateway che li invia al vostro endpoint webhook, quindi il modello di latenza è simile a quello di una connessione diretta tramite SDK che riceve un evento. Per le operazioni di scrittura, come l'aggiunta di un utente, il tempo di andata e ritorno totale è dominato dal tempo di elaborazione del dispositivo, pari a 1-3 secondi, indipendentemente da come è arrivata l'istruzione. Il passaggio HTTP non è il collo di bottiglia.
Possiamo usare l'API dal nostro backend Python o Node.js esistente senza alcuna libreria client speciale?
Sì. L'API usa HTTP standard con corpi JSON. Qualsiasi libreria client HTTP, in qualsiasi linguaggio, funziona senza modifiche. Non serve un SDK speciale, una libreria client pubblicata dal fornitore del gateway o alcun pacchetto specifico per il linguaggio. Se riuscite a effettuare una richiesta HTTP POST con un corpo JSON, potete chiamare l'API. Dal punto di vista della vostra applicazione, questa è l'intera superficie di integrazione.

Conclusione: il problema dell'SDK ha una soluzione pulita

Un SDK biometrico solo per Windows non è un dato di fatto con cui il vostro team di ingegneria debba convivere per sempre. È la conseguenza di una decisione di distribuzione presa due decenni fa in un diverso panorama infrastrutturale. Quella decisione può essere superata da un gateway che assorbe la complessità del protocollo binario ed espone il dispositivo tramite un'API standard.

Quando questa transizione avviene, la VM Windows dedicata viene dismessa. La pipeline CI/CD recupera l'integrazione biometrica. Il nuovo sviluppatore configura il proprio ambiente locale in pochi minuti. Il container Docker gira senza configurazioni speciali. Gli sviluppatori Mac smettono di collegarsi da remoto all'unica macchina dell'ufficio che ha l'SDK installato. Non si tratta di piccoli miglioramenti di qualità della vita, ma dell'eliminazione di un vincolo strutturale che per anni ha pesato sul tempo e sulla pazienza del vostro team di ingegneria.

Cams Biometrics Gateway sostituisce completamente l'SDK di Windows. Si connette ai vostri dispositivi biometrici Cams, ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime, Biomax, Secugen, eSSL, Matrix e altri, usando i loro protocolli nativi, senza che sia richiesta l'installazione di alcun SDK in nessuna parte della vostra infrastruttura. Espone 38 operazioni su due tipi di API: una Callback API che invia eventi in tempo reale dal dispositivo al vostro server con latenza zero, e una RESTful API che accetta comandi dal vostro server verso il dispositivo. Tutta la comunicazione avviene in JSON su HTTP/HTTPS con crittografia AES-256 opzionale. L'integrazione MCP nativa consente a Claude, Gemini e ChatGPT di richiamare direttamente le operazioni biometriche. La cache offline e la coda gestiscono automaticamente le interruzioni di connettività. Il Gateway funziona in modo identico sia che il vostro stack giri su Linux, Mac, Windows, Docker, Kubernetes o funzioni serverless. Nessuna DLL. Nessun Visual C++ Redistributable. Nessuna macchina Windows dedicata. Nessun file di licenza. Esplorate l'API completa su CamsBiometrics.com per informazioni sulla migrazione della vostra integrazione SDK esistente.

 

Was this article helpful?