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

# Метаданные устройства

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

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

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

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

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

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

- **Web:** захват, выполненный в пути Unico.
- **API с SDK Unico:** захват, выполненный SDK Unico в вашем приложении.

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

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

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

Результат возвращается в объекте `authenticationInfo.deviceMetadata` в [Получение процесса](/ru/developers/api-reference/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` | массив строк | Группы сигналов риска, обнаруженных на устройстве. Пустой, если ничего не обнаружено. |

Отсутствие поля означает, что устройство не собрало эти данные.

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

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

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

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

| Необходимые компоненты интеграции |
| --- |
| SDK  Web or SDK |

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

Метаданные устройства не входят в предварительно составленные потоки в разделе [Доступные потоки](/ru/developers/start/flows). Возможность можно включить вместе с любым другим продуктом Unico в интеграциях Web и SDK, в потоке, подключённом для вашего аккаунта.

### Продукты, использующие эту возможность

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

Последнее обновление **28 окт. 2026 г.**