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对象。

初始化示例：

ALIYUN_FP.use('um', (state, um) => {
  if (state === 'loaded') {
    um.init({
        //这里填写风险识别控制台申请的 AppKey
        appKey: 'your_app_key',
        //这里填写 Web 应用名称，客户自定义
        appName: 'your_web_app_name'
        //endpoints : ['https://cloudauth-device.aliyuncs.com']
    }, (state) => {
        // state = success 表示初始化成功
        console.info(state);
    });
  }
});

重要

如果不指定服务地址，则endpoints会读取默认配置。

endpoints可选服务地址：

地域	地址
国内（默认）	https://cloudauth-device.aliyuncs.com

getToken接口

获取设备指纹deviceToken，建议在发起业务行为的时候调用一次，和初始化接口之间的时间差至少2秒以上（保证初始化成功完成后再调用）。

window.z_um.getToken();

//传入bizId，可以将本次 token 和业务唯一认证 ID 绑定。
window.z_um.getToken(bizId);

接入示例

<body>
<button type="button" id='register' onclick="login();">登录</button>
<script type="text/javascript" src="https://o.alicdn.com/captcha-frontend/aliyunFP/fp.min.js"></script>
<script>

//在页面加载的时候第一时间初始化
ALIYUN_FP.use('um', (state, um) => {
  if (state === 'loaded') {
    um.init({
        appKey: 'your_app_key',
        appName: 'your_web_app_name'
        //endpoints : ['https://cloudauth-device.aliyuncs.com']
    }, (state) => {
         //success 表示初始化成功
         console.info(state);
      });
  }
});

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

</script>
</body>

调用风险识别 API 接口

将 deviceToken 与其他参数，参考服务端API接口接入，请求风险识别 API 接口进行识别。

设备风险SDK Web/H5接入

嵌入JS SDK

init接口

getToken接口

接入示例

调用风险识别 API 接口

常见问题