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 más comúnmente para otorgar acceso a un dispositivo como se ve en teléfonos móviles, tabletas y PC.
Esta integración permite que su aplicación utilice varias funciones biométricas, como la tecnología de reconocimiento facial y la biometría de voz. Dado que tales calificativos son exclusivos de las personas, las soluciones de biometría facial y vocal ofrecen mayor seguridad que las medidas de seguridad tradicionales, como perfiles, contraseñas o frases de acceso, 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 esté implementada en tu ambiente ni esté habilitada para todos tus clientes. Contacta a tu administrador de sistema 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, el Sensory Truly Secure CallAPI depende de Firebase Visión. El archivo plist generado desde una consola Firebase debe agregarse a la aplicación.
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. Haga clic en cada función para ver 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: 0: Modo no compatible 1: 1: No hay usuarios inscriptos 2: 2: Inscripto | ||||||||||||||||||
291 | API Version | 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 determinados por el modo seleccionado: rostro o voz. Si la inscripción fue exitosa, la función devolverá un ID de inscripción. Este ID de inscripción se puede comparar con el obtenido en cada autenticación para verificar que se autenticó contra 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. Anula cualquier inscripción anterior existente. Disponible Y OBLIGATORIO solo para el modo FACE_TEMPLATE. | Sí | - |
394 | Política de imagen. 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 imagen aleatoria e inscribe al usuario). HARD (devuelve el 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 vida. |
396 | ID de imagen de salida. Registrar ID donde se guardará la imagen del usuario. Si no se establece, la imagen no se guardará. | No | - |
397 | Face Angle Max Error. 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: No uses 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 la 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 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íe metadatos en formato JSON con el valor del Registro 390 (Parámetros de entrada). Una vez definidos los parámetros, permanecerán activos durante la ejecución de la aplicación. Con cada invocación exitosa de esta función, se actualizan todos los parámetros enviados en el JSON. Todos los parámetros no definidos en el JSON mantendrán sus valores predeterminados.
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. Ver ejemplo abajo. {
'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 |
|