Web/H5阿里云设备指纹SDK的接入流程和步骤_风险识别(Fraud Detection)-阿里云帮助中心

本文档介绍了设备风险SDK （Web/H5）的接入流程，在需要保护的页面嵌入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']
    });
  }
});

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']
    });
  }
});

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

</script>
</body>

调用风险识别API接口

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