Metadatos del Dispositivo

Markdown

Esta capacidad devuelve los datos del dispositivo desde el que el usuario realizó la captura, junto con los resultados de los demás productos contratados.

Qué hace

Recopila los metadatos del dispositivo utilizado en la sesión de captura y las señales de riesgo detectadas en él (detalle de los datos más abajo).

No es una validación: nunca aprueba ni rechaza el proceso, y nunca hace que el proceso falle. Utiliza los datos en tus propias reglas de riesgo o motores de decisión internos.

Entradas

No se necesita ningún campo adicional. La capacidad utiliza la sesión de captura que el proceso ya tiene.

• Contrato Web & Native: se habilita en un flujo contratado para tu cuenta. El proceso incluye PROCESS_CAPACITY_DEVICE_METADATA en capacities.
• Contrato API: se habilita en la Recipe de tu clave de API.

Los metadatos dependen del SDK de Unico

El SDK de Unico es quien recopila los metadatos, durante la captura. Una integración por API puede usar o no el SDK de Unico:

• API con el SDK de Unico: los metadatos se devuelven normalmente.
• API sin el SDK de Unico: no hay metadatos, y la respuesta es not_found.

Habla con tu contacto de Unico para habilitarla.

Respuestas posibles

El resultado llega en un objeto deviceMetadata:

• Contrato Web & Native: en authenticationInfo.deviceMetadata de Obtener proceso.
• Contrato API: en deviceMetadata de Obtener proceso.

status	Significado
found	Se encontraron los metadatos del dispositivo. Los campos siguientes se completan con lo que el dispositivo recopiló.
not_found	No hay metadatos del dispositivo para esta captura, por ejemplo un proceso por API sin el SDK de Unico.
unavailable	No fue posible obtener los metadatos en ese momento. El resultado del proceso no se ve afectado.

Cuando status es found:

Campo	Tipo	Descripción
deviceId	string	Identificador del dispositivo.
platform	string	Plataforma desde la que se realizó la captura, por ejemplo WEB, ANDROID, IOS.
ip	string	Dirección IP del dispositivo.
ipCountry	string	País de la dirección IP.
ipGeoCoordinates	object	Ubicación de la dirección IP (lat, lng).
gpsCoordinates	object	Ubicación informada por el GPS del dispositivo (lat, lng).
osName	string	Nombre del sistema operativo.
osVersion	string	Versión del sistema operativo.
browserName	string	Nombre del navegador. Solo Web.
userAgent	string	User agent del navegador. Solo Web.
appStore	string	Tienda de aplicaciones desde la que se instaló tu app. Solo SDK nativo.
detectedSignals	array of strings	Grupos de señales de riesgo detectadas en el dispositivo. Vacío cuando no se detectó ninguna.

Un campo que el dispositivo no recopiló está ausente en el contrato Web & Native y es null en el contrato API.

detectedSignals enumera solo los grupos detectados. Un grupo se detecta cuando se encontró al menos una de sus señales:

Grupo	Qué significa
origin_obfuscated	El origen real del acceso está oculto, por ejemplo por Tor o herramientas anti-fingerprinting.
untrusted_location	La ubicación puede ser falsa, por ejemplo por un proxy, una VPN o un GPS spoofer.
environment_altered	El entorno del dispositivo está alterado, por ejemplo un emulador o un dispositivo con root o jailbreak.
app_manipulated	La app fue manipulada, interceptada (hooking) o depurada.
assisted_session	Otra persona puede estar conduciendo la sesión, por ejemplo mediante pantalla compartida o un bot.
payload_untrusted	Los datos enviados por el dispositivo fueron manipulados.

No todas las señales existen en todas las plataformas, por lo que el mismo dispositivo puede mostrar grupos diferentes en web y en el SDK nativo.

Disponibilidad

Superficie	Compatible
SDK (Android, iOS, Flutter)	✅
Web (iFrame, Redirect)	✅

Combinaciones válidas

Metadatos del Dispositivo no forma parte del catálogo de flow precompuestos en Flujos disponibles. Se habilita en un flujo contratado para tu cuenta (contrato Web & Native) o en la Recipe de tu clave de API (contrato API), y puede habilitarse junto con cualquier otro producto de Unico en integraciones Web y SDK.

Casos de uso que utilizan esta capacidad

Puede añadirse a cualquier caso de uso de Unico en integraciones Web y SDK.