Visión general
El SDK Web de Unico Check permite construir rápida y fácilmente una excelente experiencia de captura de Selfies en sus aplicaciones web. Se proporciona un componente para que pueda capturar imágenes de manera fluida en su aplicación utilizando mecanismos modernos de apertura de cámara y algoritmos de visión computacional.
Además de abstraer toda la complejidad relacionada con la manipulación de la cámara, el SDK también tiene como objetivo ayudar a encuadrar las imágenes, optimizándolas para aumentar la precisión de la respuesta del motor biométrico.
El SDK Web utiliza los recursos nativos de HTML 5, JavaScript y CSS y funciona en todos los browsers modernos.
DISPOSITIVOS COMPATIBLES
Sistemas Operativos
El frame de captura, disponible a través del SDK, es compatible con los siguientes sistemas operativos y versiones:
- iOS: A partir de la 11.0
- Android: A partir de la 5.1
Además de los sistemas operativos de dispositivos móviles, también se proporciona compatibilidad con Windows y MacOs.
En las versiones desktop, al usuario le puede resultar difícil capturar (o incluso validar las imágenes a través del motor biométrico) debido a la mala calidad de algunas cámaras VGA.
La aplicación funciona en iFrames solo usando Interactive Liveness. Ver más en la sección CONFIGURAR EL MODO DE CAPTURA DE VIDA INTERACTIVA EN IFRAME
Otros modos de captura no funcionan en iFrame.Browsers
El frame de captura disponible a través del SDK es compatible con las siguientes combinaciones de browsers y sistemas operativos:
| Sistema Operativo | Chrome | Firefox | Safari | Samsung Internet | Opera | Edge |
|---|---|---|---|---|---|---|
| Windows (desktop) |  | | N/A | N/A |  | |
| Android | | * | N/A | | | |
| iOS | | | | N/A | | |
| MacOS (desktop) | | | | N/A | | |
El browser Firefox en Android solo ofrece soporte por el Smartlive sin interacción
En general, el SDK ofrece soporte a WebRTC y versiones más recientes de los browsers mencionados anteriormente. Por cuestiones de compatibilidad y seguridad, no se garantiza el funcionamiento en versiones muy antiguas de estos browsers.
Webview
SOBRE LA HERRAMIENTA
Es un componente del sistema que permite que las aplicaciones Android o iOS muestren contenidos web directamente dentro de la aplicación, según el mismo proyecto de código. Ser responsable de la navegación por los sitios web y el contenido web dentro de las aplicaciones. te dentro do aplicativo, baseado no mesmo projeto de código. Sendo responsável pela navegação em sites e conteúdo da web dentro dos aplicativos.
PRERREQUISITOS
Es necesario haber implementado el SDK Web en una aplicación que contenga un dominio seguro con protocolo https.
COMPATIBILIDAD CON REDES SOCIALES
El componente fue homologado en las redes sociales: Instagram y Facebook en todos los modos de captura (excepto en el modo de cámara de selfie de prueba de vida de FaceTec).
COMPATIBILIDAD CON FRAMEWORKS HÍBRIDOS
El componente fue homologado solo en capas nativas, para poder ser utilizado en frameworks híbridos (Flutter o React Native) es necesario implementarlo en la capa nativa de Android y/o iOS..
Cuando se ejecuta, el SDK solicitará permiso para abrir la cámara para webview, que a su vez solicitará lo mismo para la aplicación nativa.
Es obligatorio que su aplicación nativa tenga los permisos necesarios establecidos en los archivos de configuración.
Más detalles sobre este punto se mostrarán en las secciones a continuación.
ANDROID
COMPATIBILIDAD CON SISTEMA OPERATIVO
El SDK Web es compatible con webviews ejecutadas en Android 8 (API 26) o superior.
COMPATIBILIDAD CON DISPOSITIVOS
La herramienta es compatible con la gran mayoría de los dispositivos. La siguiente tabla enumera los dispositivos que se han probado en el laboratorio. Algunas extensiones enumeradas pueden estar sujetas a API o SKU específicos del fabricante:
| Dispositivo | Versión del S.O. | Cámara selfie con captura manual | Cámara selfie con captura inteligente | Cámara de documento con captura manual |
|---|---|---|---|---|
| Galaxy A12 | Android 11.0 | | | |
| Galaxy A10s | Android 10.0 | | | |
| Galaxy S20FE | Android 12.0 | | | |
| Moto G8 Plus | Android 9.0 | | | |
| Moto G52 | Android 12.0 | | | |
| Moto E7 | Android 10.0 | | | |
| LG K62 | Android 10.0 | | | |
| Asus X01BDA | Android 8.1.0 | | | |
El aliado FaceTec garantiza el funcionamiento del webview. Con eso, Webview también se puede usar en el modo Cámara para selfies con la prueba de vida de FaceTec.
IMPLANTACIÓN
Para que el SDK funcione correctamente, es necesario agregar algunos permisos y configuraciones al archivo AndroidManifest, ellas son:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.webkit.PermissionRequest" />
<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />
<uses-feature android:name="android.hardware.camera2.full" />
<uses-feature android:name="android.hardware.camera2.autofocus" />
Se recomienda utilizar webviews basadas en Chromium con algunas personalizaciones para que JavaScript. Es posible encontrar un ejemplo de implementación a través de la POC.
IOS
COMPATIBILIDAD CON SISTEMA OPERATIVO
El SDK Web es compatible con webviews ejecutadas en iOS 13 o superior.
COMPATIBILIDAD CON DISPOSITIVOS
La herramienta es compatible con la gran mayoría de los dispositivos. La siguiente tabla enumera los dispositivos que se han probado en el laboratorio. Algunas extensiones enumeradas pueden estar sujetas a API o SKU específicos del fabricante:
| Dispositivo | Versión del S.O. | Cámara selfie con captura manual | Cámara selfie con captura inteligente | Cámara de documento con captura manual |
|---|---|---|---|---|
| Iphone 12 Pro Max | iOS 16.0 | | | |
| Iphone 12 | iOS 16.0 | | | |
| Iphone 11 | iOS 16.0 | | | |
| Iphone 8 | iOS 15.5 | | | |
| Iphone 7 | iOS 15.6.1 | | | |
| Iphone 7 | iOS 14.3 | | | |
| Iphone 6s | iOS 13.5.1 | | | |
| Iphone 6s | iOS 13.1.3 | | | |
El aliado FaceTec garantiza el funcionamiento del webview. Con eso, Webview también se puede usar en el modo Cámara para selfies con la prueba de vida de FaceTec.
IMPLANTACIÓN
Para que el SDK funcione correctamente, es necesario agregar algunos permisos y configuraciones al archivo info.plist, estas son:
<key>NSCameraUsageDescription</key>
<string>Camera usage description</string>
iOS proporciona dos formas de usar Webviews en aplicaciones, estas son: WKWebView y SFSafariViewController. Recomendamos usar SFSafariViewController para una mejor compatibilidad con las funciones DOM. Es posible encontrar un ejemplo de implementación a través de la POC.
FLUJO DE COMUNICACIÓN CON LA APLICACIÓN NATIVA
Una POC que ejemplifica un flujo de comunicación de devolución desde una aplicación Web con el SDK para una aplicación nativa iOS que usa webview está disponible y se puede encontrar aquí.
FUNCIONALIDADES DISPONIBLES
Actualmente, el SDK Web tiene las siguientes funcionalidades disponibles:
- Reconocimiento fácil;
- Captura con Cámara Manual;
- Captura con Cámara Inteligente;
- Captura con prueba de vida (Smartlive con interacción FaceTec);
- Captura de documentos;
Algunos celulares antiguos, como los dispositivos con Android 6 o iPhone 4, pueden no ofrecer soporte a los recursos necesarios para el funcionamiento de la tecnología de visión computacional, como face-api y tjfs, que se utilizan en la funcionalidad de Cámara Inteligente.
En estos casos, la funcionalidad de la Cámara Normal se activa como fallback, lo que permite al usuario capturar manualmente.
Este tipo de fallback no está disponible para captura con prueba de vida (Smartlive con interacción);
DIAGRAMA DE FUNCIONAMIENTO
El SDK (client-side) se encarga de simplificar su integración con Unico Check, abstrayendo toda la complejidad relacionada con la manipulación de la cámara y captura.
Si la captura se realiza correctamente, el SDK devuelve un objeto que debe ser enviado a las API, completando así la validación biométrica.
- El usuario accede a su aplicación;
- A través del SDK iOS, su aplicación solicita el frame para la captura (de acuerdo a cómo se configuró su aplicación);
- Su aplicación renderiza el frame para la captura en un placeholder preestablecido;
- El SDK iOS captura la imagen (de manera automática, manual o usando liveness con interacción), generando un token
JWT; - Su aplicación repasa el
JWTpara su servidor;
::alert importante
El atributo Encrypted está estrictamente destinado a enviar la imagen a través de las API de Unico. No debes abrir ni serializar este atributo, ya que sus características pueden cambiar sin previo aviso. Su uso debe ser exclusivo en interacciones con APIs para garantizar la integridad y seguridad de los datos. Unico no es responsable de ningún daño resultante de esta práctica, ya que pueden ocurrir cambios de manera impredecible. :::
- Su servidor interactúa con las API de motores para analizar la imagen (la documentación de las API de motores biométricos se puede encontrar en este enlace);
- Los servidores devuelven la respuesta de los motores, que debe ser enviada a su aplicación;
¿Dudas?
¿No encontró algo o aún necesita ayuda? Si ya es cliente o asociado, puede contactarnos a través del Centro de Ayuda.