Support Hub/Learn & Insights/De SDK van uw leverancier werkt alleen op Windows, nog…
Translated from the English article and reviewed by a person. Read the English original
Article

De SDK van uw leverancier werkt alleen op Windows, nog steeds in dit AI-tijdperk?

De SDK van uw leverancier werkt alleen op Windows, nog steeds in dit AI-tijdperk?

Als u dit leest, heeft uw team waarschijnlijk al gezegd wat hier staat. Uw biometrische hardware werkt prima. Het apparaat doet precies wat het moet doen. Maar de SDK die uw fabrikant heeft verspreid om ermee te communiceren, is een gecompileerde Windows DLL, vereist een specifieke Visual C++ runtime, draait niet in een Docker-container, en uw ontwikkelaars werken op Mac of Linux. Het apparaat is niet het probleem. De SDK is het probleem. Dit artikel legt precies uit waarom dat gebeurt, waarom elke workaround die uw team heeft geprobeerd uiteindelijk faalt, en hoe het architecturale alternatief eruitziet.

 

De klachten zijn overal hetzelfde binnen elk engineeringteam

De details verschillen, maar het patroon is altijd hetzelfde. Een organisatie integreert biometrische hardware, ontdekt de SDK-beperkingen laat in het proces en besteedt veel engineeringtijd aan het omzeilen van een probleem dat niet zou mogen bestaan. Dit zijn in de praktijk de klachten.

Wat engineeringteams altijd zeggen
„De SDK wordt alleen geleverd als een Windows DLL. Onze hele backend draait op Linux. We moesten een aparte Windows-VM opzetten om alleen de biometrische integratie te draaien.”
„We kunnen het niet in een container plaatsen. Docker is uitgesloten. Kubernetes is uitgesloten. Elke deployment is een handmatig proces op een machine die niet vervangen kan worden zonder de SDK opnieuw te installeren en een nieuwe licentie aan te vragen.”
„Uw ontwikkelaars werken allemaal op Mac of Linux. Niemand kan de integratie lokaal draaien. Testen vereist een externe verbinding met de enige Windows-machine op kantoor waarop de SDK is geïnstalleerd.”
„De SDK vereist Visual C++ Redistributable 2010. De nieuwe ontwikkelaar heeft drie dagen besteed aan het opzetten van de omgeving voordat hij ook maar één regel integratiecode schreef.”
„We hebben de server bijgewerkt naar Windows Server 2022 en de SDK is gestopt met werken. De leverancier had twee weken nodig om een bijgewerkte versie uit te brengen, en in die periode hadden we geen aanwezigheidsgegevens.”
„Onze CI/CD-pipeline kan de biometrische integratie helemaal niet testen. Elke test is handmatig. Bij elke release van de integratie moet iemand fysiek aan de Windows-machine gaan zitten om die uit te voeren.”

Waarom biometrische SDK's alleen op Windows werken: de echte reden

Het is verleidelijk om aan te nemen dat communicatie met biometrische hardware zo complex is dat het Windows-specifieke systeem-API's vereist. Dat is niet zo. De echte reden dat biometrische SDK's alleen op Windows werken, is veel eenvoudiger en frustrerender: dat is de omgeving waarvoor de SDK oorspronkelijk is geschreven, en sindsdien heeft niemand geïnvesteerd in het veranderen ervan.

De meeste SDK's voor biometrische apparaten zijn in het begin van de jaren 2000 geschreven in C of C++, gericht op Windows als het dominante zakelijke desktopbesturingssysteem van die tijd. Het gecompileerde resultaat was een DLL, een Dynamic Link Library, een Windows-specifiek binair formaat. De communicatielogica, de functies die een TCP-verbinding met het apparaat openen, het binaire pakketformaat decoderen en gestructureerde gegevens teruggeven, werd in deze DLL gecompileerd en aan klanten verspreid.

