Support Hub/Learn & Insights/¿El SDK de su proveedor solo funciona en Windows, todavía…
Translated from the English article and reviewed by a person. Read the English original
Article

¿El SDK de su proveedor solo funciona en Windows, todavía en esta década de la IA?

¿El SDK de su proveedor solo funciona en Windows, todavía en esta década de la IA?

Si está leyendo esto, es probable que su equipo ya lo haya dicho. Su hardware biométrico funciona bien. El dispositivo hace exactamente lo que debe hacer. Pero el SDK que su fabricante distribuyó para comunicarse con él es una DLL compilada para Windows, requiere un entorno de ejecución específico de Visual C++, no se ejecuta en un contenedor Docker, y sus desarrolladores usan Mac o Linux. El dispositivo no es el problema. El problema es el SDK. Este artículo explica exactamente por qué ocurre esto, por qué fracasan con el tiempo todas las soluciones alternativas que su equipo ha probado y cómo es la alternativa arquitectónica.

 

Las quejas son las mismas en todos los equipos de ingeniería

Los detalles varían, pero el patrón siempre es el mismo. Una organización integra hardware biométrico, descubre las restricciones del SDK tarde en el proceso y dedica un tiempo considerable de ingeniería a sortear un problema que no debería existir. Así suenan estas quejas en la práctica.

Lo que dicen los equipos de ingeniería, siempre
“El SDK solo se distribuye como DLL de Windows. Todo nuestro backend funciona en Linux. Tuvimos que levantar una máquina virtual de Windows dedicada solo para ejecutar la integración biométrica.”
“No podemos ponerlo en un contenedor. Docker queda descartado. Kubernetes queda descartado. Cada despliegue es un proceso manual en una máquina que no puede reemplazarse sin reinstalar el SDK y obtener una nueva licencia.”
“Todos sus desarrolladores usan Mac o Linux. Nadie puede ejecutar la integración en local. Las pruebas requieren conectarse de forma remota a la única máquina Windows de la oficina que tiene instalado el SDK.”
“El SDK requiere Visual C++ Redistributable 2010. El nuevo desarrollador dedicó tres días a preparar el entorno antes de escribir una sola línea de código de integración.”
“Actualizamos el servidor a Windows Server 2022 y el SDK dejó de funcionar. El proveedor tardó dos semanas en publicar una versión actualizada y durante ese periodo no tuvimos datos de asistencia.”
“Nuestro pipeline de CI/CD no puede probar la integración biométrica. Todas las pruebas son manuales. Cada versión de la integración requiere que alguien se siente físicamente frente a la máquina Windows y la ejecute.”

Por qué los SDK biométricos solo funcionan en Windows: la razón real

Es tentador suponer que la comunicación con el hardware biométrico es tan compleja que requiere API del sistema específicas de Windows. Este no es el caso. La razón real por la que los SDK biométricos solo funcionan en Windows es mucho más sencilla y más frustrante: ese es el entorno para el que el SDK se escribió originalmente, y desde entonces nadie ha invertido en cambiarlo.

La mayoría de los SDK de dispositivos biométricos se escribieron en C o C++ a principios de los años 2000, orientados a Windows como el sistema operativo de escritorio empresarial dominante de la época. El resultado de la compilación era una DLL, una Dynamic Link Library (biblioteca de enlace dinámico), que es un formato binario específico de Windows. La lógica de comunicación, es decir, las funciones que abren una conexión TCP con el dispositivo, decodifican el formato de paquetes binarios y devuelven datos estructurados, se compilaba en esta DLL y se distribuía a los clientes.

En su momento, era una decisión razonable. El software empresarial se ejecutaba en Windows. Los servidores ejecutaban Windows. Los desarrolladores usaban Windows. El formato DLL era el mecanismo de distribución estándar para código compilado reutilizable en ese ecosistema. Nada de esta elección era incorrecto dado su contexto.

El problema es que el contexto cambió por completo y el SDK no. Linux se convirtió en el sistema operativo de servidor dominante. Mac se convirtió en la estación de trabajo de desarrollo dominante. Los contenedores Docker se convirtieron en la unidad de despliegue estándar. La infraestructura nativa de la nube reemplazó a los servidores Windows locales. Pero el SDK biométrico siguió siendo una DLL de Windows, porque reescribirlo para una distribución multiplataforma requiere una inversión en ingeniería que el fabricante del hardware tiene pocos incentivos comerciales para hacer.

