数据保护服务

介绍

本示例主要展示了数据保护服务相关的功能，使用@kit.EnterpriseDataGuardKit、@kit.CoreFileKit等接口，实现了打开读取文件、设置查询文件标签、扫描公共目录文件清单、删除文件、下发KIA文件清单、下发网络拦截策略和查询文件URI的功能。

仅供企业安全管控类MDM应用申请权限后使用。

效果预览

1.在项目根目录下执行[test.bat]脚本，发送[test.json]到设备上。

2.在应用中心选中应用"label"打开sample应用。

3.打开应用后应用界面会显示在屏幕上。

4.点击按钮调用对应接口，如点击"测试1：扫描公共目录"。

5.接口调用结果输出到日志中。

具体实现（接口参考@hms.pcService.fileGuard.d.ts）

• 扫描公共目录接口清单接口代码实现都在ScanFileGuard.ts中

  • 使用new fileGuard Guard()获取FileGuard对象

  • 实现两个回调函数用于接收文件清单和通知扫描结束

    onReceiveFileList(files: Array<string>): void;
    onTaskCompleted(count: number): void;
    

  • 调用fileGuard.startFileScanTask开始扫描公共目录

• 打开文件接口代码实现都在ScanFileGuard.ts中

  • 使用new fileGuard.FileGuard()获取FileGuard对象
  • 调用fileGuard.openFile传入文件路径打开文件

• 设置文件标签和查询文件标签代码实现都在ScanFileGuard.ts中

  • 使用new fileGuard.FileGuard()获取FileGuard对象
  • 调用fileGuard.setFileTag设置文件标签
  • 调用fileGuard.queryFileTag查询文件标签

• 查询文件URI代码实现都在ScanFileGuard.ts中

  • 使用new fileGuard.FileGuard()获取FileGuard对象
  • 调用fileGuard.getFileUri查询文件URI

• 删除文件代码实现都在ScanFileGuard.ts中

  • 使用new fileGuard.FileGuard()获取FileGuard对象
  • 调用fileGuard.deleteFile删除文件

• 设置KIA文件清单代码实现都在ScanFileGuard.ts中

  • 使用new fileGuard.FileGuard()获取FileGuard对象
  • 调用fileGuard.setKiaFilelist设置KIA清单

  {
    "kia_filelist":[
      "/data/service/el2/100/hmdfs/account/files/Documents/Desktop/aaa.docx",
      "/data/service/el2/100/hmdfs/account/files/Documents/Desktop/bbb.docx"
    ]
  }
  

• 下发网络拦截策略代码实现都在ScanFileGuard.ts中

  • 使用new fileGuard.FileGuard()获取FileGuard对象
  • 调用fileGuard.updatePolicy下发策略

  {
    "net_intercept_toggle":0,
    "boundary":[
        "10.10.0.0-10.10.255.255.255",
        "0.0.0.0-1.1.1.1"
    ],
    "netsegment_trustlist":["10.10.0.0-10.10.255.255.255"],
    "netsegment_blocklist":[ "0.0.0.0-1.1.1.1"],
    "default_policy":0
  }