Op dat moment was dit een verstandige keuze. Zakelijke software draaide op Windows. Servers draaiden op Windows. Ontwikkelaars werkten op Windows. Het DLL-formaat was in dat ecosysteem het standaardmechanisme voor herbruikbare gecompileerde code. Gezien de context was er niets mis aan deze keuze.

Het probleem is dat de context volledig veranderde, maar de SDK niet. Linux werd het dominante serverbesturingssysteem. Mac werd de dominante werkstation voor ontwikkelaars. Docker-containers werden de standaard deploymenteenheid. Cloud-native infrastructuur verving on-premises Windows-servers. Maar de biometrische SDK bleef een Windows-DLL, omdat het herschrijven ervoor voor cross-platform distributie een investering in engineering vergt die de hardwarefabrikant commercieel weinig reden heeft om te doen.

„De SDK was niet ontworpen om vijandig te zijn tegenover Linux of Mac. Hij was ontworpen voor een wereld waarin Linux en Mac niet de plek waren waar zakelijke software draaide. Die wereld bestaat niet meer. De SDK is achtergebleven.”

Wat een alleen-Windows-SDK blokkeert in een moderne stack

De gevolgen van een alleen-Windows-SDK reiken tot in elke laag van een moderne ontwikkel- en deploymentomgeving. Elk van de onderstaande blokkades is een echte beperking waar engineeringteams tegenaan lopen wanneer ze biometrische hardware willen integreren in een actuele softwarestack.

Docker en containerisatie
Docker-containers draaien op Linux. Een Windows-DLL kan niet in een Linux-container worden geladen. Elke service die de SDK moet aanroepen, moet draaien op een kale Windows-machine of een Windows-container, wat zwaarder, minder draagbaar en duurder is dan een standaard Linux-container.
Linux-cloudservers
AWS, Google Cloud en Azure bieden allemaal Linux-virtuele machines aan als standaard en goedkoopste serveroptie. Een Windows-VM speciaal voor de biometrische SDK-integratie kost meer en brengt operationele overhead met zich mee die niets met de biometrische functie zelf te maken heeft.
Mac-ontwikkelomgevingen
Ontwikkelaars kunnen de SDK niet laden, draaien of testen op hun lokale machines. Elke test van de integratie vereist toegang tot de ene Windows-machine waarop de SDK is geïnstalleerd. Lokale feedbackloops in de ontwikkeling, een basisvereiste voor productief engineeren, vallen voor dit deel van de stack weg.
CI/CD-pipelines
Geautomatiseerde testpipelines draaien op Linux-agents. Unit tests, integratietests en geautomatiseerde deploymentcontroles kunnen geen enkel codepad bevatten dat de SDK aanroept. De biometrische integratie staat volledig buiten het geautomatiseerde kwaliteitsborgingsproces.
Serverless functies
AWS Lambda, Google Cloud Functions en Azure Functions draaien op beheerde Linux-runtimes. Een serverless architectuur voor biometrische integratie is onmogelijk met een Windows-DLL. De volledige functie moet worden vervangen door een langlopend Windows-proces, wat het kosten- en operationele model van serverless teniet doet.
Kubernetes-orkestratie
Kubernetes beheert containers over clusters heen. Een service die afhankelijk is van een Windows-SDK kan niet deelnemen aan standaard Kubernetes-orkestratie zonder Windows-nodepools, die aanzienlijk complexer zijn om in te stellen en duurder om te draaien dan standaard Linux-nodepools.

De workarounds die teams bouwen en waarom ze uiteindelijk allemaal falen

Geconfronteerd met een alleen-Windows-SDK en een moderne stack bouwen engineeringteams workarounds. Elke workaround lost het directe probleem op, maar creëert een nieuwe structurele afhankelijkheid die later een ander probleem veroorzaakt.