“El SDK no se diseñó para ser hostil con Linux o Mac. Se diseñó para un mundo en el que Linux y Mac no eran donde se ejecutaba el software empresarial. Ese mundo ya no existe. El SDK se quedó atrás.”

Lo que bloquea un SDK solo para Windows en una pila moderna

Las implicaciones de un SDK solo para Windows se extienden a cada capa de una configuración moderna de desarrollo y despliegue. Cada obstáculo siguiente representa una restricción real con la que se encuentran los equipos de ingeniería cuando intentan integrar hardware biométrico en una pila de software actual.

Docker y contenedorización
Los contenedores Docker se ejecutan en Linux. Una DLL de Windows no puede cargarse dentro de un contenedor Linux. Cualquier servicio que necesite llamar al SDK debe ejecutarse en una máquina Windows física o en un contenedor Windows, que es más pesado, menos portable y más caro de ejecutar que un contenedor Linux estándar.
Servidores en la nube con Linux
AWS, Google Cloud y Azure ofrecen máquinas virtuales Linux como su opción de servidor estándar y más económica. Ejecutar una máquina virtual Windows específicamente para alojar la integración del SDK biométrico cuesta más y añade una carga operativa que no tiene relación con la función biométrica en sí.
Entornos de desarrollo en Mac
Los desarrolladores no pueden cargar, ejecutar ni probar el SDK en sus máquinas locales. Cada prueba de la integración requiere acceso a la única máquina Windows que tiene instalado el SDK. Los ciclos de retroalimentación del desarrollo local, un requisito básico de la ingeniería productiva, se eliminan para esta parte de la pila.
Pipelines de CI/CD
Los pipelines de pruebas automatizadas se ejecutan en agentes Linux. Las pruebas unitarias, las pruebas de integración y las verificaciones de despliegue automatizado no pueden incluir ninguna ruta de código que llame al SDK. La integración biométrica queda totalmente fuera del proceso automatizado de aseguramiento de calidad.
Funciones serverless
AWS Lambda, Google Cloud Functions y Azure Functions se ejecutan en entornos de ejecución Linux gestionados. Una arquitectura serverless para la integración biométrica es imposible con una DLL de Windows. Toda la función debe reemplazarse por un proceso Windows de larga duración, lo que anula el modelo de costes y de operación de serverless.
Orquestación con Kubernetes
Kubernetes gestiona contenedores en clústeres. Un servicio que depende de un SDK de Windows no puede participar en la orquestación estándar de Kubernetes sin pools de nodos Windows, que son bastante más complejos de configurar y más caros de ejecutar que los pools de nodos Linux estándar.

Las soluciones alternativas que crean los equipos y por qué todas acaban fallando

Ante un SDK solo para Windows y una pila moderna, los equipos de ingeniería crean soluciones alternativas. Cada una resuelve el problema inmediato, pero genera una nueva dependencia estructural que provocará otro problema más adelante.

01
La máquina virtual Windows dedicada
Se aprovisiona una máquina virtual Windows específicamente para ejecutar el SDK. El servicio de integración biométrica se ejecuta en esta máquina virtual y expone una API interna que el resto de la pila consume. Esto crea un punto único de fallo permanente que no puede reemplazarse automáticamente si cae, no puede escalarse horizontalmente y debe parchearse y mantenerse como una responsabilidad de infraestructura independiente.
Falla cuando: la máquina virtual se da de baja, se parchea o se migra y el SDK deja de funcionar.
02
El contenedor de interoperabilidad COM
Se escribe en C# un envoltorio ligero que carga la DLL y la expone como un objeto COM o como un servicio HTTP local al que otros procesos pueden llamar. Esto añade un límite de lenguaje, un límite de proceso y una nueva base de código que hay que mantener. El desarrollador que lo escribió suele ser la única persona que lo entiende y, con el tiempo, acaba marchándose.
Falla cuando: el SDK se actualiza y el envoltorio se rompe, o el desarrollador original abandona el equipo.
03
Wine en Linux
Wine es una capa de compatibilidad que permite ejecutar algunos binarios de Windows en Linux. Algunos equipos intentan ejecutar la DLL del SDK biométrico bajo Wine. Esto funciona de forma intermitente con SDK sencillos y falla de manera impredecible con los complejos que dependen de llamadas al sistema específicas de Windows. El proveedor del SDK no ofrece ningún soporte para despliegues basados en Wine.
Falla cuando: el SDK llama a una API de Windows que Wine no implementa, lo cual es habitual.
04
Subsistema de Windows para Linux
WSL2 permite ejecutar procesos Linux en Windows y viceversa. Algunos equipos instalan el SDK en una máquina Windows y lo exponen mediante un puente WSL2. Se trata de una herramienta de comodidad para desarrolladores reutilizada como enfoque de integración en producción. No está diseñada para cargas de trabajo de producción y introduce inestabilidad en el límite de WSL bajo carga sostenida.
Falla cuando: las actualizaciones de WSL rompen el puente o la carga provoca inestabilidad en la capa límite.
05
Python ctypes o cffi
La biblioteca ctypes de Python permite llamar directamente desde código Python a funciones C de una DLL compilada. Puede funcionar en Windows con interfaces DLL sencillas. Requiere gestión manual de memoria, un mapeo de tipos cuidadoso y un conocimiento profundo de las convenciones de llamada de la DLL. Es frágil, en la mayoría de los casos no está documentada y es completamente no portable a cualquier plataforma distinta de Windows.
Falla cuando: la interfaz de la DLL cambia en una actualización, como ocurrirá, sin ninguna garantía de versionado.
El patrón que comparten todas las soluciones alternativas

