阿里云首页 风险识别

设备风险识别事件及返回参数

设备风险识别产品主要适用于对移动APP上,有效助力企业生成唯一性设备ID,甄别设备环境异常,包括:模拟器检测、多开检测、恶意工具检测、恶意篡改设备参数等。设备风险识别产品可以应用到注册、登录、下单、领券等业务场景,通过传入设备信息,精准识别设备风险,有效打击黑灰产行为。

版本介绍

为匹配不同行业、企业不同发展阶段的风控需求,设备风险识别分为基础版、增强版,两者的差异对比如下:

功能特性

基础版

增强版本

实时计算

支持

支持

服务返回

风险标签

风险标签、设备唯一ID

日志服务(SLS)投递

不支持

支持,用户可授权进行日志投递,免费存储一年

服务事件参数

服务事件参数是指公共参数中ServiceParameters字段的请求参数,为JSON格式。以下表格为设备风险识别服务(含基础版、增强版)事件需传入的请求参数。

设备风险SDK(适用于Android、iOS原生APP)

字段名称

字段描述

数据格式

样例数据

是否必填

备注说明

deviceToken

通过设备风险SDK获取deviceToken

String

Tk9SSUQuMS***************************ZDNmNWY5NzQxOW1oLTE2MjI2NDIyNjc4MzAtZmIwODAwOGE2NGZWFhdDgzMTBLUlVSU0VoWWVNcW82ZkZlZWJBY0s0QmFGOGNyT3poY2txZXVqRjMyc1lCaDdBL2pzRTRPdXhmZjU5NEgxcGlQMGFEU1AwajZpa1ZTQ1FlbE5IQmZkTklZVzVkV2VDM1hHNUMreVRtMXFFemp3PT0=

正常情况下token的长度在600字节左右,在网络较差的场景下token长度会超过2.5K。如果出现了大量的长token,请先检查客户端的网络是否畅通,其次请确保SDK的init接口和getSession接口调用间隔大于2秒。

JS_SDK(适用于web/H5/wap)

字段名称

字段描述

数据格式

样例数据

是否必须

uaToken

通过JS版SDK获取uaToken

String

114#1JEIyxQYTTob/sbrMoRUrCPGm3cY+KzCOPdgR+S5yBRYGOGvOQ7a/y31ZkEW9j7Nu30JbRCk0RS8QdcB9XAfgqqQWVOqdQYpp1wQ29bhnA0HI5rKMJ7RbJCaNPFFYHgZKs8q889wQn

webUmidToken

通过JS版SDK获取webUmidToken

String

HV02PAAZ0b0b524c2a784b8e5c18ddb90851893e100024

返回参数

设备风险识别服务的返回参数包括风险标签、设备ID,其中设备ID仅增强版支持返回。设备风险识别服务返回参数Data字段中tags字段部分标签含义如下:

释义

is_emulator

设备疑似模拟器

is_rooted

设备疑似root

is_virtual

疑似多开环境

.......

您可以登录风险识别控制台进入接入管理模块查看更多设备标签释义,点击前往

关于公共返回参数的更多信息,请参见公共返回参数

首页 风险识别 API服务指南 设备风控服务 设备风险识别事件及返回参数