01
De speciale Windows-VM
Er wordt een Windows-virtuele machine speciaal ingericht om de SDK te draaien. De service voor biometrische integratie draait op deze VM en biedt een interne API die de rest van de stack aanroept. Dit creëert een permanent single point of failure dat niet automatisch vervangen kan worden als het uitvalt, niet horizontaal geschaald kan worden, en als afzonderlijke infrastructuurverantwoordelijkheid gepatcht en onderhouden moet worden.
Faalt wanneer: de VM buiten gebruik wordt gesteld, gepatcht of gemigreerd wordt en de SDK breekt.
02
De COM-interop-wrapper
Er wordt een dunne wrapper in C# geschreven die de DLL laadt en deze blootstelt als een COM-object of een lokale HTTP-service die andere processen kunnen aanroepen. Dit voegt een taalgrens, een procesgrens en een nieuwe codebase toe die onderhouden moet worden. De ontwikkelaar die het heeft geschreven is meestal de enige die het begrijpt, en die vertrekt uiteindelijk.
Faalt wanneer: de SDK wordt bijgewerkt en de wrapper breekt, of de oorspronkelijke ontwikkelaar het team verlaat.
03
Wine op Linux
Wine is een compatibiliteitslaag waarmee sommige Windows-binaries op Linux kunnen draaien. Sommige teams proberen de DLL van de biometrische SDK onder Wine te draaien. Dit werkt af en toe voor eenvoudige SDK's en faalt onvoorspelbaar voor complexe SDK's die afhankelijk zijn van Windows-specifieke systeemaanroepen. Ondersteuning van de SDK-leverancier voor op Wine gebaseerde implementaties is er niet.
Faalt wanneer: de SDK een Windows-API aanroept die Wine niet implementeert, wat gebruikelijk is.
04
Windows Subsystem for Linux
WSL2 maakt het mogelijk dat Linux-processen op Windows draaien en andersom. Sommige teams installeren de SDK op een Windows-machine en stellen deze beschikbaar via een WSL2-brug. Dit is een hulpmiddel voor ontwikkelaars dat is omgebouwd tot productie-integratie. Het is niet ontworpen voor productieworkloads en introduceert instabiliteit bij de WSL-grens onder aanhoudende belasting.
Faalt wanneer: WSL-updates de brug breken of belasting instabiliteit veroorzaakt in de grenslaag.
05
Python ctypes of cffi
Met de ctypes-bibliotheek van Python kunnen C-functies uit een gecompileerde DLL rechtstreeks vanuit Python-code worden aangeroepen. Dit kan op Windows werken voor eenvoudige DLL-interfaces. Het vereist handmatig geheugenbeheer, zorgvuldige typetoewijzing en diepgaande kennis van de aanroepconventies van de DLL. Het is broos, in de meeste gevallen niet gedocumenteerd, en volledig onbruikbaar op niet-Windows-platforms.
Faalt wanneer: de DLL-interface wijzigt bij een update, wat het zal doen, zonder enige versiegarantie.
Het patroon dat alle workarounds gemeen hebben

Elke workaround accepteert de Windows-DLL als vaste beperking en bouwt eromheen. Geen van hen elimineert de beperking. Ze voegen allemaal complexiteit toe, meer onderhoudsoppervlak en nieuwe faalmodi. De juiste oplossing is niet een betere workaround bouwen. Het is de DLL-afhankelijkheid volledig elimineren.

Hoe de alternatieve architectuur eruitziet

De Windows-DLL bestaat omdat de hardwarefabrikant ontwikkelaars een manier wilde geven om met het propriëtaire binaire protocol van het apparaat te communiceren, zonder het protocol zelf bloot te leggen. De DLL is de abstractielaag tussen het binaire draadformaat en de code van de ontwikkelaar.

Die abstractielaag hoeft geen DLL te zijn. Het kan een HTTP-server zijn die JSON spreekt. De server verwerkt aan de ene kant het binaire protocol en stelt aan de andere kant een API beschikbaar. Ontwikkelaars roepen de API aan met standaard HTTP-clientbibliotheken die op elk platform, in elke taal, in elke container, via elke CI/CD-pipeline en op elke laptop van een ontwikkelaar draaien, ongeacht het besturingssysteem.

