Metadados do Dispositivo

Markdown

Esta capacidade devolve os dados do dispositivo em que o usuário fez a captura, junto com os resultados dos outros produtos contratados.

O que faz

Coleta os metadados do dispositivo usado na sessão de captura e os sinais de risco detectados nele (detalhe dos dados abaixo).

Não é uma validação: nunca aprova nem reprova o processo, e nunca faz o processo falhar. Use os dados nas suas próprias regras de risco ou motores internos de decisão.

Entradas

Nenhum campo extra é necessário. A capacidade usa a sessão de captura que o processo já tem.

• Web: a captura feita na jornada da Unico.
• API com o SDK da Unico: a captura feita pelo SDK da Unico no seu app.

Os metadados dependem do SDK da Unico

Quem coleta os metadados é o SDK da Unico, durante a captura. Uma integração via API pode usar o SDK da Unico ou não:

• API com o SDK da Unico: os metadados vêm normalmente.
• API sem o SDK da Unico: não há metadados, e a resposta é not_found.

A capacidade é habilitada em um fluxo contratado para a sua conta. Fale com o seu contato na Unico para habilitar.

Respostas possíveis

O resultado vem no objeto authenticationInfo.deviceMetadata de Obter Processo.

status	Significado
found	Os metadados do dispositivo foram encontrados. Os campos abaixo vêm preenchidos com o que o dispositivo coletou.
not_found	Não há metadados do dispositivo para esta captura, por exemplo um processo via API sem o SDK da Unico.
unavailable	Não foi possível buscar os metadados naquele momento. O resultado do processo não é afetado.

Quando o status é found:

Campo	Tipo	Descrição
deviceId	string	Identificador do dispositivo.
platform	string	Plataforma de onde veio a captura, por exemplo WEB, ANDROID, IOS.
ip	string	Endereço IP do dispositivo.
ipCountry	string	País do endereço IP.
ipGeoCoordinates	object	Localização do endereço IP (lat, lng).
gpsCoordinates	object	Localização informada pelo GPS do dispositivo (lat, lng).
osName	string	Nome do sistema operacional.
osVersion	string	Versão do sistema operacional.
browserName	string	Nome do navegador. Só na web.
userAgent	string	User agent do navegador. Só na web.
appStore	string	Loja de onde o seu app foi instalado. Só no SDK nativo.
detectedSignals	array de strings	Grupos de sinais de risco detectados no dispositivo. Vazio quando nenhum foi detectado.

Um campo ausente significa que o dispositivo não coletou aquele dado.

detectedSignals lista só os grupos detectados. Um grupo é detectado quando pelo menos um dos sinais dele foi encontrado:

Grupo	O que significa
origin_obfuscated	A origem real do acesso está escondida, por exemplo por Tor ou ferramentas anti-fingerprinting.
untrusted_location	A localização pode ser falsa, por exemplo por proxy, VPN ou simulador de GPS.
environment_altered	O ambiente do dispositivo está alterado, por exemplo um emulador ou um dispositivo com root ou jailbreak.
app_manipulated	O app foi adulterado, interceptado (hooking) ou depurado.
assisted_session	Outra pessoa pode estar conduzindo a sessão, por exemplo por compartilhamento de tela ou bot.
payload_untrusted	Os dados enviados pelo dispositivo foram adulterados.

Nem todo sinal existe em toda plataforma, então o mesmo dispositivo pode mostrar grupos diferentes na web e no SDK nativo.

Disponibilidade

Componentes de integração necessários
SDK Web or SDK

Combinações válidas

Metadados do Dispositivo não faz parte dos fluxos pré-compostos em Fluxos disponíveis. Pode ser habilitada junto com qualquer outro produto da Unico nas integrações Web e SDK, em um fluxo contratado para a sua conta.

Produtos que utilizam esta capacidade

Pode ser adicionada a qualquer produto da Unico nas integrações Web e SDK.