Resolución de problemas
Validación y estados de error
Cuando el iframe carga, valida el token y el origen contra la API de Heuristik:
Códigos de error
| Código HTTP | Constante | Significado |
|---|---|---|
401 | UNAUTHORIZED_CODE | El token es inválido |
403 | — | El origen no coincide con la URL registrada |
409 | CONFLICT_CODE | El token ya está asociado a una sesión activa |
421 | MISDIRECTED_CODE | La solicitud fue dirigida al servidor incorrecto |
424 | FAILED_DEPENDENCY_CODE | Un servicio upstream requerido no está disponible |
Cuando la validación falla, el iframe muestra el NotAllowedIframeModal con un mensaje de error. No se envía ningún postMessage al padre.
Problemas comunes
| Síntoma | Causa | Resolución |
|---|---|---|
| El iframe muestra un modal de error inmediatamente | tokenIframe inválido | Contacta a tu representante de Heuristik para verificar el token |
| El iframe muestra un modal de error con token válido | Discrepancia de origen — tu URL no coincide con la URL registrada | Verifica con tu representante de Heuristik que la URL permitida coincida exactamente con tu dominio |
| Aparece advertencia de cookies | Las cookies de terceros están bloqueadas | Habilita cookies para iframe.heuristik.com en la configuración del navegador |
| Escáner no detectado | Driver local no está en ejecución | Inicia el servicio del driver local en la estación de trabajo |
| Escáner no detectado (driver en ejecución) | Conexión WebSocket bloqueada | Asegúrate de que ws://127.0.0.1:2794 no esté bloqueado por firewall o proxy |
No se recibe postMessage | La validación de origen en el listener es incorrecta | Verifica que compruebas contra https://iframe.heuristik.com |
Error 409 Conflict | Token ya en uso por otra sesión | Espera a que la sesión activa finalice, o contacta a tu representante de Heuristik para liberar el token |