鸿蒙应用开发--安全控件: 用于保障数据安全、权限控制和防止恶意操作的系统机制或工具

在应用开发中，安全控件通常指用于保障数据安全、权限控制和防止恶意操作的系统机制或工具。在 HarmonyOS/OpenHarmony 中，安全控件的设计涵盖了文件访问、网络通信、用户隐私等多个方面。以下从 权限管理、文件安全、加密传输 三大核心场景展开说明：

---

一、权限管理：应用沙盒与动态授权

1. 应用沙盒机制

• 作用：
  每个应用拥有独立的文件存储空间（私有目录），禁止未经授权的跨应用访问。

  • 私有目录路径：
    • internal://app/files/（持久化数据）
    • internal://app/cache/（临时缓存）

• 示例代码：

  // 获取应用私有目录路径
  const context = getContext() as common.UIAbilityContext;
  const filesDir = context.filesDir; // 内部存储路径
  const cacheDir = context.cacheDir; // 缓存路径
  

2. 动态权限申请

• 权限类型：

  • ohos.permission.READ_MEDIA（读取媒体文件）
  • ohos.permission.WRITE_MEDIA（写入媒体文件）
  • ohos.permission.INTERNET（网络访问）

• 权限声明（module.json5）：

  {
    "module": {
      "requestPermissions": [
        {
          "name": "ohos.permission.READ_MEDIA",
          "reason": "需要访问用户相册"
        },
        {
          "name": "ohos.permission.INTERNET",
          "reason": "需要连接网络"
        }
      ]
    }
  }
  

• 动态请求权限（API 9+）：

  import abilityAccessCtrl from '@ohos.abilityAccessCtrl';
  
  // 检查并请求权限
  const permissions: Array<string> = ['ohos.permission.READ_MEDIA'];
  const atManager = abilityAccessCtrl.createAtManager();
  try {
    const result = await atManager.requestPermissionsFromUser(globalThis.context, permissions);
    if (result.authResults[0] === 0) {
      console.log('权限已授予');
    } else {
      console.log('权限被拒绝');
    }
  } catch (err) {
    console.error(`权限请求失败: ${err.code}, ${err.message}`);
  }
  

---

二、文件安全：防止路径遍历与数据加密

1. 路径合法性校验

• 禁止使用绝对路径：
  仅允许操作应用私有目录内的文件，避免越权访问。

  // 校验路径是否位于应用沙盒内
  function isSafePath(userInput: string): boolean {
    const safeDir = 'internal://app/';
    return userInput.startsWith(safeDir);
  }
  

2. 敏感数据加密存储

• 使用 @ohos.security.huks 加密文件：

  import huks from '@ohos.security.huks';
  
  // 加密写入文件
  async function writeEncryptedFile(path: string, data: string) {
    const keyAlias = 'my_secret_key';
    const cipherData = await huks.encrypt({ alias: keyAlias, data: new TextEncoder().encode(data) });
    fs.writeFileSync(path, cipherData);
  }
  
  // 解密读取文件
  async function readEncryptedFile(path: string): Promise<string> {
    const cipherData = fs.readFileSync(path);
    const plainData = await huks.decrypt({ alias: 'my_secret_key', data: cipherData });
    return new TextDecoder().decode(plainData);
  }
  

---

三、网络通信：HTTPS 与证书校验

1. 强制使用 HTTPS

• 配置网络安全策略：
  在 module.json5 中声明仅允许安全连接：

  {
    "module": {
      "networkSecurityConfig": {
        "cleartextTraffic": false // 禁止 HTTP 明文传输
      }
    }
  }
  

2. 证书绑定（Certificate Pinning）

• 校验服务器证书指纹：

  import http from '@ohos.net.http';
  
  const httpRequest = http.createHttp();
  httpRequest.request(
    "https://api.example.com",
    {
      method: http.RequestMethod.GET,
      extraData: {
        // 预置合法的证书指纹
        trustedCA: [
          'SHA-256=ABC123...', // 替换为实际指纹
        ]
      }
    },
    (err, data) => { /* 处理响应 */ }
  );
  

---

四、安全控件对比表

控件类型	作用	HarmonyOS API/模块
应用沙盒	隔离应用文件，防止越权访问	自动生效，无需编码
动态权限管理	控制敏感操作（如访问相册、网络）	@ohos.abilityAccessCtrl
数据加密	保护本地存储的敏感数据	@ohos.security.huks
网络安全策略	防止中间人攻击	@ohos.net.http + 证书配置
输入校验	防御路径遍历、注入攻击	开发者手动实现

---

五、最佳实践

1. 最小权限原则：仅申请必要的权限，减少攻击面。
2. 敏感操作日志：记录关键操作（如文件删除、网络请求）供审计。
3. 定期清理缓存：避免敏感数据长期滞留临时目录。

   // 清理7天前的缓存文件
   const cacheFiles = fs.listFileSync(cacheDir);
   cacheFiles.forEach(file => {
     const stats = fs.statSync(`${cacheDir}/${file}`);
     if (Date.now() - stats.mtime > 7 * 86400000) {
       fs.unlinkSync(`${cacheDir}/${file}`);
     }
   });
   

---

通过合理利用 HarmonyOS 的安全控件，结合开发规范与加密手段，可显著提升应用的安全性，有效防御数据泄露和恶意攻击。