设备风险SDK Android接入

前提条件

• 设备风险SDK需在Android 4.0.3+（minSdkVersion版本15+）以上版本的系统运行。

• 为帮助落实针对您产品集成第三方SDK情况所应履行的隐私合规义务，降低隐私违规风险，进而实现您产品合规运营的业务目标，请您务必确保选用阿里云文档中心官网发布的最新版本产品。在使用设备风险识别前，请您务必仔细了解个人信息处理规定及《风险识别SDK隐私权政策》，并按照《设备风险识别SDK合规使用说明》进行接入。

权限说明

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

下载和配置SDK

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

2. 拷贝SDK的aar文件到工程的libs目录下，并在App的build.gradle中添加以下依赖关系：

// 设备风险识别SDK
implementation files('libs/Android-AliyunDevice-版本号.aar')

// 三方网络库依赖
implementation 'com.squareup.okhttp3:okhttp:3.11.0'
implementation 'com.squareup.okio:okio:1.14.0'

注意：三方网络库不能省略，否则会造成设备风险识别SDK无法联网。

信息采集

完成信息采集，在进行风险识别的时候，您需要在满足合规要求下尽可能早的调用该函数 。

• 函数原型

public interface SecurityInitListener {
    // code表示接口调用状态码
    void onInitFinish(int code);
}
public void initWithOptions(Context ctx, 
                 	String appKey, 
                	Map<String, String> options,
                 	SecurityInitListener securityInitListener);

• 参数

  ctx：当前Application Context，或Activity Context。

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

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

securityInitListener：设备风险SDK信息采集回调接口，可在回调中判断信息采集是否成功。其中，code字段取值范围可参考“状态返回值”。

• 返回值

  无。

获取客户端Token

获取客户端Token，并上报到业务服务器，后续通过服务器端设备风险识别事件及返回参数，从而获取设备风险信息。

• 函数原型

public class SecurityToken {
    // 接口调用状态码
    public int code;
    
    // 用于服务器端查询结果的token字符串。
    public String token;
}

public SecurityToken getDeviceToken();

• 返回值

  SecurityToken类型。

  code：返回接口调用状态码，用于判断接口调用是否成功。code字段取值范围可参考“状态返回值”。

  token：返回客户端Token字符串信息，可用于业务后续查询阿里云设备风险识别接口。

注意（非常重要）：

1. getDeviceToken接口相对较耗时，务必在App非主线程调用，否则可能引起ANR导致App Crash。

2. 因数据上报可能存在延迟，请确保SDK的信息采集接口和getDeviceToken接口调用时间间隔2秒以上。

3. Token字符串在网络环境良好的场景下，长度为600字节左右；在网络环境较差的场景下，返回的长度在2.5K左右。

状态返回值

示例代码

设备风险SDK信息采集，信息采集接口需要在满足合规的要求下，尽可能早的时候调用。

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

您可以通过参数Option中DataType字段，用于配置采集的具体数据，满足具体业务场景的隐私要求。

public class CustomApplication extends Application {
    private static String ALIYUN_APPKEY = "xxxx";

    @Override
    public void onCreate() {
        super.onCreate();

        //增加隐私数据采集开关，不采集NO_IDENTIFY_DEVICE_DATA类型数据，多选使用｜进行拼接。
        Map<String, String> options = new HashMap<>();      
        options.put("DataType", String.valueOf(NO_IDENTIFY_DEVICE_DATA));
        
        // 通过设备风险SDK采集信息，信息采集接口需要在风险场景中尽可能早的时候调用。
        SecurityDevice.getInstance().initWithOptions(this, ALIYUN_APPKEY, options, null);
    }
}

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

另外，getDeviceToken接口比较耗时，切勿在UI线程中调用。

new Thread() {
    @Override
    public void run() {
        SecurityToken st = SecurityDevice.getInstance().getDeviceToken();
        if(null != st){
            if(SecurityCode.SC_SUCCESS == st.code){
                Log.d("AliyunDevice", "token: " + st.token);

                // 发送token到业务自有服务器并查询阿里云设备风险识别接口。
                // sendToAPPServer(st.token);
            } else {
                Log.e("AliyunDevice", "getDeviceToken error, code: " + st.code);
            }
        } else {
            Log.e("AliyunDevice", "getDeviceToken is null.");
        }
    }
}.start();

接口混淆配置

-keep class net.security.device.api.** {*;}
-dontwarn net.security.device.api.**

调用风险识别API接口

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

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

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

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

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

常见问题答疑

1. 设备风险识别SDK支付哪些架构？

目前支持arm、armv7和arm64三个架构。

2. SDK的大小是多少？

单架构的SO文件在1.8M左右。

设备风险识别SDK为了保证自身的抗逆向性以及数据在网络传输过程中的安全性，SDK中有大量的插花、膨胀及加解密操作，所以SDK体积会相对较大。

3. 为什么获取的token这么长？

正常情况下token的长度在600字节左右，2.5K以上的长token只会出现在网络较差的场景下。

如果业务上出现了大量的长token，首先请确保客户端的网络是畅通的；其次，请确保SDK的信息采集接口和getDeviceToken接口调用能间隔2秒以上。