Метаданные устройства
Эта возможность возвращает данные устройства, с которого пользователь выполнил захват, вместе с результатами других подключённых продуктов.
Что она делает
Собирает метаданные устройства, использованного в сессии захвата, и обнаруженные на нём сигналы риска (подробности о данных ниже).
Это не проверка: она никогда не одобряет и не отклоняет процесс и никогда не приводит к его сбою. Используйте данные в собственных правилах оценки риска или внутренних механизмах принятия решений.
Входные данные
Дополнительные поля не нужны. Возможность использует сессию захвата, которая уже есть у процесса.
- Web: захват, выполненный в пути Unico.
- API с SDK Unico: захват, выполненный SDK Unico в вашем приложении.
Именно SDK Unico собирает метаданные во время захвата. Интеграция через API может использовать SDK Unico, а может и не использовать:
- API с SDK Unico: метаданные возвращаются как обычно.
- API без SDK Unico: метаданных нет, и ответ равен
not_found.
Возможность включается в потоке, подключённом для вашего аккаунта. Чтобы включить её, свяжитесь с вашим контактным лицом в Unico.
Возможные ответы
Результат возвращается в объекте authenticationInfo.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 | массив строк | Группы сигналов риска, обнаруженных на устройстве. Пустой, если ничего не обнаружено. |
Отсутствие поля означает, что устройство не собрало эти данные.
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 |
Допустимые комбинации
Метаданные устройства не входят в предварительно составленные потоки в разделе Доступные потоки. Возможность можно включить вместе с любым другим продуктом Unico в интеграциях Web и SDK, в потоке, подключённом для вашего аккаунта.
Продукты, использующие эту возможность
Её можно добавить к любому продукту Unico в интеграциях Web и SDK.