SDK-aanpak

Windows-DLL geïnstalleerd op een specifieke machine. Aangeroepen via taalspecifieke FFI of wrapper. Gebonden aan het besturingssysteem en de runtimeversie. Kan niet in een container worden geplaatst. Kan niet in CI worden getest. Breekt bij OS-updates. Eén SDK per merk apparaat.

Biometric Gateway-aanpak

Twee API-types, elk met een andere taak. De Callback API stuurt realtime gebeurtenissen van het apparaat naar uw server met nul latentie. De RESTful API accepteert opdrachten van uw server naar het apparaat met een uitvoeringstijd van ongeveer 15 seconden. Beide gebruiken JSON over HTTP/HTTPS met optionele AES-256-versleuteling. Elke taal, elk besturingssysteem, volledig containeriseerbaar, testbaar in elke CI-omgeving.

Geen van beide API-types vereist dat het apparaat verandert. Het apparaat spreekt nog steeds zijn propriëtaire binaire protocol. De Biometric Gateway staat tussen uw apparaten en uw applicatie en verzorgt intern alle protocolvertaling. De Protocol Engine beheert veilige authenticatieverwerking, logging van datatransacties, protocolvertaling en een offline cache en wachtrij voor wanneer apparaten tijdelijk niet bereikbaar zijn. De Gestandaardiseerde API-laag verzorgt identiteitsbeheer, AI- en MCP-integratie, het doorsturen van callbacks, REST-opdrachtroutering en gegevensnormalisatie over alle ondersteunde apparaatmerken heen.

Wat er verandert voor uw ontwikkelteam

Wanneer de SDK wordt vervangen door een API, zijn de praktische veranderingen in uw ontwikkelworkflow aanzienlijk. Het zijn geen geleidelijke verbeteringen. Het is de eliminatie van hele categorieën wrijving waar uw team aan gewend is geraakt.

Ontwikkeltaak Met Windows SDK Met API
Installatie van de omgeving voor nieuwe ontwikkelaars Uren tot dagen, Windows-VM + SDK-installatie + licentie + runtime-afhankelijkheden Minuten, voeg een API-basis-URL en authenticatietoken toe aan omgevingsvariabelen
Lokale ontwikkeling en testen Vereist externe toegang tot de Windows-machine met de SDK Werkt op elke laptop, elk besturingssysteem, met elke HTTP-clienttool
Integratie in CI/CD-pipeline Niet mogelijk op standaard Linux-agents Standaard HTTP-aanroepen, werkt in elke CI-omgeving
Gecontaineriseerde deployment Vereist Windows-container of aparte VM Elke Linux-container, elke grootte, volledig te orkestreren
Een tweede apparaatmerk toevoegen Nieuwe SDK, nieuwe DLL, nieuwe wrapper, nieuwe documentatie Hetzelfde Callback- en RESTful API-oppervlak, ongeacht het merk
Een mislukte bewerking debuggen Binaire protocollogs, vaak ongedocumenteerd Standaard HTTP-responscodes en JSON-foutbodies
Impact van OS- of runtime-update Kan SDK-compatibiliteit breken, vereist update van de leverancier Geen impact op clientcode

De twee API-types: wat uw ontwikkelaar daadwerkelijk schrijft

Om het verschil concreet te maken: hieronder ziet u hoe de twee API-types in de praktijk werken. De RESTful API wordt door uw server aangeroepen om een opdracht naar het apparaat te sturen. De Callback API werkt andersom: de Gateway roept uw server aan om een realtime gebeurtenis door te sturen. Uw ontwikkelaar schrijft een ontvanger voor de ene en een aanroeper voor de andere. Beide gebruiken JSON over HTTP/HTTPS. Geen van beide vereist een DLL, een Windows-machine of een SDK-installatie.

