文档

设备风险识别JS H5/web接入

更新时间:

在需要保护的页面嵌入JS SDK,注意:一个网页(包括单页应用)嵌入一次即可。

嵌入JS SDK

<script src="https://o.alicdn.com/captcha-frontend/aliyunFP/fp.min.js"></script>

注意:因js文件会定期更新,为避免js失效影响您的使用,请不要将js下载到本地服务器上引入。

init接口

嵌入JS SDK之后,可以立即通过SDK收集信息(只需采集一次),以获取SDK对象。

采集示例:

let umModule;
let deviceToken;
ALIYUN_FP.use('um', (state, um) => {
  if (state === 'loaded') {
    umModule = um;
    um.init({
        appKey: '【这里填写风险识别控制台申请的AppKey】',
        appName: '【这里填Web应用名称,客户自定义】'
        //endpoints : ['https://cloudauth-device.aliyuncs.com']
    }, (initStats) => {
      if (initStats === 'success') {
        //如果需要init完成就获取token,则在这里获取。
        //deviceToken = umModule.getToken();
      }
    });
  }
});

endpoints填写建议,如果不填为默认。

国内(默认):['https://cloudauth-device.aliyuncs.com']

国际:['https://cloudauth-device.ap-southeast-1.aliyuncs.com']

getToken接口

获取设备指纹deviceToken,建议在发起业务行为时调用一次。

umModule.getToken();

接入示例

<body>
<button type="button" id='register' onclick="loginForm();">登录</button>
<script type="text/javascript" src="https://o.alicdn.com/captcha-frontend/aliyunFP/fp.min.js"></script>
<script>
let umModule;
let deviceToken;
ALIYUN_FP.use('um', (state, um) => {
  if (state === 'loaded') {
    umModule = um;
    um.init({
        appKey: '【这里填写风险识别控制台申请的AppKey】',
        appName: '【这里填Web应用名称,客户自定义】'
        //endpoints : ['https://cloudauth-device.aliyuncs.com']
    }, (initStats) => {
      if (initStats === 'success') {
        //如果需要页面init完成就获取token,则在这里获取。
        //deviceToken = umModule.getToken();
      }
    });
  }
});

//处理业务函数,比如登录
function loginForm(){
    //获取设备指纹的deviceToken,getToken和init之间最好相隔2s以上。
    deviceToken = umModule.getToken();
    //将deviceToken传入客户的服务后台
    var data = {
           "deviceToken": deviceToken,
           "其他业务参数":""
     };
    //发送后台请求...后台通过deviceToken查询风险信息
}

</script>
</body>

调用风险识别API接口

将deviceToken与其他参数,根据如下相应的风险识别服务事件参数文档说明,请求风险识别API接口进行识别:

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

注册风险识别功能及参数说明

营销风险识别功能及参数说明

登录风险识别功能及参数说明

流量推广反作弊功能及参数说明

  • 本页导读 (0)
文档反馈