​超简单集成华为系统完整性检测，搞定设备安全防护

在不安全设备，如被root或解锁的手机上，运行应用通常会伴随着一定安全风险，例如被恶意病毒或木马软件利用root权限植入病毒、篡改用户设备信息和破坏系统等。因此，如何做好应用的安全防护、避免在不安全设备环境中产生安全风险，已经成为其开发者必须要考虑的因素。对此，华为开放安全检测服务，提供系统完整性检测（SysIntegrity API），可检测应用运行的设备环境是否安全，如设备是否被root、被解锁等。

一、服务介绍

华为系统完整性检测包括以下特点：

1. 基于可信执行环境TEE提供系统完整性检测结果：在设备安全启动时，在TEE中评估检测系统完整性，可信度高，并动态评估系统完整性。
2. 系统完整性检测结果安全可信：系统完整性检测结果经过数字证书签名，检测结果不可篡改。

其业务流程图如下图所示：

(1) 你的应用集成HMS Core SDK调用Safety Detect service。

(2) 请求TSMS（Trusted Security Management Service）服务器签名检测结果Server。

(3) 你的应用请求自己服务检测结果。

---- 结束

二、场景案例介绍

目前已有金融、娱乐、便捷生活、新闻阅读等多个领域的App集成了华为系统完整性检测：

金融类应用集成华为SysIntegrity，可有效提升交易安全性。例如，可以在用户输入信用卡安全码（CVC）时，确认手机的系统环境是否安全。如手机设备未通过系统完整性检测验证，则不允许使用该应用，以此保护交易安全：

生活、新闻阅读类应用，集成SysIntegrity后可有效防止黑客攻击，确保应用内付费等活动安全：

视频娱乐类应用集成SysIntegrity，可以帮助保护内容版权；当用户注册、观看和下载离线播放视屏时，可以确保用户在内容提供商认可的设备上，完成流媒体和视频播放：

三、开发代码

1 在AppGallery Connect中配置相关信息

在开发应用前，需要在AppGallery Connect中配置相关信息。

具体操作步骤：https://developer.huawei.com/consumer/cn/doc/HMSCore-Guides-V5/config-agc-0000001050416303-V5

2 配置HMS Core SDK的Maven仓地址

2.1 打开Android Studio项目级“build.gradle"文件

2.2 添加HUAWEI agcp插件以及Maven代码库

• 在allprojects-> repositories里面配置HMS Core SDK的Maven仓地址。

1.  allprojects {  
2.      repositories {  
3.          google()  
4.          jcenter()  
5.          maven {url 'https://developer.huawei.com/repo/'}  
6.      }  
7.   }    

• 在buildscript->repositories里面配置HMS Core SDK的Maven仓地址。

1.  buildscript {  
2.     repositories {  
3.         google()  
4.         jcenter()  
5.         maven {url 'https://developer.huawei.com/repo/'}  
6.     }  
7.  }  

• 在buildscript ->dependencies里面增加配置。

1.  buildscript{  
2.      dependencies {  
3.           classpath 'com.huawei.agconnect:agcp:1.3.1.300'  
4.     }  
5.   }  

3 创建SafetyDetectClient 并生成nonce值

1.  // 创建SafetyDetectClient  
2.  SafetyDetectClient mClient = SafetyDetect.getClient(MainActivity.this);  
3.  // 生成 nonce值  
4.  byte[] nonce = new byte[24];  
5.  try {  
6.      SecureRandom random;  
7.      if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {  
8.          random = SecureRandom.getInstanceStrong();  
9.      } else {  
10.         random = SecureRandom.getInstance("SHA1PRNG");  
11.     }  
12.     random.nextBytes(nonce);  
13. } catch (NoSuchAlgorithmException e) {  
14.     Log.e(TAG, e.getMessage());  
15. }  

4 创建检测结果监听

1.  // 实现OnSuccessListener接口，并从 onSuccess获取检测结果  
2.  protected class SysIntegrityOnSuccessListener implements OnSuccessListener<SysIntegrityResp> {  
3.    
4.      // 获取系统完整性检测结果 
5.      @Override  
6.      public void onSuccess(SysIntegrityResp sysIntegrityResp) {  
7.    
8.      }  
9.    
10 }  
11. // 实现OnFailureListener接口，并从 onFailure异常详情  
12. protected class SysIntegrityOnFailureListener implements OnFailureListener {  
13.     // 获取异常错误码已经异常详情  
14.     @Override  
15.     public void onFailure(Exception e) {  
16.   
17.     }  
18. } 

5 调用系统完整性检测

1.  // 调用系统完整性检测接口，********传入appid  
2.  Task task = mClient.sysIntegrity(nonce,"********");  
3.  task.addOnSuccessListener(new SysIntegrityOnSuccessListener()).addOnFailureListener(new SysIntegrityOnFailureListener());  

6 结果验证

服务器中验证系统完整性检测结果可以参考开发者联盟官网。

如果你对实现方式感兴趣，可以参考Github源码链接：https://github.com/HMS-Core/hms-safetydetect-demo-android

更详细的开发指南，请参考华为开发者联盟官网：

华为开发者联盟：https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/dysintegritydevelopment-0000001050156331

获取开发指导文档：

https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/introduction-0000001050156325ha_source=hms1

下载demo和示例代码请到Github：https://github.com/HMS-Core

解决集成问题请到Stack Overflow：

https://stackoverflow.com/questions/tagged/huawei-mobile-services?tab=Newest

---

原文链接：
https://developer.huawei.com/consumer/cn/forum/topic/0201393882637910006?fid=18
作者：晚上吃啥