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

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 tokenIframe proporcionado por Heuristik autoriza la integración
• Código de región - un regionCode proporcionado 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:

1. Escáner de huellas y driver local (ambos proporcionados por Heuristik)
2. Token de iframe (proporcionado por Heuristik)
3. Código de región (proporcionado por Heuristik)
4. Certificado válido en la web contenedora para evitar contenido mixto HTTP-HTTPS
5. Permiso 'Aplicaciones en dispositivo' habilitado y delegado al iframe
6. Permiso 'Portapapeles' habilitado y delegado al iframe
7. Cookies de terceros habilitadas para iframe.heuristik.com