---
title: Metadados do Dispositivo
description: Capacidade que devolve os metadados do dispositivo usado na captura, como plataforma, IP, localização e os sinais de risco detectados nele.
canonical: https://developer.unico.io/pt-BR/capabilities/device-metadata
locale: pt-BR
generated_by: markdown-export
---

# Metadados do Dispositivo

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](/pt-BR/developers/api-reference/get-process).

| `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](/pt-BR/developers/start/flows). 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.

Última atualização em **28 de out. de 2026**