Cada solución alternativa acepta la DLL de Windows como una restricción fija y construye sobre ella. Ninguna elimina la restricción. Todas añaden complejidad, superficie de mantenimiento y nuevos modos de fallo. La solución correcta no es crear una mejor solución alternativa. Es eliminar por completo la dependencia de la DLL.

Cómo es la arquitectura alternativa

La DLL de Windows existe porque el fabricante del dispositivo necesitaba ofrecer a los desarrolladores una forma de comunicarse con el protocolo binario propietario del dispositivo sin exponer el protocolo en sí. La DLL es la capa de abstracción entre el formato binario de transmisión y el código del desarrollador.

Esa capa de abstracción no tiene por qué ser una DLL. Puede ser un servidor HTTP que hable JSON. El servidor gestiona el protocolo binario por un lado y expone una API por el otro. Los desarrolladores llaman a la API con bibliotecas cliente HTTP estándar que se ejecutan en cualquier plataforma, en cualquier lenguaje, dentro de cualquier contenedor, a través de cualquier pipeline de CI/CD, en cualquier portátil de desarrollo, independientemente del sistema operativo.

Enfoque con SDK

DLL de Windows instalada en una máquina específica. Se llama mediante FFI o envoltorio específico del lenguaje. Vinculada al sistema operativo y a la versión del entorno de ejecución. No puede contenerizarse. No puede probarse en CI. Se rompe con las actualizaciones del sistema operativo. Un SDK por marca de dispositivo.

Enfoque con Biometric Gateway

Dos tipos de API, cada una con una función distinta. La Callback API envía eventos en tiempo real desde el dispositivo a su servidor con latencia cero. La RESTful API acepta comandos de su servidor hacia el dispositivo con un tiempo de ejecución aproximado de 15 segundos. Ambas usan JSON sobre HTTP/HTTPS con cifrado AES-256 opcional. Cualquier lenguaje, cualquier sistema operativo, totalmente contenerizable y probable en cualquier entorno de CI.

Ninguno de los dos tipos de API requiere que el dispositivo cambie. El dispositivo sigue hablando su protocolo binario propietario. El Biometric Gateway se sitúa entre sus dispositivos y su aplicación, y gestiona internamente toda la traducción de protocolos. Su Protocol Engine (motor de protocolos) gestiona el procesamiento seguro de autenticación, el registro de transacciones de datos, la traducción de protocolos y la caché y cola sin conexión para cuando los dispositivos no son accesibles temporalmente. Su Standardised API Layer (capa de API estandarizada) gestiona la administración de identidades, la integración con IA y MCP, el envío de callbacks, el enrutamiento de comandos REST y la normalización de datos en todas las marcas de dispositivos compatibles.

Qué cambia para su equipo de desarrollo

Cuando el SDK se sustituye por una API, los cambios prácticos en el flujo de trabajo de desarrollo son significativos. No son mejoras incrementales. Son la eliminación de categorías completas de fricción que su equipo ha dado por normales.

