防劫持SDK

一、产品简介

防劫持SDK是具备防劫持兼防截屏功能的SDK，可有效防范恶意程序对应用进行界面劫持与截屏的恶意行为。

二、iOS版本

2.1 环境要求条目说明兼容平台iOS 8.0+

开发环境XCode 4.0 +

CPU架构armv7, arm64, i386, x86_64

SDK依赖libz, libresolv, libc++

2.2 SDK接入

2.2.1 DxAntiHijack获取

从顶象技术官网下载SDK或者向销售人员直接获取，下面是SDK的目录结构

DXhijack_xxx_xxx_xxx_debug.zip 防劫持debug 授权集成库 DXhijack_xxx_xxx_xxx_release.zip 防劫持release 授权集成库解压DXhijack_xxx_xxx_xxx_xxx.zip 文件，得到以下文件DXhijack 文件夹DXhijack.a 已授权静态库

Header/DXhijack.h 头文件

dx_auth_license.description 授权描述文件

DXhijackiOS.framework 已授权framework 集成库

2.2.2 将SDK接入XCode

2.2.2.1 导入静态库及头文件

将SDK目录(包含静态库及其头文件)直接拖入工程目录中，或者右击总文件夹添加文件。 或者 将DXhijackiOS.framework 拖进framework存放目录

2.2.2.2 添加其他依赖库

在项目中添加 libc++.tbd 库，选择Target -> Build Phases，在Link Binary With Libraries里点击加号，添加libc++.tbd

2.2.2.3 添加Linking配置

在项目中添加Linking配置，选择Target -> Build Settings，在Other Linker Flags里添加-ObjC配置

2.3 DxAntiHijack使用

2.3.1 方法及参数说明@interface DXhijack : NSObject

+(void)addFuzzy; //后台模糊效果

+(void)removeFuzzy;//后台移除模糊效果

@end

2.3.2 使用示例

在对应的AppDelegate.m 文件中头部插入#import "DXhijack.h"

//在AppDelegate.m 文件中applicationWillResignActive 方法调用增加

- (void)applicationWillResignActive:(UIApplication *)application {

[DXhijack addFuzzy];

}

//在AppDelegate.m 文件中applicationDidBecomeActive 方法调用移除

- (void)applicationDidBecomeActive:(UIApplication *)application {

[DXhijack removeFuzzy];

}

2.4 问题错误汇总错误码错误描述-1000 , -1101授权失败，请联系顶象客服人员

-1102试用版本已过期，请联系顶象客服人员

-1103包名相关不正确，请校对包名信息是否跟生成库提供的包名一致

三、Android版本

3.1 环境要求条目说明开发目标Android 4.0+

开发环境Android Studio 3.0.1 或者 Eclipse + ADT

CPU架构ARM 或者 x86

SDK三方依赖无

3.2 SDK接入

3.2.1 SDK获取访问顶象技术官网，注册账号

登录控制台，访问“全流程端防控->安全键盘SDK”模块

新增App，填写相关信息

下载对应平台SDK

3.2.2 SDK文件结构SDK目录结构

dx-anti-hijack-${version}.jar Android jar包

armeabi, armeabi-v7a, arm64-v8a, x86 4个abi平台的动态库文件

3.2.3 Android Studio 集成

3.2.3.1 Android Studio导入jar, so

把dx-anti-hijack-x.x.x.jar, so文件放到相应模块的libs目录下

在该Module的build.gradle中如下配置:android{

sourceSets {

main {

jniLibs.srcDirs = ['libs']

}

}

repositories{

flatDir{

dirs 'libs'

}

}

}

dependencies {

implementation fileTree(dir: 'libs', include: ['*.jar'])

}

3.2.3.2 权限声明

Android 5.0(不包含5.0)以下需要在项目AndroidManifest.xml文件中添加下列权限配置：

3.2.3.3 混淆配置-dontwarn *.com.dingxiang.mobile.**

-dontwarn *.com.mobile.strenc.**

-keep class com.security.inner.**{*;}

-keep class *.com.dingxiang.mobile.**{*;}

-keep class *.com.mobile.strenc.**{*;}

-keep class com.dingxiang.mobile.antihijack.** {*;}

3.3 DxAntiHijack 类使用

3.3.1 方法及参数说明

3.3.1.1 初始化

建议在Application的onCreate下調用/**

* 使用API前必須先初始化

* @param context

*/

public static void init(Context context);

3.3.1.2 反截屏功能/**

* 反截屏功能

* @param activity

*/

public static void DGCAntiHijack.antiScreen(Activity activity);

/**

* 反截屏功能

* @param dialog

*/

public static void DGCAntiHijack.antiScreen(Dialog dialog);

3.3.1.3 反劫持检测/**

* 调用防劫持检测，通常现在activity的onPause和onStop调用

* @return 是否存在被劫持风险

*/

public static boolean DGCAntiHijack.antiHijacking();

3.3.2 使用示例//使用反劫持方法

@Override

protected void onPause(){

boolean safe = DXAntiHijack.antiHijacking();

if(!safe){

Toast.makeText(getApplicationContext(), "App has entered the background", Toast.LENGTH_LONG).show();

}

super.onPause();

}

@Override

protected void onStop(){

boolean safe = DXAntiHijack.antiHijacking();

if(!safe){

Toast.makeText(getApplicationContext(), "App has entered the background", Toast.LENGTH_LONG).show();

}

super.onStop();

}

//使用反截屏方法

@Override

protected void onCreate(Bundle savedInstanceState){

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

DXAntiHijack.antiScreen(MainActivity.this);

}

3.4 问题错误汇总错误码错误描述-1000 , -1101授权失败，请联系顶象客服人员

-1102试用版本已过期，请联系顶象客服人员

-1103包名或签名相关不正确，请校对包名/签名信息是否跟生成库提供的包名/签名一致

其他设备运行在危险环境中，如注入、调试等环境

四、FAQ