Manuales Técnicos

GENERALIDADES

solución de Identificación & Servicios Biométricos


    Control De Versión

  • Versión : 2.8
  • Autor : Jeyson Duarte
  • Organización : ADO Technologies

La información comprendida en esta descripción es confidencial y pertenece a ADO Technologies SAS & Scanovate.


GENERALIDADES

GLOSARIO

ENROLAMIENTO

Proceso mediante el cual se realiza la adquisición de imágenes (Fotografía facial, cara anterior y cara posterior del documento de identidad), eventualmente huella dactilar a través de captores biométricos externos, con el fin de aplicar protocolos internos de revisión de características imprento-técnicas sobre el documento, al igual que comparación del rostros del documento contenido en el documento vs la fotografía facial del cliente en el momento de la radicación.

VERIFICACIÓN

Proceso mediante el cual se realiza la adquisición de una fotografía facial y/o huella dactilar a efectos de comparar la misma contra las existentes previamente en la base de datos para la identidad que se encuentra en duda y determinar si se tratan o no de la misma persona. Este proceso supone y obliga que exista al menos un enrolamiento satisfactorio previo al uso de esta funcionalidad.

OCR

Optical Character Recognition por su siglas en ingles, permite la recolección de imágenes (Cara anterior y posterior del documento) a efectos de realizar lectura de la información contenida en el documento de identidad presentado por el cliente.

CLIENTE

Persona natural o jurídica, que adquirió el servicio con ADO y quién suscribe el contrato como responsable de la parte demandante del servicio.

USUARIO FINAL

Persona natural sobre la cuál se pretende ejecutar el enrolamiento y/o lectura OCR y/o Verificación.

PROJECTNAME

Nombre creado y administrado desde la plataforma de ADO, con el cual se identifica un proyecto al interior de la plataforma suministrada por Ado Technologies SAS (En adelante ADO), para la prestación del servicio. Dentro de un mismo sitio Web podrán existir uno o más proyectos al mismo momento de tiempo.

APIKEY

Cadena alfa numérica creada y administrada desde la plataforma de ADO, con el cual se accede o deniegan servicios asociados a cada uno de los proyectos creados dentro de la plataforma.

URL BASE

Es la URL suministrada por ADO como plataforma para la prestación del servicio, lo que define el sitio final de interacción del SDK con un sitio web especifico.

DICCIONARIO DE RESPUESTAS

ENROLAMIENTO

IdState NameState Descripción
1 Pendiente Aplica para casos donde se detecta algún indicio o alerta sobre los documentos y/o su correspondencia con el portador del mismo. El caso es remitido al análisis por parte del BackOffice y la respuesta es definitiva se entregará en los tiempos pactados en el ANS.
2 Proceso satisfactorio Aplica para imágenes de documentos auténticos con uniprocedencia facial (documento vs selfie).
4 Documento autentico sin cotejo facial Aplica para cuando el score facial no supera el umbral de aprobacion.
5 Captura errada El usuario captura imágenes parciales de baja calidad, lo cual impide realizar un dictamen hasta que las ismas no sean mejoradas.
6 Documento no válido Se aportan formatos de documentos no pactados en los acuerdos de niveles de servicio.
7 Proceso en Verificación Casos que requieren de un análisis adicional para determinar su autenticidad, los tiempos para resolver un dictamen de fondo serán los pactados en el ANS.
8 Documento alterado Documentos elaborados por el ente emisor real, pero presentan alteraciones o adulteraciones en alguno(s) de sus campos o características técnicas.
9 Documento falso Documentos total o parcialmente elaborados por fuera del ente emisor.
10 Rostro no corresponde Se aplica para aquellos casos en los que el score facial de una correspondencia entre el portador y el contenido en el documento no alcanza el mínimo definido como de seguridad entre el contraste y el contratista.
11 Huella no corresponde Se aplica para aquellos casos en los que score dactilar de una correspondencia entre el portador y el contenido en el documento no alcanza el mínimo definido como de seguridad entre el contraste y el contratista.
14 Persona registrada previamente Se aplica parea los casos en donde el rostro y/o el número de identificación del cliente se encontraban registrados previamente al actual intento.
15 Error Se reserva para errores varios de comunicación, lentitud o indisponibilidad entre el SDK y el servidor.
16 Persona encontrada en listas de control. Se reserva para coincidencias en listas de control para nombres y números de identificación.
17 Proceso cancelado por el usuario. Se reserva para intenciones realizadas por el usuario en la ejecución de los SDK's.
18 Bloqueo Se reserva para bloqueos de números de identificación por un tiempo definido.

OCR

IdState NameState Descripción
1 Pendiente Aplica para casos donde se detecta algún indicio o alerta sobre los documentos y/o su correspondencia con el portador del mismo. El caso es remitido al análisis por parte del BackOffice y la respuesta es definitiva se entregará en los tiempos pactados en el ANS.
2 Proceso satisfactorio Aplica para imágenes de documentos auténticos con uniprocedencia facial (documento vs selfie).
5 Captura errada El usuario captura imágenes parciales de baja calidad, lo cual impide realizar un dictamen hasta que las ismas no sean mejoradas.
6 Documento no válido aportan formatos de documentos no pactados en los acuerdos de niveles de servicio.
7 Proceso en verificación Casos que requieren de un análisis adicional para determinar su autenticidad, los tiempos para resolver un dictamen de fondo serán los pactados en el ANS.

VERIFICACIÓN

