设备风险 SDK Harmony 接入

前提条件

• 设备风险 SDK 需要在 Harmony Next（0.0.71）及以上版本的系统运行，API 版本最低支持 12。

• 不支持模拟器模式调试。

• 仅支持开启字节码打包方案。

权限说明

为增强风险识别的识别效果，当前 SDK 需要以下权限：

下载和配置 Harmony SDK

1. 下载 Harmony SDK，并完成解压。SDK 为 Harmony 标准的.har 包。

2. 将.har 文件拷贝到工程中存放 har 包的目录。建议参考鸿蒙官方文档放至 libs 目录下，在工程根目录的 oh-package.json5 添加认证包的版本依赖树管理。

3. 修改项目工程中的 oh-package.json5 文件，在 dependencies 中添加 AliyunDevice 依赖包，示例如下：

   {
     "dependencies": {
       "aliyundevice": "file:../libs/HarmonyOS-AliyunDevice-xxx.har"
     }
   }

接口混淆配置

为避免接口被混淆而造成功能异常，请查看.har 包中 obfuscation.txt 文件中的配置，请勿移除该文件。若在部分版本编译器中发现混淆配置无法合并，导致无法正常接入，需要在应用的主工程打包添加 har 包中的混淆配置文件obfuscation-rules.txt，并将混淆配置添加到当前工程中。

接口说明

Harmony SDK 包含初始化（initWithOptions）和获取 Token（getDeviceToken）两个核心接口。完成下载配置后，按以下流程接入：

1. 初始化（initWithOptions）

2. 获取客户端 Token（getDeviceToken）

3. 携带 Token 请求服务端

状态返回值

示例代码

初始化设备风险 SDK，initWithOptions 接口需要在 APP 启动时尽可能早地调用。

其中，参数 ALIYUN_APPKEY 用于标识用户身份，可在阿里云控制台的设备 App 管理申请获取。

SecurityDevice.getInstance().initWithOptions(getContext(),
                             this.ALIYUN_APPKEY, null, null);

在业务需要风险识别的场景下（如注册、活动推广等）获取客户端 Token 并上报到业务的服务器端。确保 initWithOptions 和 getDeviceToken 接口的调用间隔在 2 秒以上。

let tokenObj: SecurityToken = SecurityDevice.getInstance().getDeviceToken();
if (tokenObj.code == SecurityCode.SC_SUCCESS) {
  console.log("Aliyun Token: " + tokenObj.token);
} else {
  console.log("Aliyun Code: " + tokenObj.code);
}

完整代码示例：

import { SecurityCode, SecurityToken, SecurityDevice } from 'aliyundevice';

@Entry
@Component
struct Index {
  @State message: string = 'Aliyun Device';
  @State ALIYUN_APPKEY: string = "XXX";

  build() {
    Row() {
      Column() {
        Button(this.message)
          .fontSize(18)
          .fontWeight(FontWeight.Bold)
          .onClick((event: ClickEvent) => {
            // 初始化 SDK
            SecurityDevice.getInstance().initWithOptions(getContext(), this.ALIYUN_APPKEY, null, null);

            // 延时 2 秒获取 Token
            setTimeout(() => {
              let tokenObj: SecurityToken = SecurityDevice.getInstance().getDeviceToken();
              if (tokenObj.code == SecurityCode.SC_SUCCESS) {
                console.log("Aliyun Token: " + tokenObj.token);
              } else {
                console.log("Aliyun Code: " + tokenObj.code);
              }
            }, 2000);
          })
          .margin({ top: 10 })
      }
      .width('100%')
    }
    .height('100%')
  }
}

调用风险识别 API 接口

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

常见问题

关于设备风控 SDK 的常见问题，请参见SDK常见问题。