Callback API, verzoek, verzonden naar uw server door de 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, antwoord, uw server moet dit terugsturen naar de Gateway
{ "status": "done" }

De API-aanroep wordt gedaan met elke HTTP-bibliotheek in elke taal: Python's requests, Node's fetch, Go's net/http, cURL in een shellscript. Het werkt identiek op een Mac-laptop, een Linux CI-runner, een Docker-container op Kubernetes en een serverless functie. De payload van de Callback API komt aan bij het webhook-eindpunt dat uw server beschikbaar stelt, in hetzelfde JSON-formaat, ongeacht welk apparaatmerk of invoertype de gebeurtenis heeft gegenereerd. Vingerafdruk, gezichtsherkenning, handpalmader, RFID-kaart, pincode, QR-code of barcode: de structuur die uw server ontvangt, is altijd hetzelfde. Geen DLL. Geen runtimeafhankelijkheid. Geen Windows-vereiste. Geen licentiebestand om te beheren.

Wat dit specifiek betekent voor uw team

Een ontwikkelaar die volgende week bij uw team komt, kan de repository klonen, de Gateway-inloggegevens toevoegen aan het omgevingsbestand en binnen enkele minuten na het begin van het werk de eerste succesvolle aanroep naar een biometrisch apparaat doen. Voor de RESTful API schrijven ze een standaard HTTP POST. Voor de Callback API schrijven ze een standaard HTTP-ontvanger. Geen van beide vereist een Windows-machine, een SDK-installatieprogramma, een licentiesleutel van de leverancier of kennis van binaire apparaatprotocollen. Ze integreren met de Gateway precies zoals ze met elke andere JSON-service in uw stack integreren.

Veelgestelde vragen

Betekent het vervangen van de SDK door een API dat we functionaliteit van het apparaat verliezen?
Cams Biometrics Gateway biedt 38 biometrische bewerkingen over beide API-types heen. De RESTful API verwerkt opdrachten die uw server naar het apparaat stuurt, zoals gebruikers toevoegen, records verwijderen, logs laden en biometrie registreren. De Callback API levert realtime gebeurtenissen van het apparaat naar uw server, inclusief aanwezigheidsregistraties via vingerafdruk-, gezichtsherkennings-, handpalmader-, RFID-kaart-, pincode-, QR-code- en barcode-invoer. In de meeste gevallen biedt de Gateway meer mogelijkheden dan een bepaalde SDK-versie van de fabrikant, omdat deze rechtstreeks met het apparaatprotocol werkt. Controleer de compatibiliteit voor uw specifieke apparaatmodel bij het Cams-supportteam voordat u migreert.
We hebben al een aanzienlijke wrapper rond de SDK gebouwd. Hoeveel daarvan moeten we weggooien?
De bedrijfslogica in uw wrapper, de regels over welke medewerkers welke toegangsniveaus krijgen, de koppeling tussen uw HRMS-ID's en de gebruikers-ID's van het apparaat, de foutafhandeling en de herhaallogica, dat alles is herbruikbaar. Wat u vervangt, is de laag die de DLL-functies aanroept. In plaats van SDK-functies aan te roepen, doet u HTTP-verzoeken. De logica daarboven blijft hetzelfde. In de meeste gevallen is de vervanging van de SDK een kleinere wijziging dan het van buitenaf lijkt.
Is een API minder betrouwbaar dan een directe SDK-verbinding?
Niet inherent. De Gateway onderhoudt een permanente verbinding met het apparaat en bevat een offline cache en wachtrij die bewerkingen bufferen wanneer een apparaat tijdelijk niet bereikbaar is. Gebeurtenissen gaan niet verloren bij onderbrekingen in de connectiviteit en worden naar uw Callback-eindpunt gestuurd zodra de verbinding is hersteld. De betrouwbaarheid van de apparaatverbinding wordt bepaald door de Gateway-infrastructuur, niet door of uw applicatie via HTTP of via DLL-aanroepen communiceert. Een goed beheerde gateway heeft een hogere beschikbaarheid dan de meeste teams bereiken met een zelfbeheerde SDK-installatie op één Windows-VM.
Hoe zit het met latentie? Voegt de extra netwerkhop merkbare vertraging toe?
Voor de meeste biometrische bewerkingen voegt de extra netwerkhop slechts enkele milliseconden toe. Aanwezigheidscallbacks worden in realtime geleverd doordat de gateway naar uw webhook-eindpunt pusht, dus het latentiemodel lijkt op dat van een directe SDK-verbinding die een gebeurtenis ontvangt. Bij schrijfbewerkingen, zoals het toevoegen van een gebruiker, wordt de totale responstijd bepaald door de verwerkingstijd van het apparaat zelf, die 1 tot 3 seconden bedraagt, ongeacht hoe de instructie is aangekomen. De HTTP-hop is niet het knelpunt.
Kunnen we de API vanuit onze bestaande Python- of Node.js-backend gebruiken zonder speciale clientbibliotheek?
Ja. De API gebruikt standaard HTTP met JSON-bodies. Elke HTTP-clientbibliotheek in elke taal werkt zonder aanpassing. U hebt geen speciale SDK, geen clientbibliotheek van de gatewayleverancier en geen taalspecifiek pakket nodig. Als u een HTTP POST-verzoek met een JSON-body kunt doen, kunt u de API aanroepen. Vanuit het perspectief van uw applicatie is dat het volledige integratieoppervlak.