Tarea de desarrollo Con SDK de Windows Con API
Configuración del entorno de desarrollo nuevo Horas o días: máquina virtual Windows + instalación del SDK + licencia + dependencias de runtime Minutos: añadir una URL base de la API y un token de autenticación a las variables de entorno
Desarrollo y pruebas en local Requiere acceso remoto a la máquina Windows con el SDK Funciona en cualquier portátil, con cualquier sistema operativo y con cualquier herramienta cliente HTTP
Integración en el pipeline de CI/CD No es posible en agentes Linux estándar Llamadas HTTP estándar, funciona en cualquier entorno de CI
Despliegue en contenedores Requiere un contenedor Windows o una máquina virtual dedicada Cualquier contenedor Linux, de cualquier tamaño, totalmente orquestable
Añadir una segunda marca de dispositivo Nuevo SDK, nueva DLL, nuevo envoltorio, nueva documentación La misma superficie de Callback API y RESTful API, sea cual sea la marca
Depuración de una operación fallida Registros de protocolo binario, a menudo sin documentar Códigos de respuesta HTTP estándar y cuerpos de error en JSON
Impacto de una actualización del sistema operativo o del runtime Puede romper la compatibilidad del SDK, requiere una actualización del proveedor Sin impacto en el código cliente

Los dos tipos de API: lo que escribe realmente su desarrollador

Para hacer concreto el contraste, a continuación se muestra cómo funcionan en la práctica los dos tipos de API. La RESTful API la llama su servidor para enviar un comando al dispositivo. La Callback API es lo contrario: el Gateway llama a su servidor para enviar un evento en tiempo real. Su desarrollador escribe un receptor para una y un emisor para la otra. Ambas usan JSON sobre HTTP/HTTPS. Ninguna requiere una DLL, una máquina Windows ni la instalación de ningún SDK.

Callback API, solicitud enviada a su servidor por el 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, respuesta: su servidor debe devolver esto al Gateway
{ "status": "done" }

La llamada a la API se hace con cualquier biblioteca HTTP en cualquier lenguaje: requests de Python, fetch de Node, net/http de Go, cURL en un script de shell. Funciona de forma idéntica en un portátil Mac, en un runner de CI Linux, en un contenedor Docker sobre Kubernetes y en una función serverless. El payload de la Callback API llega al endpoint de webhook que exponga su servidor, siempre en el mismo formato JSON, independientemente de la marca del dispositivo o del tipo de entrada que generó el evento. Huella dactilar, reconocimiento facial, venas de la palma, tarjeta RFID, PIN, código QR o código de barras: la estructura que recibe su servidor es siempre la misma. Sin DLL. Sin dependencia de runtime. Sin requisito de Windows. Sin archivo de licencia que gestionar.

Lo que esto significa específicamente para su equipo

Un desarrollador que se incorpore a su equipo la próxima semana puede clonar el repositorio, añadir las credenciales del Gateway al archivo de entorno y realizar su primera llamada correcta a un dispositivo biométrico en cuestión de minutos desde que se sienta. Para la RESTful API escribe un POST HTTP estándar. Para la Callback API escribe un receptor HTTP estándar. Ninguno requiere una máquina Windows, un instalador de SDK, una clave de licencia del proveedor ni ningún conocimiento de protocolos binarios de dispositivos. Se integran con el Gateway exactamente igual que con cualquier otro servicio JSON de su pila.

Preguntas frecuentes

