---
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/dual-api/capabilities/device-metadata
locale: pt-BR
generated_by: markdown-export
---

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.

> **Aviso: 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](/dual-api/developers/api-reference/web-sdk/get-process).
- **Contrato API:** em `deviceMetadata` de [Obter Processo](/dual-api/developers/api-reference/api/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 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](/dual-api/capabilities/available-flows). É 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.