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.

• Contrato Web & Native: habilitada em um fluxo contratado para a sua conta. O processo lista PROCESS_CAPACITY_DEVICE_METADATA em capacities.
• Contrato API: habilitada na Recipe da sua API key.

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.

Fale com o seu contato na Unico para habilitar.

Respostas possíveis

O resultado vem num objeto deviceMetadata:

• Contrato Web & Native: em authenticationInfo.deviceMetadata de Obter Processo.
• Contrato API: em 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 que o dispositivo não coletou vem ausente no contrato Web & Native e null no contrato API.

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

Superfície	Suportado
SDK (Android, iOS, Flutter)	✅
Web (iFrame, Redirect)	✅

Combinações válidas

Metadados do Dispositivo não faz parte do catálogo de flow pré-compostos em Fluxos disponíveis. É habilitada em um fluxo contratado para a sua conta (contrato Web & Native) ou na Recipe da sua API key (contrato API), e pode ser habilitada junto com qualquer outro produto da Unico nas integrações Web e SDK.

Casos de uso que utilizam esta capacidade

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