¿Sustituir el SDK por una API implica perder alguna funcionalidad del dispositivo?
Cams Biometrics Gateway expone 38 operaciones biométricas a través de los dos tipos de API. La RESTful API gestiona los comandos que su servidor envía al dispositivo, como añadir usuarios, eliminar registros, cargar registros de eventos y registrar datos biométricos. La Callback API entrega eventos en tiempo real desde el dispositivo a su servidor, incluidos los fichajes de asistencia procedentes de huella dactilar, reconocimiento facial, venas de la palma, tarjeta RFID, PIN, código QR y código de barras. En la mayoría de los casos, el Gateway ofrece más capacidades que una versión concreta del SDK del fabricante, porque trabaja directamente con el protocolo del dispositivo. Verifique la compatibilidad de su modelo de dispositivo concreto con el equipo de soporte de Cams antes de migrar.
Ya hemos creado un envoltorio importante alrededor del SDK. ¿Cuánto de eso tenemos que desechar?
La lógica de negocio de su envoltorio, las reglas sobre qué empleados tienen qué niveles de acceso, la asignación entre sus IDs de HRMS y los IDs de usuario del dispositivo, la gestión de errores y la lógica de reintentos, todo eso es reutilizable. Lo que se reemplaza es la capa que llama a las funciones de la DLL. En lugar de llamar a funciones del SDK, se realizan peticiones HTTP. La lógica situada por encima de esa capa permanece igual. En la mayoría de los casos, la sustitución del SDK es un cambio más pequeño de lo que parece desde fuera.
¿Es una API menos fiable que una conexión directa con el SDK?
No por naturaleza. El Gateway mantiene una conexión persistente con el dispositivo e incluye una caché y una cola sin conexión que almacenan las operaciones cuando un dispositivo no es accesible temporalmente. Los eventos no se pierden durante las interrupciones de conectividad y se entregan a su endpoint de Callback cuando la conexión se restablece. La fiabilidad de la conexión con el dispositivo depende de la infraestructura del Gateway, no de si su aplicación se comunica con él mediante HTTP o mediante llamadas a una DLL. Un gateway bien gestionado tendrá una disponibilidad superior a la que consiguen la mayoría de los equipos con una instalación de SDK autogestionada en una única máquina virtual Windows.
¿Y la latencia? ¿El salto de red adicional añade un retardo significativo?
Para la mayoría de las operaciones biométricas, el salto de red adicional añade unos pocos milisegundos. Las notificaciones de asistencia se entregan en tiempo real, ya que el gateway las envía a su endpoint de webhook, por lo que el modelo de latencia es similar al de una conexión directa con el SDK que recibe un evento. En las operaciones de escritura, como añadir un usuario, el tiempo total de ida y vuelta está determinado por el tiempo de procesamiento propio del dispositivo, que es de 1 a 3 segundos independientemente de cómo llegó la instrucción. El salto HTTP no es el cuello de botella.
¿Podemos usar la API desde nuestro backend actual en Python o Node.js sin ninguna biblioteca cliente especial?
Sí. La API usa HTTP estándar con cuerpos JSON. Cualquier biblioteca cliente HTTP en cualquier lenguaje funciona sin modificaciones. No necesita un SDK especial, una biblioteca cliente publicada por el proveedor del gateway ni ningún paquete específico de un lenguaje. Si puede hacer una petición HTTP POST con un cuerpo JSON, puede llamar a la API. Esa es toda la superficie de integración desde el punto de vista de su aplicación.

Conclusión: el problema del SDK tiene una solución limpia

Un SDK biométrico solo para Windows no es una realidad inevitable con la que su equipo de ingeniería tenga que convivir para siempre. Es la consecuencia de una decisión de distribución tomada hace dos décadas en un panorama de infraestructura distinto. Esa decisión puede ser reemplazada por un gateway que absorbe la complejidad del protocolo binario y expone el dispositivo mediante una API estándar.

Cuando se produce esa transición, la máquina virtual Windows dedicada se da de baja. El pipeline de CI/CD recupera la integración biométrica. El nuevo desarrollador configura su entorno local en minutos. El contenedor Docker se ejecuta sin configuración especial. Los desarrolladores de Mac dejan de conectarse de forma remota a la única máquina de la oficina que tiene instalada la licencia del SDK. Estas no son pequeñas mejoras de calidad de vida. Son la eliminación de una restricción estructural que ha estado consumiendo el tiempo y la paciencia de su equipo de ingeniería durante años.

Cams Biometrics Gateway sustituye por completo el SDK de Windows. Se conecta a sus dispositivos biométricos de Cams, ZKTeco, Suprema, Hikvision, Anviz, Morpho/IDEMIA, Virdi, Mantra, Nitgen, Realtime, Biomax, Secugen, eSSL, Matrix y otros, utilizando sus protocolos nativos, sin que sea necesario instalar ningún SDK en ninguna parte de su infraestructura. Expone 38 operaciones a través de dos tipos de API: una Callback API que envía eventos en tiempo real de los dispositivos a su servidor con latencia cero, y una RESTful API que acepta comandos de su servidor hacia el dispositivo. Toda la comunicación es JSON sobre HTTP/HTTPS con cifrado AES-256 opcional. La integración nativa con MCP permite que Claude, Gemini y ChatGPT llamen directamente a operaciones biométricas. La caché y la cola sin conexión gestionan automáticamente las interrupciones de conectividad. El Gateway funciona de forma idéntica tanto si su pila se ejecuta en Linux, Mac, Windows, Docker, Kubernetes o funciones serverless. Sin DLL. Sin Visual C++ Redistributable. Sin máquina Windows dedicada. Sin archivo de licencia. Explore la API completa en CamsBiometrics.com para obtener información sobre la migración de su integración actual con el SDK.

 

Was this article helpful?