FIEforever|
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 来自广东
写回答
所见即所得编辑器, editor1
工具栏 撤消 快捷键 Ctrl+Z 重做 快捷键 Ctrl+Y 格式刷 快捷键 Ctrl+Shift+C 清除格式 加粗 快捷键 Ctrl+B 倾斜 快捷键 Ctrl+I 下划线 快捷键 Ctrl+U 删除线格式调整字号 文本颜色 背景颜色 增加缩进量 减少缩进量 左对齐 居中 右对齐 两端对齐段落间距行间距 项目列表 编号列表 插入水平线 块引用 插入/编辑超链接 快捷键 Ctrl+K 取消超链接 图片 表格 上传附件 导入Word 插入代码 MD编辑器 全屏模式
0/50000
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
目录 收起
问题描述
相关推荐
换一批
1
HarmonyOS 如何实现私钥加密,公钥解密 (API12+)
2
HarmonyOS 如何进行字符串的sha256加密 (API12+)
3
HarmonyOS 实现对空字符串的sha256加密 失败 (API12+)
4
HarmonyOS 对称加密的CTR模式,没找到具体的使用示例 (API12+)
5
HarmonyOS 里有没有KeyChain的概念? (API12+)
6
HarmonyOS 应用是否支持指纹登录?(API12+)
7
HarmonyOS 如何获取当前设备是否开启锁屏密码(API12+)
8
HarmonyOS token,手机号可以存储在哪里?(API12+)
了解社区公约,与您携手共创和谐专业的开发者社区。




































苏公安网备 32011402010933号