Conclusie: het SDK-probleem heeft een eenvoudige oplossing

Een alleen-Windows biometrische SDK is geen vaststaand gegeven waar uw engineeringteam eeuwig omheen moet werken. Het is het gevolg van een distributiebeslissing die twee decennia geleden in een andere infrastructuur is genomen. Die beslissing kan worden vervangen door een gateway die de complexiteit van het binaire protocol opvangt en het apparaat via een standaard API beschikbaar stelt.

Wanneer die overgang plaatsvindt, wordt de speciale Windows-VM buiten gebruik gesteld. De CI/CD-pipeline krijgt de biometrische integratie weer terug. De nieuwe ontwikkelaar richt zijn lokale omgeving in minuten in. De Docker-container draait zonder speciale configuratie. De Mac-ontwikkelaars hoeven niet langer op de ene machine op kantoor met de geïnstalleerde SDK-licentie in te loggen. Dit zijn geen kleine verbeteringen in het werkgemak. Het is de eliminatie van een structurele beperking die al jaren de tijd en het geduld van uw engineeringteam op de proef stelt.

Cams Biometrics Gateway vervangt de Windows-SDK volledig. Het verbindt zich met uw biometrische apparaten van Cams, ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime, Biomax, Secugen, eSSL, Matrix en meer, via hun eigen protocollen, zonder dat ergens in uw infrastructuur een SDK-installatie nodig is. Het biedt 38 bewerkingen via twee API-types: een Callback API die realtime apparaatgebeurtenissen met nul latentie naar uw server stuurt, en een RESTful API die opdrachten van uw server naar het apparaat accepteert. Alle communicatie verloopt via JSON over HTTP/HTTPS met optionele AES-256-versleuteling. Native MCP-integratie betekent dat Claude, Gemini en ChatGPT biometrische bewerkingen rechtstreeks kunnen aanroepen. Offline cache en wachtrij verwerken connectiviteitsonderbrekingen automatisch. De Gateway werkt identiek, ongeacht of uw stack draait op Linux, Mac, Windows, Docker, Kubernetes of serverless functies. Geen DLL. Geen Visual C++ Redistributable. Geen aparte Windows-machine. Geen licentiebestand. Ontdek de volledige API op CamsBiometrics.com voor informatie over het migreren van uw bestaande SDK-integratie.

 

Was this article helpful?