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
• 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. Cookies de terceros habilitadas para iframe.heuristik.com