Skip to main content

Instalación

CONFIGURACIÓN DE LA POLÍTICA DE SEGURIDAD DEL CONTENIDO (CSP)

El Web SDK emplea el uso de Web Workers para mejorar la seguridad y el rendimiento. Por lo tanto, debe agregar las siguientes configuraciones a su Política de seguridad de contenido (CSP)

<meta
http-equiv="Content-Security-Policy"
content="
script-src 'self' 'unsafe-eval' *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app;
worker-src 'self' blob:;
child-src 'self' blob:;
style-src 'self' 'unsafe-inline' *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app;
font-src 'self' https://fonts.gstatic.com *.acesso.io *.unico.run *.unico.io *.unico.app;
img-src 'self' data: blob: *.acesso.io *.unico.run *.unico.io *.unico.app;
media-src 'self' data: *.acesso.io *.unico.run *.unico.io *.unico.app;
script-src-elem 'self' 'unsafe-inline' blob: *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app"
/>
Atención

Si su aplicación tiene un CSP, esta configuración es obligatoria para garantizar el correcto funcionamiento del SDK.

OBTENER LAS CREDENCIALES​

Para utilizar o SDK WEB é necessário obter a credencial SDK Key, uma chave única de identificação do cliente gerada pela equipe da Unico.

  1. Entre em contato com o CSs e/ou time de Onboarding.
  2. Solicite a SDK Key informando os identificadores de suas aplicações. Bundle Identifier para iOS, PackageID para Android e Host para WEB.
  3. Os identificadores de suas aplicações serão vinculados a SDK Key pela equipe da Unico.
  4. Você recebe a sua SDK Key para implementar o AcessoBioConfigDataSource
Credenciales (clave API del cliente): método obsoleto

