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

Markdown

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

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

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

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

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

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

• 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 в Получение процесса.
• API контракт: в deviceMetadata в Получение процесса.

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 в разделе Доступные потоки. Возможность включается в потоке, подключённом для вашего аккаунта (Web & Native контракт), или в Recipe вашего API-ключа (API контракт), и её можно включить вместе с любым другим продуктом Unico в интеграциях Web и SDK.

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

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