Support Hub/API & Integrations/Cómo conectar dispositivos biométricos sin IP pública: el…
Translated from the English article and reviewed by a person. Read the English original
Developer

Cómo conectar dispositivos biométricos sin IP pública: el Hybrid Connector explicado

Cómo conectar dispositivos biométricos sin IP pública: el Hybrid Connector explicado

Muchos proyectos de integración biométrica se estancan por una cuestión que no tiene nada que ver con la biometría: ¿cómo puede la nube acceder a un dispositivo que está detrás del router de una oficina? Muchos centros no tienen una dirección IP pública, una IP que cambia cada día o un equipo de TI que no abrirá puertos de entrada en el firewall, y tienen razón en ser cautelosos. La solución tradicional, el reenvío de puertos (port forwarding), es complicada y expone la red local. Cams Biometrics resuelve este problema con el Hybrid Connector, un pequeño programa que conecta su centro con el Gateway desde dentro hacia fuera. Esta guía explica por qué tantos dispositivos son difíciles de alcanzar, cómo funciona el Hybrid Connector en términos sencillos, qué puede hacer a través de él y cómo configurarlo.

01 · El problema de la red

Por qué muchos dispositivos biométricos son difíciles de alcanzar

Un dispositivo biométrico en una red local es como una casa en un camino privado. Las personas que están dentro pueden salir cuando quieran, pero nadie desde fuera puede entrar a menos que alguien abra la puerta. Para que una plataforma en la nube acceda directamente a un dispositivo, el centro necesita una dirección pública y una apertura deliberada en el firewall que lleve hasta el dispositivo. Muchos centros simplemente no cuentan con ello, por motivos justificados.

Situación Qué significa Por qué falla el acceso directo
Sin IP pública El proveedor de internet comparte una misma dirección pública entre muchos clientes No existe una dirección única que lleve a su centro
Dirección IP cambiante La IP pública del centro cambia con regularidad Una dirección que funciona hoy puede apuntar a otro lugar mañana
Política de firewall estricta TI no permite conexiones entrantes desde internet La nube no puede iniciar la comunicación con el dispositivo
No es posible el reenvío de puertos El router lo gestiona el propietario del inmueble, el proveedor de internet o la oficina central Nadie en el centro puede abrir la puerta
Preocupaciones de seguridad Abrir puertos expone los sistemas internos a internet Aunque sea posible, muchas organizaciones no aceptarán el riesgo

Las sucursales minoristas, las obras de construcción, los almacenes, los colegios y las oficinas pequeñas se encuentran con estas limitaciones. Ninguna de ellas es motivo para renunciar a la integración biométrica en la nube. Son motivo para conectarse de otra manera.

02 · Directo frente a indirecto

Dos formas de conectar un dispositivo Hybrid Push

Los dispositivos Cams, y los dispositivos verificados en developer.camsbiometrics.com, se conectan al Gateway mediante Native Push, comunicándose directamente con él a través de internet. Otros dispositivos se conectan mediante Hybrid Push, y Hybrid Push ofrece dos topologías de despliegue. La adecuada depende por completo de la red de su centro.

Topología directa Topología indirecta (Hybrid Connector)
Cómo se conecta El Gateway se conecta con el dispositivo, la base de datos o los archivos a través de internet Un Hybrid Connector en un equipo local se conecta hacia fuera con el Gateway
Se necesita IP pública Sí, en el equipo del centro No
Se necesita reenvío de puertos Sí No
Software en el centro Ninguno El Hybrid Connector, en un equipo local
Ideal para Centros con IP pública y equipos de TI que se sienten cómodos con el reenvío de puertos Centros detrás de routers, firewalls estrictos o sin IP pública

La opción más sencilla para la mayoría de los centros

Si no puede configurar una IP pública y el reenvío de puertos, elija la topología indirecta con el Hybrid Connector. Evita por completo la configuración de red en el lado del cliente, por lo que normalmente es la vía más sencilla de desplegar.

03 · De dentro hacia fuera, no de fuera hacia dentro

Cómo funciona el Hybrid Connector

El Hybrid Connector invierte el problema de la red. En lugar de que la nube intente entrar en su centro, algo dentro de su centro se comunica hacia la nube. Volviendo a la casa en un camino privado: en lugar de pedir a alguien que abra la puerta, un residente sale y mantiene una línea de comunicación abierta desde el mundo exterior hasta la casa.

Sin el Hybrid Connector