Para importar credenciales (Clave API del cliente) a su proyecto, utilice la siguiente guía:

  1. Acceda a su instancia con nombre de usuario y contraseña;
  2. Desplácese hacia abajo en la barra de menú y haga clic en el menú Configuración , luego haga clic en el menú Integración y finalmente haga clic en el menú API Key;
  3. Para crear API Key, haga clic en + Nueva API Key or o para editar, haga clic en API Key deseada;
  4. Si desea utilizar el modo de cámara selfie de prueba de vida de FaceTec, asegúrese de que el campo Usar vivacidad con interacción esté lleno con la opción option. Si está lleno de NO, , o no aparece, comuníquese con el soporte a través del Centro de ayuda y solicite la activación; Para obtener más información sobre SMARTLIVE CON INTERACCIÓN (LIVENESS CON INTERACCIÓN), haga clic [aquí] (https://developers.unico.io/es/docs/check/visaogeralproduto).
  5. En el campo Usar autenticación segura en el SDK , seleccione la opción ;
  6. Expanda la sección SDK iOS, agregue el ID del proyecto y el Package Name;
  7. Finalmente, haga clic en Guardar;
  8. Volver a la sección APIKey;
  9. Elija la API Key configurada, en la columna Bundle, haga clic en el botón Descargar;
  10. Se abre una nueva sección, selecciona la opción iOS;
    NOTA

    Si la pestaña no se abre, verifique que su navegador esté bloqueando las ventanas emergentes.

  11. Haga clic en Generar y se abrirá automáticamente una nueva pestaña en su navegador que contiene información del proyecto en formato JSON;
  12. Guarde este JSON.

CARGANDO LAS CREDENCIALES A SU PROYECTO​

Para agregar la Clave SDK al proyecto, implemente la clase UnicoConfig.

import { UnicoConfig } from "unico-webframe"

const config = new UnicoConfig()
.setHostname("<YOUR_HOSTNAME>")
.setHostKey("<YOUR_HOST_KEY>");
Credenciales (clave API del cliente): método obsoleto
import { UnicoConfig } from "unico-webframe"

const config = new UnicoConfig()
.setProjectNumber("<YOUR_PROJECT_NUMBER>")
.setProjectId("<YOUR_PROJECT_ID>")
.setMobileSdkAppId("<YOUR_MOBILE_SDK_APP_ID>")
.setHostname("<YOUR_HOSTNAME>")
.setHostInfo("<YOUR_HOST_INFO>")
.setHostKey("<YOUR_HOST_KEY>");

CARGANDO EL ARCHIVO JSON (MÉTODO DEPRECIADO)​

UBICACIÓN DEL ARCHIVO EN SU PROYECTO

El archivo JSON debe estar en un local público y visible para la Web dentro de su proyecto.

CARGANDO OTROS ARCHIVOS DEL UNICO CHECK A SU PROYECTO​

PASO OPCIONAL

Este paso es opcional y depende de la configuración y opciones utilizadas en su proyecto

La siguiente tabla enumera los archivos de recursos adicionales disponibles para inclusión en su proyecto. Debe descargarlos e incluirlos en su proyecto dependiendo de las características que quiera utilizar. Funciones adicionales de Unico Check para la captura con la prueba de vida de FaceTec con interacción:

Release del SDKRelease de FaceTec (Haga clic en el número para descargar los archivos adicionales)
3.18.89.7.33
3.18.79.7.31
3.18.49.7.25
3.16.4 -> 3.17.09.6.89
3.16.39.6.85
3.16.29.6.84
3.14.1 -> 3.16.19.6.73
3.11.1 -> 3.14.09.6.65
3.10.2 -> 3.11.09.6.56
3.10.19.6.53
3.9.1 -> 3.10.09.6.40
3.9.09.6.38
3.8.39.6.33
3.8.29.6.30
3.8.0 -> 3.8.19.6.26
3.7.1 -> 3.7.29.6.24
3.6.5 -> 3.7.09.6.16
3.6.3 -> 3.6.49.6.11
3.6.1 -> 3.6.29.6.4
3.5.4 -> 3.6.09.4.18
3.5.39.4.14
3.5.0 -> 3.5.29.4.11

Para realizar la descarga del archivo de AI de Unico Check SDK Web haga clic aquí.

UBICACIÓN DEL ARCHIVO EN SU PROYECTO

Al igual que con el JSON del paso anterior, los archivos adicionales deben estar en un local público visible en la Web dentro de su proyecto.

INSTALACIÓN

El SDK Web está disponible a través de un paquete npm o cdn. Para la instalación, siga los siguientes pasos según su preferencia:

SUGERENCIA

Se recomienda utilizar las últimas versiones de los SDK. Para ello, esté atento a los Release notes.

Uso de Web Workers en el SDK

El Web SDK emplea Web Workers para mejorar la seguridad y el rendimiento. Para garantizar la funcionalidad de estos trabajadores al utilizar la Política de seguridad de contenido (CSP), agregue las siguientes configuraciones a su política:

Content-Security-Policy: ...; worker-src 'self' blob:; child-src 'self' blob:

INSTALACIÓN A TRAVÉS DEL PAQUETE NPM​

Para instalar el SDK en su proyecto a través de npm, simplemente ejecute el comando a continuación:

npm install unico-webframe

O por el yarn, con el comando a continuación:

yarn add unico-webframe

INSTALACIÓN A TRAVÉS DEL CDN​

Para instalar el SDK en su proyecto usando cdn, simplemente descargue el archivo a continuación e impórtelo a su proyecto.

NOTA SOBRE LA CÁMARA INTELIGENTE Y MODELOS DE IA

Para utilizar la Cámara Inteligente, debe agregar al proyecto algunos modelos de IA para que todo funcione bien. Para ello, realice la descarga de los modelos en este enlace y agréguelos a su proyecto.

Los modelos deben estar disponibles en una carpeta con el nombre models accesible públicamente a través de la URL base de su aplicación. Por ejemplo: https://www.seudominio.com/models o https://localhost:8000/models.

IMPORTACIÓN

Después de instalar el SDK, simplemente impórtelo correctamente en su proyecto.

Si instaló el paquete usando npm:

import { UnicoCheckBuilder, SelfieCameraTypes, UnicoThemeBuilder, DocumentCameraTypes, UnicoConfig, LocaleTypes } from 'unico-webframe'

Si instaló el paquete usando cdn:

import { UnicoCheckBuilder, SelfieCameraTypes, UnicoThemeBuilder, DocumentCameraTypes, UnicoConfig, LocaleTypes } from 'UnicoCheckBuilder.min.js'

RENDERIZACIÓN

La forma en que se renderiza el componente depende de si tiene o no la funcionalidad Smartlive (Prueba de vida) con interacción.

Sin utilizar Smartlive con interacción FaceTec​

El frame para captura se renderiza dentro de una div que debe tener su id necesariamente igual a "box-camera".

Ejemplo:

<div id="box-camera"></div>
Alerta

El identificador de este div debe ser siempre igual a id='box-camera'.

Utilizando Smartlive con interacción FaceTec

Si su proyecto usa Smartlive con interacción, no necesita crear un div en su código para renderizar. En este caso, se muestra un modal dentro de la misma ventana.

¿Dudas?

¿No encontró algo o aún necesita ayuda? Si ya es cliente o asociado, puede contactarnos a través del Centro de Ayuda.