文档开发者中心
我的
|

HarmonyOS 6

HarmonyOS 5

【数据加密】鸿蒙 APP 如何实现敏感数据(如密码)的 AES 加密存储?

问题描述

开发登录功能时,需要将用户密码存储在本地,避免明文存储导致安全风险,想使用 AES 加密,但不知道鸿蒙原生如何实现 AES 加密 / 解密,加密后的密钥如何安全存储?是否有现成的 API 可用?关键字:鸿蒙 AES 加密、敏感数据存储、密码加密、安全存储、cryptoFramework

点赞
收藏
回复
1
分享
举报
浏览78 发布于2025-12-23 08:48广东
全部评论
最多点赞
最新发布
最早发布

原理解析

鸿蒙提供@ohos.security.cryptoFramework框架,支持 AES、RSA 等加密算法,AES 加密适合敏感数据(如密码)的本地存储:

  • 采用 AES-GCM 模式(带认证的加密,更安全),避免 ECB 模式的安全隐患;
  • 密钥需通过鸿蒙 “安全存储”(如 KeyStore)保存,不能硬编码在代码中;
  • 加密流程:生成随机密钥→加密数据→存储加密后的数据和 IV(初始化向量)→解密时通过密钥和 IV 解密。

实现步骤

步骤 1:生成 AES 密钥并安全存储

typescript

运行

收起
自动换行
深色代码主题
复制
import cryptoFramework from '@ohos.security.cryptoFramework';
import preferences from '@ohos.data.preferences';
import common from '@ohos.app.ability.common';

class AesEncryptionManager {
  private context = getContext(this) as common.UIAbilityContext;
  private keyAlias = 'aes_user_key'; // 密钥别名

  // 生成AES-256密钥并存储到KeyStore
  async generateAndSaveKey() {
    try {
      // 1. 创建密钥生成器(AES-256-GCM)
      const keyGenerator = cryptoFramework.createKeyGenerator('AES', 'software');
      const keySpec = {
        keySize: 256, // AES-256
        purpose: [cryptoFramework.KeyPurpose.ENCRYPT, cryptoFramework.KeyPurpose.DECRYPT]
      };
      await keyGenerator.init(keySpec);

      // 2. 生成密钥
      const key = await keyGenerator.generateKey();

      // 3. 存储密钥到KeyStore(安全存储,不可直接访问)
      const keyStore = cryptoFramework.getKeyStore('software');
      await keyStore.storeKey(this.keyAlias, key, {
        accessible: cryptoFramework.KeyAccessible.ALWAYS_AVAILABLE
      });
      console.log('AES密钥生成并存储成功');
    } catch (err) {
      console.error('密钥生成失败:', err);
    }
  }
}
步骤 2:AES 加密实现

typescript

运行

收起
自动换行
深色代码主题
复制
// 加密数据(如密码)
async encryptData(plainText: string): Promise<string> {
  try {
    // 1. 获取存储的AES密钥
    const keyStore = cryptoFramework.getKeyStore('software');
    const key = await keyStore.getKey(this.keyAlias) as cryptoFramework.SymmetricKey;

    // 2. 生成随机IV(12字节,GCM模式推荐)
    const iv = cryptoFramework.generateRandomBytes(12);
    const ivBase64 = iv.toString('base64');

    // 3. 创建加密器
    const cipher = cryptoFramework.createCipher('AES-GCM', 'software');
    const encryptParams = {
      iv: iv,
      authTagLength: 16 // 认证标签长度
    };
    await cipher.init(cryptoFramework.CryptoMode.ENCRYPT_MODE, key, encryptParams);

    // 4. 加密数据(UTF-8编码)
    const plainTextUint8 = new TextEncoder().encode(plainText);
    const encryptedData = await cipher.doFinal(plainTextUint8);
    const encryptedBase64 = encryptedData.toString('base64');

    // 5. 存储IV(解密需要,与加密数据一起存储)
    const pref = await preferences.getPreferences(this.context, 'secure_storage');
    await pref.putString(`${this.keyAlias}_iv`, ivBase64);
    await pref.flush();

    // 6. 返回加密后的数据(Base64编码,便于存储)
    return encryptedBase64;
  } catch (err) {
    console.error('加密失败:', err);
    throw err;
  }
}
步骤 3:AES 解密实现

typescript

运行

收起
自动换行
深色代码主题
复制
// 解密数据
async decryptData(encryptedBase64: string): Promise<string> {
  try {
    // 1. 获取密钥和IV
    const keyStore = cryptoFramework.getKeyStore('software');
    const key = await keyStore.getKey(this.keyAlias) as cryptoFramework.SymmetricKey;
    
    const pref = await preferences.getPreferences(this.context, 'secure_storage');
    const ivBase64 = await pref.getString(`${this.keyAlias}_iv`, '');
    const iv = cryptoFramework.fromBase64(ivBase64);

    // 2. 创建解密器
    const cipher = cryptoFramework.createCipher('AES-GCM', 'software');
    const decryptParams = {
      iv: iv,
      authTagLength: 16
    };
    await cipher.init(cryptoFramework.CryptoMode.DECRYPT_MODE, key, decryptParams);

    // 3. 解密数据
    const encryptedUint8 = cryptoFramework.fromBase64(encryptedBase64);
    const decryptedUint8 = await cipher.doFinal(encryptedUint8);

    // 4. 解码为字符串
    return new TextDecoder().decode(decryptedUint8);
  } catch (err) {
    console.error('解密失败:', err);
    throw err;
  }
}
步骤 4:使用示例

typescript

运行

收起
自动换行
深色代码主题
复制
// 初始化并加密密码
async useEncryption() {
  const aesManager = new AesEncryptionManager();
  // 首次使用时生成密钥(仅需生成一次)
  await aesManager.generateAndSaveKey();
  
  // 加密密码
  const password = '123456';
  const encryptedPwd = await aesManager.encryptData(password);
  console.log('加密后:', encryptedPwd);
  
  // 解密密码
  const decryptedPwd = await aesManager.decryptData(encryptedPwd);
  console.log('解密后:', decryptedPwd); // 输出123456
}

避坑提醒

  • AES 密钥必须存储在 KeyStore,不能硬编码或明文存储在 Preferences;
  • IV(初始化向量)需随机生成,且每次加密不同,解密时必须使用相同 IV;
  • 推荐使用 AES-256-GCM 模式,兼顾安全性和性能,避免使用 ECB 模式;
  • 敏感数据加密后,建议存储在preferences或RelationalStore,无需额外加密存储介质。
展开全部
1楼回复于2025-12-23 08:54 来自广东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

目录 收起
问题描述
了解社区公约,与您携手共创和谐专业的开发者社区。