Cams Gateway

Intenta llegar al dispositivo desde internet

→

Router o firewall del centro

Bloquea la conexión entrante

→

Dispositivo

Nunca recibe la solicitud

Con el Hybrid Connector

Dispositivo, base de datos o archivo

Permanece en la red local

→

Hybrid Connector

Se ejecuta en un equipo local y se comunica con el dispositivo de forma local

→

Conexión saliente

El Connector se conecta hacia el Gateway

→

Cams Gateway

Intercambia datos con su ERP/HRMS a través de esa conexión

Como la conexión se inicia desde dentro de su red, funciona de la misma manera que lo hace un navegador web en ese equipo. El centro no necesita una IP pública, y el firewall no necesita aceptar ninguna nueva conexión entrante. El Hybrid Connector actúa como puente entre el dispositivo, la base de datos o los archivos locales por un lado, y el Biometric Gateway por el otro.

El reenvío de puertos abre una puerta hacia su red. El Hybrid Connector mantiene la puerta cerrada y realiza la llamada desde dentro.

Compruebe qué puertos debe permitir

Las conexiones salientes deben seguir estando permitidas por su firewall. La mayoría de las redes ya permiten el tráfico web saliente habitual, pero las redes estrictas pueden restringirlo. Consulte la sección Ports Supported de la documentación de la Cams Web API y compártala con su equipo de TI antes de la instalación.

04 · Funciones y límites

Qué puede hacer a través del Hybrid Connector

El Hybrid Connector decide cómo se conecta su centro. No decide qué puede hacer. Eso lo determina el método de comunicación utilizado para hablar con el dispositivo, y hay tres entre los que elegir.

Modo Método de comunicación Callback API RESTful API
Indirect Device Device SDK Completo Completo, dentro de los límites del SDK
Indirect DB DB Pull desde la base de datos local del software del dispositivo Solo asistencia No compatible
Indirect File File Processing del archivo de asistencia del software del dispositivo Solo asistencia No compatible
Método de comunicación Cómo funciona
Device SDK El Gateway se comunica con el hardware a través del SDK del fabricante, por lo que todas las funciones que admite el SDK están disponibles mediante la API. Es la mejor opción para el acceso completo a la API
DB Pull El Gateway lee los nuevos registros de asistencia de la base de datos local donde el software del dispositivo los almacena, y los envía a su Callback URL
File Processing Un archivo de asistencia designado en el equipo local se supervisa de forma continua. Cada vez que el software del dispositivo lo actualiza, se detectan los nuevos registros y se envían a su Callback URL en tiempo real

La topología y las funciones son decisiones independientes

Las topologías directa e indirecta ofrecen exactamente las mismas funciones para el mismo método de comunicación. Elija su método de comunicación según las funciones de API que necesite, y elija su topología según lo que permita su red.

Incluso en modo Device SDK, el firmware o el SDK de un modelo de dispositivo concreto puede limitar algunas operaciones. Pruebe siempre con su hardware real y consulte los casos particulares con el equipo de Cams.

05 · Paso a paso

Configuración del Hybrid Connector

Las pantallas exactas dependen de su cuenta de Cams, pero cada configuración del Hybrid Connector sigue el mismo proceso.

1

Elija el equipo local adecuado

Seleccione un equipo en la misma red local que el dispositivo. Para DB Pull o File Processing, debe ser el equipo donde el software del dispositivo almacena su base de datos o su archivo de asistencia, ya que el Connector necesita acceso local a ellos.

2

Confirme el acceso saliente

Comparta los detalles de Ports Supported de la documentación de Cams con su equipo de TI, y confirme que el equipo puede realizar las conexiones salientes necesarias.

3

Instale el Hybrid Connector

Instale el Connector en ese equipo y vincúlelo a su cuenta de Cams, siguiendo las instrucciones de configuración de su cuenta.

4

Seleccione el método de comunicación

Elija Device SDK si el Gateway admite el SDK de su dispositivo. De lo contrario, elija DB Pull o File Processing para los datos de asistencia.

5

Configure su Callback URL

Configure la dirección HTTPS de su receptor, HRMS, ERP o herramienta de automatización como Callback URL, para que los eventos de asistencia tengan un destino.

6

Pruebe de principio a fin

Escanee una huella dactilar o un rostro en el dispositivo y confirme que el evento llega a su Callback URL. En modo Device SDK, pruebe también una operación RESTful, como añadir un usuario de prueba.

