android安全sdk文档 -奇异果体育app竞彩官网下载
概述
android安全sdk又名——昊天sdk,是一个基于海量威胁情报数据的智能分析平台, 打通了移动、云、pc 的全链条安全数据,利用深度学习人工智能平台从海量的安全事件中进行关联分析,能感知出潜在的互联网威胁以及 apt 事件,并能对攻击阵营的基础设施和技术手段进行分析识别,告别被动防御局面, 为用户提供更加安全的互联网体验。
安装sdk工具包
安装步骤
- 创建一个新的module,导入控制台下载的aar文件,这里以hotian*.aar为例,module任意命名,以 “haotian”为例,如下图所示:
- 在自己项目的build.gradle中添加依赖,引入haotian依赖,然后sync。
dependencies {
...
compile project(': haotian)
...
}
- so包相关:aar包中包含了armeabi,armeabi-v7a,arm64-v8a,x86的so包,如果集成的app自身兼容的abi种类少于本aar,应当在build.gradle文件中,加入ndk的abifilter配置,选定本app支持的abi,以防止引入全部4种abi的so导致在指定abi上缺失其他so文件。
defaultconfig {
...
ndk {
abifilter "armeabi"
}
...
}
注意事项
以前使用jar包方式集成的如果要转换为aar集成,请一定将集成的jar包,so包和配置文件删除。
api 接口
初始化接口
程序启动后在应用的application类的oncreate中调用haotian sdk初始化代码:
hth.init(context context, string haotian_appkey, string haotian_seckey, 1);
如果app需要接入风控服务,需要在app主进程初始化sdk,确保sdk正常运行。 如果在同意隐私协议前调用初始化接口,初始化过程会被中止,并在调用同意隐私协议方法后恢复。
参数说明
string haotian_appkey和string haotian_seckey用于服务器的访问校验,这是分配给渠道集成sdk的凭证。集成之前请通过控制台申请。这两个 key 是和集成宿主的包名和签名唯一关联的。如果包名或者签名有变化需要重新申请。
延迟初始化接口
haotian sdk支持在程序启动后在应用的application类的oncreate中调用延迟初始化代码,根据传入的参数使初始化行为延迟一段时间开始,注意该接口与上面的初始化接口只能调用一个。
hth.initdelay(context context, int delayseconds, string haotian_appkey,string haotian_seckey,1)
如果app需要接入风控服务,需要在app主进程初始化haotian sdk, sdk正常运行。 如果在同意隐私协议前调用初始化接口,初始化过程会被中止,并在调用同意隐私协议方法后恢复。
参数说明
a) int delayseconds 用于延迟初始化的时间,单位是秒,初始化行为将于delayseconds秒后开始执行。
b) string haotian_appkey和string haotian_seckey用于服务器的访问校验,这是分配给渠道集成我们sdk的凭证。集成之前请向我们申请。这两个 key 是和集成宿主的包名和签名唯一关联的。如果包名或者签名有变化需要重新申请。
获取当前zid 且进行安全环境扫描接口
通过调用此接口可以获取当前zid。该值只用于获取云端安全因子的的索引,不能应用于宿主业务,且可变,同时该接口在满足传入参数条件的情况下,会进行安全环境扫描:
string zid = hth.gzfi(context context,string account_id,int host_call_env,string parm)
参数说明
a) string account_id 为账号id,可以为null。
b) int host_call_env 为eventid;这个值为安全环境扫描调用场景,等于0的时候不会调用安全环境扫描,若传入字符串3300~3400则会调用安全环境扫描,根据业务可自行选择传入。
c) sring parm 是一个json字符串,可以将自定义的参数传给安全环境扫描,可以为null。
注意
禁止在宿主中保存zid,zid的值是可变的。
设置用户同意隐私协议接口
通过调用此接口告知安全sdk用户是否同意了隐私协议。
在同意隐私协议前,所有对安全sdk的调用将不会生效,具有返回值的方法会获取到空的返回值,初始化过程会在delay结束后被中止,直到同意了隐私协议。
hth.setagreepolicy(context context, boolean agree)
参数说明
boolean agree为用户是否同意了隐私协议,true为同意,false为不同意。
绑定设备id接口
通过调用此接口绑定宿主应用定义的设备id,用于id映射。
hth.setdid(context context, string did)
参数说明
string did为宿主应用用于标识本设备的唯一id值。请尽早绑定设备id以方便进行id映射(可以在调用初始化接口前)。
多进程支持
haotian sdk支持同一宿主下多进程运行,默认是运行在主进程中。sdk 的初始化和组件配置必须在同一进程中,请注意以下几点:
a) 如果需要配置haotian sdk运行在其它进程,请将如下所有组件都通过 android:process属性配置在同一个进程中。
b) 请不要为本sdk的provider配置android:multprocess属性。
c) 如果app需要接入风控服务,需要在app主进程初始化sdk,确保sdk正常运行。