Oz Liveness Web Adapter

Oz Liveness WEB Adapter se configura mediante cambios en el archivo de configuración almacenado en el servidor de Oz Liveness WEB Adapter: /core/app_config.json

Ajustes del archivo de configuración de Oz Liveness WEB Adapter

• use_for_liveness: la opción se utiliza cuando los gerentes del banco toman los videos de los clientes. Si la opción se establece como true, los dispositivos móviles utilizan la cámara trasera por defecto; en el escritorio, el giro y el círculo oval se desactivan. Por defecto, la opción está configurada en false;

• preinit: este parámetro opcional activa la carga preliminar de los scripts y la inicialización de la detección de rostros. Es necesario para reducir el tiempo de carga del complemento. El valor por defecto es off, lo que significa que todos los scripts se cargan después de llamar a OzLiveness.open(). El valor script significa que los scripts se cargarán antes de que se inicie el complemento. El valor full permite la carga preliminar de los scripts y la inicialización de la detección de rostros.

• architecture: este parámetro opcional se utiliza para elegir la arquitectura de WebSDK. El valor por defecto es normal. Si necesita la API Lite, use lite;

• api_url: dirección del servidor Oz API, un parámetro de texto;

• api_token: token de acceso a Oz API, un parámetro de texto;

• api_use_token: aun parámetro para especificar la fuente del token de acceso a Oz API para el sistema. Valores posibles = config, client.

  • Si el valor del parámetro es client, se espera un token de acceso a Oz API derivado del complemento JS;

  • Si especifica config en este parámetro, se recuperará un token del parámetro api_token del archivo de configuración del Oz Liveness WEB Adapter.

• lang_allow: idiomas disponibles en el sistema;

• lang_default: la configuración regional del sistema por defecto;

• video_actions_list: bloque de etiquetas de archivos de video utilizados en el sistema, una matriz de texto. Lista de etiquetas actual.

• photo_actions_list: bloque de etiquetas de archivos fotográficos utilizados en el sistema, una matriz de texto. Lista de etiquetas actual.

• actions_default_importance: este parámetro especifica si se permite redefinir la matriz de acciones desde el complemento WEB al iniciar el análisis. Valores posibles = true, false;

  • Si establece true, el Adapter utilizará la matriz de acciones del archivo de configuración.

  • Si establece false, el Adapter utilizará una matriz de acciones reenviada desde su navegador con el uso del método open(options).

• actions_default: la matriz de acciones. Las opciones incluyen:

  • video_count: el número de archivos de video transmitidos, un parámetro numérico;

  • photo_front: si el documento tiene un anverso. Valores posibles = true, false

  • photo_back: si el documento tiene un reverso. Valores posibles = true, false

• analyses: un bloque para configurar el lanzamiento de los análisis. Las opciones incluyen:

  • quality:lanzamiento del análisis de Oz Liveness. Valores posibles = true, false;

  • biometry: lanzamiento del análisis Oz Biometry Valores posibles = true, false;

  • documents: lanzamiento del análisis de Oz Text. Valores posibles = true, false.

• extract_best_shot: un parámetro que especifica si se debe adjuntar al resultado del análisis un enlace directo a la mejor toma extraída del video. Valores posibles = true, false;

• result_mode: un parámetro que especifica el contenido de la respuesta del servidor con los resultados de la verificación. Valores posibles:

  • safe: sólo se devuelve el estado de los análisis (finalizado o aún no finalizado);

  • status: se devuelven los resultados de los análisis realizados;

  • full: La respuesta completa de Oz API sobre los análisis se devuelve en formato JSON;

• result_codes: bloque de códigos de respuesta con anotaciones;

• delete_old_sessions: true, false; si desea borrar las sesiones anteriores;

• delete_old_sessions_offset_minutes: ***: tiempo de eliminación de las sesiones anteriores (en minutos);

• video_required_actions_list: conjunto de acciones requeridas

"video_required_actions_list":
[
  "video_selfie_smile"
],

• save_lossless_frame: true: guardar el fotograma original sin compresión

• video_file_format: opcional; aquí puede elegir el formato de archivo de video. Este archivo de video se pasa a la api. Valores posibles: MOV, ZIP, el valor predeterminado es MOV.

Configuración de Oz Liveness WEB Adapter mediante variables de entorno

Algunos de los parámetros del archivo de configuración pueden modificarse sin necesidad de editar directamente este archivo. Puede hacerlo utilizando las variables de entorno.

• WA_ARCHITECTURE: redefine el parámetro architecture

• WA_API_URL: redefine el parámetro api_url

Ejemplo del uso de variables de entorno al ejecutar una imagen docker de WebSDK en modo Lite:

docker run -d -p 80:80 \
-e WA_ARCHITECTURE=lite \
-e WA_API_URL='http://127.0.0.1:8000/v1/face/liveness/detect' \
oz-wa

Configuración del servidor mediante variables de entorno

• WA_CORS_ORIGINS: define qué orígenes están autorizados para realizar solicitudes. No hay un valor predeterminado. Tenga en cuenta que si no establece este valor, los encabezados CORS se desactivarán y no se los agregará al contenedor WebSDK.

• WA_CORS_METHODS(opcional): métodos HTTP que se pueden utilizar. Si la variable no está establecida, asume el valor predeterminado que es 'GET, POST, OPTIONS'. Si no se utiliza la variable, se acepta cualquier método.

• WA_CORS_HEADERS(opcional): encabezados HTTP que se pueden utilizar. Si la variable no está establecida, asume el valor predeterminado que es 'DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type'. Si no se utiliza la variable, se acepta cualquier encabezado.

Un ejemplo de uso de variables de entorno para la configuración del servidor:

docker run -d -p 80:80 \
-e WA_CORS_ORIGINS='*' \
-e WA_CORS_METHODS='GET, POST, OPTIONS' \
-e WA_CORS_HEADERS='DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type' \
oz-wa