Descripción general del Iframe
El Iframe de Heuristik incrusta una interfaz de identificación biométrica completamente alojada en tu aplicación. Se ejecuta en iframe.heuristik.com y comunica los resultados a tu página mediante postMessage.
Cómo funciona
El proceso de registro e identificación de pacientes mediante el iframe de Heuristik integrado en el sistema anfitrión del cliente, se puede resumir en los siguientes sencillos pasos:
Registro de paciente
- El iframe de Heuristik devuelve un HH-ID tras el registro de un paciente.
- Ese dato HH-ID se envía al sistema anfitrión por postMessage, además del dato de que se trata de un paciente nuevo.
- El integrador debe gestionar la recepción de esos dos datos (el HH-ID y que se trata de un usuario nuevo), almacenarlo en su base de datos el HH-ID y relacionarlo correctamente en su sistema con el historial clínico de la persona registrada.
Identificación de paciente
- El iframe de Heuristik devuelve el HH-ID del paciente tras su identificación.
- Ese dato HH-ID se envía al sistema anfitrión por postMessage, además del dato de que NO se trata de un paciente nuevo.
- El integrador debe gestionar la recepción de esos dos datos (el HH-ID y que NO se trata de un usuario nuevo) para hacer una consulta en su base de datos, donde debería localizar ese HH-ID para con él recuperar de su sistema el historial clínico de esa persona.
Puede encontrar una visión más detallada y con ejemplos de código aquí
Características principales
- UI alojada — se ejecuta completamente en
iframe.heuristik.com, sin código frontend que construir o mantener - Hardware requerido — necesita un escáner de huellas conectado por USB y el driver local en ejecución (ambos proporcionados por Heuristik)
- Autenticación de personal — el personal clínico inicia sesión dentro del iframe antes de escanear
- Resultados vía postMessage — el iframe envía
{ HHID: string, isNew: boolean }a la ventana padre - Acceso basado en token — un
tokenIframeproporcionado por Heuristik autoriza la integración - Código de región - un
regionCodeproporcionado por Heuristik indica la región a la que pertenecen los datos del usuario - Certificado válido - es necesario disponer de un certificado de seguridad válido en la web contenedora a fin de evitar el contenido mixto (HTTP-HTTPS), ya que de otro modo el navegador bloquea la comunicación con el sensor.
- Delegación de permisos - el iframe necesita que se habilite el permiso de 'Aplicaciones en el dispositivo' en el navegador y que este permiso se delegue al iframe, para la conexión con el websocket de comunicación con el sensor de huellas dactilares. Asimismo, hay que delegar el permiso para poder copiar al portapapeles y que los botones que facilitan el copiado funcionen correctamente.
- Cookies de terceros requeridas — el iframe necesita cookies cross-origin para la gestión de sesión
Cuándo usar el Iframe
| Iframe | JavaScript SDK | |
|---|---|---|
| Esfuerzo de integración | Mínimo — incrustar una etiqueta <iframe> | Medio — instalar paquete, escribir código |
| Personalización de UI | Ninguna — UI alojada tal cual | Control total sobre la UI |
| Dependencia de hardware | Escáner de huellas + driver local | Escáner de huellas + driver local |
| Autenticación | El personal inicia sesión dentro del iframe | Tu app gestiona auth vía SDK |
| Entrega de resultados | postMessage a la ventana padre | Funciones callback en tu código |
| Ideal para | Integración rápida sin cambios en frontend | Flujos personalizados y UI propia |
Cuándo elegir el Iframe
Usa el Iframe cuando quieras la vía de integración más rápida y no necesites personalización de UI. Si necesitas control sobre el flujo de identificación o la interfaz, usa el JavaScript SDK.
Requisitos previos
Antes de integrar el Iframe, asegúrate de cumplir todos los requisitos. En resumen:
- Escáner de huellas y driver local (ambos proporcionados por Heuristik)
- Token de iframe (proporcionado por Heuristik)
- Código de región (proporcionado por Heuristik)
- Certificado válido en la web contenedora para evitar contenido mixto HTTP-HTTPS
- Permiso 'Aplicaciones en dispositivo' habilitado y delegado al iframe
- Permiso 'Portapapeles' habilitado y delegado al iframe
- Cookies de terceros habilitadas para
iframe.heuristik.com