¿Necesita un receptor al que enviar los eventos? Los Cams AI Code Generator Prompts pueden generar un receptor de callback completo en Python, Node.js, PHP y otros varios lenguajes.

06 · Buenas prácticas

Mantener la conexión en buen estado

Una vez instalado, el Hybrid Connector pasa a formar parte de la infraestructura de su centro. Unos sencillos hábitos lo mantienen fiable.

Práctica Por qué es importante
Use un equipo que permanezca encendido Si el equipo entra en suspensión o se apaga, la conexión entre el centro y el Gateway se interrumpe
Desactive la suspensión y la hibernación La configuración de ahorro de energía es la causa más común de desconexiones silenciosas
Inicie el Connector automáticamente Tras un reinicio o un corte de energía, la conexión debería restablecerse sin que nadie inicie sesión
Proteja contra cortes de energía Un SAI (UPS) pequeño mantiene el equipo y la red en funcionamiento durante cortes breves
Mantenga el equipo actualizado y seguro Está conectado a su red, así que trátelo como cualquier otro equipo gestionado
Vigile las pérdidas de eventos Si un centro con mucha actividad deja de enviar eventos de repente, compruebe primero el equipo y su conexión

Qué ocurre cuando se pierde la conexión

La asistencia se registra en el dispositivo, y la caché sin conexión y la cola del Gateway están diseñadas para gestionar las interrupciones. Cuando la conexión se restablece, los registros se entregan con sus marcas de tiempo originales, por lo que los fichajes realizados durante una caída siguen apareciendo a la hora correcta. En DB Pull y File Processing, los registros permanecen en la base de datos o en el archivo del software del dispositivo hasta que el Connector los lee.

Preguntas frecuentes

¿Los dispositivos Cams necesitan el Hybrid Connector?

No. Los dispositivos Cams y los dispositivos verificados en developer.camsbiometrics.com se conectan mediante Native Push, comunicándose directamente con el Gateway a través de internet. El Hybrid Connector se utiliza para los dispositivos Hybrid Push.

¿El Hybrid Connector es más seguro que el reenvío de puertos?

Evita abrir puertos de entrada hacia su red local, lo que elimina una fuente habitual de riesgo. La comunicación se realiza mediante HTTP/HTTPS con validación de token de autenticación, y hay disponible un cifrado AES-256 opcional.

La dirección IP de nuestro centro cambia cada día. ¿Causará problemas?

No con la topología indirecta. Como el Hybrid Connector se conecta hacia el Gateway, su centro no necesita una dirección IP fija ni pública.

¿Puedo seguir añadiendo y eliminando usuarios a través del Hybrid Connector?

Sí, en modo Device SDK, dentro de los límites del SDK del dispositivo. DB Pull y File Processing solo admiten callbacks de asistencia, sin operaciones RESTful.

¿El Hybrid Connector funciona con mi HRMS o mi ERP?

Sí. El Connector gestiona la conexión entre su centro y el Gateway. Su HRMS, ERP o herramienta de automatización recibe los eventos a través de la Callback API exactamente de la misma forma que con cualquier otro modo de conexión.

Conclusión: la red no debe decidir su integración

Durante años, la red del lugar donde se encuentra el dispositivo decidió en silencio qué integraciones biométricas eran posibles. Sin IP pública no había conexión con la nube. Un firewall estricto significaba una larga negociación con TI. Una dirección IP cambiante significaba integraciones que se rompían sin previo aviso.

El Hybrid Connector elimina esa limitación. Al conectarse de dentro hacia fuera, permite que los dispositivos detrás de routers de oficina habituales, firewalls estrictos y conexiones a internet compartidas participen en las mismas integraciones en tiempo real que cualquier otro dispositivo, sin abrir ni un solo puerto de entrada.

Cams Biometrics Gateway pone en línea los dispositivos allá donde estén. Native Push conecta directamente los dispositivos Cams y los verificados. Hybrid Push conecta otras marcas a través de Device SDK, DB Pull o File Processing, usando una topología directa o el Hybrid Connector cuando no hay IP pública disponible. Todos los eventos llegan a sus sistemas a través de la misma Callback API, con validación de token de autenticación y cifrado AES-256 opcional. Descubra la plataforma en CamsBiometrics.com, consulte la documentación completa, incluidos los modos de conexión y los puertos admitidos, en developer.camsbiometrics.com, y genere su receptor con los AI Code Generator Prompts.

Was this article helpful?