IdState NameState Descripción
1 Pendiente Aplica para casos donde se detecta algún indicio o alerta sobre la comparación de rostros. El caso es remitido al análisis por parte del BackOffice y la respuesta es definitiva se entregará en los tiempos pactados en el ANS.
10 Rostro no corresponde Se aplica para aquellos casos en los que el score facial de una correspondencia entre el portador y el contenido en el documento no alcanza el mínimo definido como de seguridad entre el contraste y el contratista.
11 Huella no corresponde Se aplica para aquellos casos en los que score dactilar de una correspondencia entre el portador y el contenido en el documento no alcanza el mínimo definido como de seguridad entre el contraste y el contratista.
14 Persona registrada previamente Se aplica parea los casos en donde el rostro y/o el número de identificación del cliente se encontraban registrados previamente al actual intento.
15 Error Se reserva para errores varios de comunicación, lentitud o indisponibilidad entre el la solcición y el servidor.
16 Persona encontrada en listas de control. Se reserva para coincidencias en listas de control para nombres y números de identificación.
17 Proceso cancelado por el usuario. Se reserva para intenciones realizadas por el usuario en la ejecución de los SDK's
18 Bloqueo Se reserva para bloqueos de números de identificación por un tiempo definido.

DICCIONARIO DE DOCUMENTOS

Id Nombre
1 Cédula de ciudadania
2 Pasaporte
3 Cédula de ciudadania Ecuatoriana
4 Cédula de extranjería
5 Tarjeta de identidad
6 Card Id israel
7 Cédula de ciudadania Panameña

DICIONARIO RESPUESTA IMAGENES

La siguiente tabla hace referencia a los campos de respuesta de los servicios REST en la respuesta del Json con respecto al ImageTypeId y ImageTypeName del campo Images en la respuesta 200.

ImageTypeId ImageTypeName
1 Fotografia documento parte frontal
2 Fotografia documento parte Trasera
3 Fotografia cliente
4 Fotografia huella dactilar 1
5 Fotografia huella dactilar 2
6 Fotografia de firma
7 Fotografia Otros documentos
8 Fotografia Otros documentos 2
9 Fotografia Otros documentos 3
10 Fotografia Otros documentos 4
11 Fotografia Cliente servicio externo
12 Fotografia rostro recortada de documento
13 Fotografia firma recortada de documento
14 Fotografia imagen fantasma recortada de documento
15 Fotografia huella dactilar recortada de documento
16 Fotografia código de barras recortada de documento
17 Fotografia recortada de documento Parte frontal
18 Fotografia recortada de documento Parte trasera
19 Fotografia Cliente Verificada
20 Video de Liveness

CREDENCIALES

Para hacer uso de cualquiera de las invocaciones contenidas dentro de la presente información, así como de las APIs suministradas, se requiere del uso de un ProjectName, UrlBase y un ApiKey solicitada previamente.

COMO USAR LIVENESS

RECOMENDACIONES

Para hacer el uso correcto del Liveness tenga en cuenta las siguientes recomendaciones:

  1. No use gorra, gafas, audífonos, sobrero que impidan ver correctamente su rostro
  2. Ubíquese de frente a la camara, de tal forma que sea visible orejas, pupilas, nariz, pómulos, para que al momento de la captura la foto se vea de forma clara.
  3. Ubíquese dentro del circulo como se le indica y espere a que se capture la foto.
  4. El fondo debe ser de un color neutro, por ejemplo: un fondo blanco, azul, rojo.
  5. Ubíquese dentro del circulo como se le indica y espere a que se capture la foto.
  6. Las imágenes no deben estar borrosas o desenfocadas.
  7. Los ojos deben estar abiertos de manera natural. El iris y la pupila deben estar claramente visibles
  8. La imagen debe ser lo más frontal posible.
  9. La boca debe estar cerrada y tener una expresión neutral.
  10. Los ojos deben estar mirando al frente.
  11. La luz debe estar distribuida uniformemente en el rostro, el cual no debe estar afectado por sombras, ni regiones brillantes.
  12. Los colores deben ser naturales, no saturados y con un contraste adecuado.
  13. Los peinados y otros accesorios no deben obstruir la imagen del rostro o los ojos.
  14. Ejemplo de captura CORRECTA

POSIBLES ESCENARIOS QUE PUEDE GENERAR ERROR

  1. Si usted no se ubica correctamente dentro del círculo como indica el Liveness, no podrá seguir con el proceso y después de un corto tiempo, se le indicara que capture la foto nuevamente.
  2. Recuerde, el rostro debe aparecer completo dentro del círculo para poder contar el proceso, Liveness no admite que su rostro esté de medio lado o si dentro del círculo aparece solo la mitad del rostro.
  3. No muestre al Liveness un rostro de otro dispositivo como celulares o cámaras digitales, si hace eso, la prueba de vida no será aprobada y no podrá seguir con el proceso.
  4. No mostrar videos de personas o el rostro de una persona desde dispositivos como celulares o cámaras digitales, si lo hace el Liveness reconocerá el rostro.
  5. No mostrar más de un rastro en Liveness o que otra persona cruce cuando está capturando la imagen, si lo hace la captura no se ejecutará hasta que solo reconozca un solo rostro dentro del marco.
  6. Trate de que el fondo de captura de imagen en Liveness sea los más limpia posible, que no halla objetos o utensilios detrás de la persona, no estar a contraluz, para que el rostro sea claro de ver.
  7. No muestre animales al Liveness, ya que solo reconoce rostros de personas, si muestra algún tipo de animal, el Liveness no capturar la imagen.

CONTÁCTENOS SOPORTE

Este contacto es directamente con ADO después de la verificación directa de mesa de ayuda por parte del cliente. Teléfono: +57 314 585 5329    Correo: soporte@ado-tech.com