Sensory Truly Secure
La IA de verificación facial integrada de Sensory, TrulySecure, intenta validar a una persona en función de la coincidencia de una imagen facial con una imagen registrada cifrada y almacenada localmente, aceptando o rechazando la solicitud de identidad (coincidencia uno a uno). Este modelo se utiliza normalmente para conceder acceso a un dispositivo, como ocurre en teléfonos móviles, tabletas y ordenadores.
Esta integración permite a tu app utilizar varias funciones biométricas, como la tecnología de reconocimiento facial y la biometría de voz. Como esas características son exclusivas de cada persona, las soluciones de biometría facial y vocal ofrecen mayor seguridad que las medidas de seguridad tradicionales, como perfiles, contraseñas o frases de contraseña, números PIN e información personal.
Algunas de las ventajas de esta integración son las siguientes:
autenticación de usuarios por rostro, voz o una fusión entre ambos;
detección de usuario real mediante reconocimiento facial para brindar protección contra los ataques de suplantación de identidad;
FIDO UAF certificado para Android;
detección automática de voces con el tiempo, lo que permite la personalización de las apps.
Nota
Es posible que la integración descrita en este artículo no se implemente en tu ambiente ni esté habilitada para todos tus clientes. Comunícate con tu administrador para recibir ayuda.
Detalles técnicos
ID de API | 551 |
Código de la API | SENSORY_TS |
Versión de la Call API | 1.0 |
Versión del SDK | iOS: [4.4.0] Android: [3.8.2] |
Versión de la app | 5.9 |
Objetivo | Validaciones biométricas (voz, huellas digitales, rostro) |
Clasificación | Datos biométricos |
Disponible para | iOS, Android (voz no disponible para iOS) |
Aviso
En iOS desde la versión 6.5.0.11, la CallAPI de Sensory Truly Secure tiene dependencia de Firebase Vision. Es necesario agregar a la app el archivo plist (lista de propiedades) generado desde una consola Firebase.
Uso de la integración Sensory Truly Secure en Studio
Las siguientes funciones están disponibles para que las uses en tus procesos legacy y también puedes usarlas como bloques en los procesos lambda. Haz clic en cada función para obtener más detalles.
Obtiene información sobre qué vaultId admite esta API y cuáles están inscritos en este momento. | |
Inscribe a un usuario en el modo indicado. | |
Cancela la inscripción de un usuario en el modo indicado. | |
Define los parámetros de la interfaz de usuario. |
Get Status
Esta función obtiene información sobre qué vaultId admite esta API y cuáles están inscritos en este momento.
Configuración del parámetro
Esta función requiere que configures el modo de inscripción (rostro o voz) en el registro 390, como se describe en la tabla de Registros de entrada.
ID de la función
Registro | Valor |
|---|---|
110 | 1 |
Registros de entrada
Registro | Descripción | Obligatorio | Valor |
|---|---|---|---|
390 | Modo de inscripción (las opciones son FACE y VOICE para Android y solo FACE para iOS) | Sí | Modo de inscripción: FACE, FACE_TEMPLATE, VOICE |
Registros de salida
Registro | Descripción | Valor | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
112 | Resultado de la Call |
| ||||||||||||||||||
290 | Status | 0: Modo no compatible 1: No hay usuarios inscriptos 2: Inscripto | ||||||||||||||||||
291 | Versión de la API | Versión de la Call API | ||||||||||||||||||
292 | Versión del SDK | Versión del SDK de Sensory TS | ||||||||||||||||||
293 | Fecha de vencimiento | Fecha de vencimiento (formato Epoch) |
Enroll
Esta función inscribe a una persona según la captura de sus datos biométricos determinada por el modo seleccionado: cara o voz. Si la inscripción fue exitosa, la función devolverá un ID de inscripción. Este ID de inscripción puede ser comparado con el obtenido en cada autenticación para verificar que fue autenticado con los datos biométricos registrados en la inscripción.
Configuración del parámetro
Esta función requiere que configures los parámetros de entrada que se muestran en la tabla Registros de entrada.
ID de la función
Registro | Valor |
|---|---|
110 | 2 |
Registros de entrada
Registro | Descripción | Obligatorio | Valor |
|---|---|---|---|
390 | Modo de inscripción. | Sí | FACE, FACE_TEMPLATE, VOICE |
391 | Tiempo de espera en segundos. | No | Tiempo de espera en segundos. Valor por defecto: 30. |
392 | Configurar si el usuario desea extraer la plantilla biométrica. | No | 0 (no), 1 (sí). Valor por defecto: 0. |
393 | Plantilla biométrica para inscribirse. Reemplaza cualquier inscripción anterior existente. Disponible Y OBLIGATORIA solo para el modo FACE_TEMPLATE. | Sí | - |
394 | Política de imagen. Define el comportamiento de callAPI cuando no se encuentra ninguna imagen con el error máximo de ángulo facial solicitado. | No | SOFT (devuelve una imagen aleatoria e inscribe al usuario). HARD (devuelve error y no inscribe al usuario). Valor por defecto: SOFT. |
395 | Establece un nivel de seguridad de verificación de usuarios reales | No | 1 (más bajo) a 5 (más alto). Por defecto, 0: Sin verificación de usuarios reales. |
396 | ID de la imagen de salida. ID del registro donde se guardará la imagen del usuario. Si no se configura, la imagen no se guardará. | No | - |
397 | Error máximo del ángulo de rostro. Rotación máxima del ángulo del rostro tolerable (en grados) para aceptar la captura de una foto válida. | No | 0 a 360. Valor por defecto: 3. Recomendación: Evita usar valores altos. |
Registros de salida
Registro | Descripción | Valor | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
112 | Resultado de la Call |
| ||||||||||||||||||||||||||||||||||||||||||||||||
290 | ID de inscripción | ID para esta inscripción. | ||||||||||||||||||||||||||||||||||||||||||||||||
291 | Plantilla biométrica para la inscripción | Codificación biométrica del usuario base64. |
Nota
Se debe llamar a la imagen de salida usando las funciones Get Picture y Take Picture de call API Photo.
Disenroll
Esta función cancela la inscripción de una persona previamente inscrita para el modo seleccionado: rostro o voz.
Configuración del parámetro
Esta función requiere que configures el valor del registro 390 con el modo de inscripción (consulta Registros de entrada a continuación).
ID de la función
Registro | Valor |
|---|---|
110 | 4 |
Registros de entrada
Registro | Descripción | Obligatorio | Valor |
|---|---|---|---|
390 | Modo de inscripción. La función de voz solo está disponible para Android. | Sí | FACE, VOICE |
Registros de salida
Registro | Descripción | Valor | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
112 | Resultado de la Call |
| ||||||||||||||||||||
290 | ID de inscripción | ID para esta inscripción. |
Set UI Params
Esta función te permite definir textos e imágenes para personalizar la interfaz de usuario para la inscripción y la autenticación.
Configuración del parámetro
Esta función requiere que envíes los metadatos en formato JSON en el valor del registro 390 (parámetros de entrada). Una vez que se han definido los parámetros, permanecerán activos durante la ejecución de la app. Cada vez que se invoca correctamente esta función, se actualizan todos los parámetros enviados en JSON. Todos los parámetros no definidos en JSON conservarán sus valores por defecto.
Nota
Para volver a los parámetros establecidos por defecto, invoca esta función y deja el valor del registro 390 vacío.
Para saber qué parámetros pueden configurarse usando esta función, comunícate con tu administrador.
ID de la función
Registro | Valor |
|---|---|
110 | 5 |
Registros de entrada
Registro | Descripción | Obligatorio | Valor |
|---|---|---|---|
390 | Parámetros de interfaz de usuario | Sí | Lista de parámetros en formato JSON. Consulta el siguiente ejemplo. {
'img_biometrics_face_action':'alert_v',
'img_biometrics_voice_action':'tux',
'txt_voice_enroll_instruction':'Please, repeat a phrase.'
} |
Registros de salida
Registro | Descripción | Valor | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
112 | Resultado de la Call |
|