设备风险 SDK Harmony 接入

1. 初始化（initWithOptions）

该函数用于完成 SDK 初始化和信息采集。在进行风险识别时，需要在满足合规要求的情况下尽可能早地调用。该函数一次 APP 启动后只需要调用一次。

• 函数原型

export class SecurityInitListener {
  // code 表示接口调用状态码
  onInitFinish(code: number): void {}
}

public initWithOptions(ctx: Context,
                userAppKey: string,
                options: Map<string, string>,
                securityInitListener: SecurityInitListener): void;

• 参数说明

  • ctx：当前 Ability 的 Context。

  • userAppKey：用于标识用户身份，可在阿里云控制台的设备 App 管理申请获取。

  • securityInitListener：初始化回调监听接口，可在回调中判断初始化是否成功，默认可以为 null。code 字段取值范围参考"状态返回值"。

  • options：信息采集可选项，默认为 null。可选参数如下。

    字段名	说明	示例
    IPv6	是否使用 IPv6 域名上报设备信息。0（默认）：使用 IPv4 域名。1：使用 IPv6 域名。	"0"
    CustomUrl	设置数据上报服务器域名。指定站点上报时使用，默认不需要设置。	"https://cloudauth-device.aliyuncs.com"
    CustomHost	设置数据上报服务器 host。需与 CustomUrl 配对使用，默认和 CustomUrl 一起不需要设置。	"cloudauth-device.aliyuncs.com"

    CustomUrl和CustomHost参数说明

    指定站点上报，需要设置 CustomUrl 和 CustomHost 为指定地域，默认情况不需要设置。

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

• 调用示例

@State USER_PRODUCT_KEY: string = "123e4567e89b12d3a45642661417****";

let options: Map<string, string> = new Map<string, string>();
options.set("IPv6", "0"); // 设置为 IPv4
// 设置自定义的数据上报地域
// options.set("CustomUrl", "xxx"); 设置上报站点 Url
// options.set("CustomHost", "xxx"); 设置上报站点 Host

SecurityDevice.getInstance().initWithOptions(getContext(),
                            this.USER_PRODUCT_KEY, options, null);

2. 获取客户端 Token（getDeviceToken）

获取客户端 token 并上报到业务服务器，后续通过服务器端获取设备风险信息。

• 函数原型

export class SecurityToken {
   // 结果 Code
  public code:number = 0;

  // SDK 返回的 deviceToken
  public token:string = "";
}

// 推荐传入 bizId
public getDeviceToken(bizId?: string): SecurityToken

• 调用示例

// 传入 bizId 示例，bizId 为客户的业务 ID，可以选择是否传入。
let bizId = "1234567890abcdef1234567890ab****";
let tokenObj: SecurityToken = SecurityDevice.getInstance().getDeviceToken(bizId);
if (tokenObj.code == SecurityCode.SC_SUCCESS) {
  console.log("Aliyun Token: " + tokenObj.token);
} else {
  console.log("Aliyun Code: " + tokenObj.code);
}

3. 携带 Token 请求服务端

成功获取 deviceToken 后，将 deviceToken 作为参数传至业务服务端。由服务端调用阿里云设备风险识别 API 接口，传入 deviceToken 查询并校验设备风险信息。