设备风险 SDK iOS 接入

1.初始化（initDevice）

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

• 函数原型

@interface SecurityDevice : NSObject
/**
 *  设备指纹初始化函数
 */
- (void)initDevice:(NSString *)userAppKey :(void (^)(int))initCallback;

/**
 * 带参数的初始化
 */
- (void)initDevice:(NSString *)userAppKey withOptions:(NSMutableDictionary *)options callback:(void (^)(int))initCallback;

@end

参数说明

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

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

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

DataType参数说明

CustomUrl和CustomHost参数说明

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

• 调用示例

NSMutableDictionary *options = [[NSMutableDictionary alloc] init];
[options setValue:@"0" forKey:@"IPv6"];       // 设置IPv4
// 设置自定义的数据上报地域
// [options setValue:@"xxx" forKey:@"CustomUrl"];  设置上报站点Url
// [options setValue:@"xxx" forKey:@"CustomHost"]; 设置上报站点Host

// 标准调用(推荐)
[[SecurityDevice sharedInstance] initDevice:@"******" withOptions:options callback:nil];

// 回调调用
[[SecurityDevice sharedInstance] initDevice:@"******" withOptions:options callback:^(int code) {
    NSString * initResult = [NSString stringWithFormat: @ "初始化结果 %d", code];
    NSLog(@ "%@", initResult);

    if (SC_SUCCESS != code) {
        NSLog(@ "初始化失败");
    } else {
        NSLog(@ "初始化成功");
    }
}];

2.获取客户端 Token（getDeviceToken）

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

• 确保initDevice接口和getDeviceToken接口调用时间间隔 2 秒以上，或者在初始化成功回调后调用。

• 调用getDeviceToken时建议传入 bizId，可以将本次 token 和业务唯一 ID 绑定，后在服务端查询结果时将 ID 一起传入，并确保客户端传入 bizId 和服务端传入 ID 一致，可校验 Token 被篡改的风险。

• 建议在 App 非主线程上调用 getDeviceToken 接口，以避免接口调用耗时可能导致的崩溃。

• 函数原型

@interface SecurityDevice : NSObject
- (SecurityToken *)getDeviceToken;
- (SecurityToken *)getDeviceToken:(NSString *)bizId;
@end

• 调用示例

// 推荐传入bizId,防止deviceToken被篡改
NSString *bizId = @"1234567890abcdef******";
SecurityToken *deviceToken = [[SecurityDevice sharedInstance] getDeviceToken:bizId];

if (deviceToken == nil || SC_SUCCESS != deviceToken.code) {
    NSLog(@"获取token失败, Code: %@", deviceToken.code);
} else {
    NSLog(@"获取token成功, 后续可以正常查询风险标签. Token: %@", deviceToken.token);
}

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

3.携带 Token 请求服务端

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