---
title: Метаданные устройства
description: Возможность, которая возвращает метаданные устройства, использованного при захвате, такие как платформа, IP, местоположение и обнаруженные на нём сигналы риска.
canonical: https://developer.unico.io/ru/dual-api/capabilities/device-metadata
locale: ru
generated_by: markdown-export
---

Эта возможность возвращает данные устройства, с которого пользователь выполнил захват, вместе с результатами других подключённых продуктов.

### Что она делает

Собирает метаданные устройства, использованного в сессии захвата, и обнаруженные на нём сигналы риска (подробности о данных ниже).

Это не проверка: она никогда не одобряет и не отклоняет процесс и никогда не приводит к его сбою. Используйте данные в собственных правилах оценки риска или внутренних механизмах принятия решений.

### Входные данные

Дополнительные поля не нужны. Возможность использует сессию захвата, которая уже есть у процесса.

- **Web & Native контракт:** включается в потоке, подключённом для вашего аккаунта. Процесс указывает `PROCESS_CAPACITY_DEVICE_METADATA` в `capacities`.
- **API контракт:** включается в Recipe вашего API-ключа.

> **Предупреждение: Метаданные зависят от SDK Unico**
>
> Именно SDK Unico собирает метаданные во время захвата. Интеграция через API может использовать SDK Unico, а может и не использовать:
>
> - **API с SDK Unico:** метаданные возвращаются как обычно.
> - **API без SDK Unico:** метаданных нет, и ответ равен `not_found`.

Чтобы включить её, свяжитесь с вашим контактным лицом в Unico.

### Возможные ответы

Результат возвращается в объекте `deviceMetadata`:

- **Web & Native контракт:** в `authenticationInfo.deviceMetadata` в [Получение процесса](/dual-api/developers/api-reference/web-sdk/get-process).
- **API контракт:** в `deviceMetadata` в [Получение процесса](/dual-api/developers/api-reference/api/get-process).

| `status` | Значение |
|---|---|
| `found` | Метаданные устройства найдены. Поля ниже заполнены данными, собранными устройством. |
| `not_found` | Для этого захвата нет метаданных устройства, например в процессе через API без SDK Unico. |
| `unavailable` | Не удалось получить метаданные в этот момент. Это не влияет на результат процесса. |

Когда `status` равен `found`:

| Поле | Тип | Описание |
|---|---|---|
| `deviceId` | string | Идентификатор устройства. |
| `platform` | string | Платформа, с которой выполнен захват, например `WEB`, `ANDROID`, `IOS`. |
| `ip` | string | IP-адрес устройства. |
| `ipCountry` | string | Страна IP-адреса. |
| `ipGeoCoordinates` | object | Местоположение IP-адреса (`lat`, `lng`). |
| `gpsCoordinates` | object | Местоположение, переданное GPS устройства (`lat`, `lng`). |
| `osName` | string | Название операционной системы. |
| `osVersion` | string | Версия операционной системы. |
| `browserName` | string | Название браузера. Только Web. |
| `userAgent` | string | User agent браузера. Только Web. |
| `appStore` | string | Магазин приложений, из которого установлено ваше приложение. Только нативный SDK. |
| `detectedSignals` | массив строк | Группы сигналов риска, обнаруженных на устройстве. Пустой, если ничего не обнаружено. |

Поле, которое устройство не собрало, отсутствует в Web & Native контракте и равно `null` в API контракте.

`detectedSignals` перечисляет только обнаруженные группы. Группа считается обнаруженной, если найден хотя бы один из её сигналов:

| Группа | Что это означает |
|---|---|
| `origin_obfuscated` | Реальный источник доступа скрыт, например с помощью Tor или инструментов против фингерпринтинга. |
| `untrusted_location` | Местоположение может быть ложным, например из-за прокси, VPN или подмены GPS. |
| `environment_altered` | Среда устройства изменена, например эмулятор или устройство с root-доступом или jailbreak. |
| `app_manipulated` | Приложение было изменено, перехвачено (hooking) или запущено под отладчиком. |
| `assisted_session` | Сессией может управлять кто-то другой, например через демонстрацию экрана или бот. |
| `payload_untrusted` | Данные, отправленные устройством, были изменены. |

Не каждый сигнал существует на каждой платформе, поэтому одно и то же устройство может показывать разные группы в Web и в нативном SDK.

### Доступность

| Поверхность | Поддерживается |
|---|:-:|
| **SDK** (Android, iOS, Flutter) | ✅ |
| **Web** (iFrame, Redirect) | ✅ |

### Допустимые комбинации

Метаданные устройства не входят в предварительно составленный каталог `flow` в разделе [Доступные потоки](/dual-api/capabilities/available-flows). Возможность включается в потоке, подключённом для вашего аккаунта (Web & Native контракт), или в Recipe вашего API-ключа (API контракт), и её можно включить вместе с любым другим продуктом Unico в интеграциях Web и SDK.

### Сценарии использования, использующие эту возможность

Её можно добавить к любому сценарию использования Unico в интеграциях Web и SDK.