You need to enable JavaScript to run this app. @capacitor-community/sqlite中encryption、secret、newsecret的区别
优惠活动
大模型
产品
解决方案
定价
更多

@capacitor-community/sqlite中encryption、secret、newsecret的区别

三种加密模式的实际运行逻辑

前置说明:调用open方法时的encrypted: true是加密能力的总开关,只有该值为true时,下述三个mode的加密逻辑才会实际生效;若为false,即使配置了mode也不会触发任何加密相关操作。
所有模式都是基于插件内置的SQLCipher加密层实现的,三者没有通用场景重叠,误用会直接损坏数据库文件:

  • encryption
    专门用于首次对明文未加密的数据库做加密转换。当调用这个模式时,插件会自动将当前打开的、无任何加密标记的明文SQLite文件,转换为全量加密的SQLCipher数据库,同时把本次调用传入的密钥永久绑定为这个数据库的根加密密钥。
    注意:如果在已经完成加密的数据库上重复调用这个模式,插件会直接尝试在加密文件上重建加密层,会直接造成数据库文件损坏、数据无法读取。
  • secret
    日常运行的常规解锁模式,专门用于打开已经完成加密转换的数据库。调用时只需要传入当前正确的有效密钥,插件会完成密钥校验、解锁数据库、挂载表结构的全流程,全程不会修改数据库本身的文件结构、不会变更绑定的加密密钥。
    这是业务稳定运行阶段最常用的模式,占所有数据库打开操作的绝大多数比例。
  • newsecret
    专门用于已加密数据库的密钥轮换。调用时需要同时传入当前正在使用的旧密钥、以及要替换的新密钥:插件会先校验旧密钥的合法性,校验通过后自动重新加密整个数据库文件,把根密钥从旧值切换为新值。替换完成后,后续所有打开操作必须使用新密钥才能解锁数据库。
    注意:这个模式无法在明文未加密的数据库上调用,会直接抛出加密匹配错误。

移动端非对称加密场景的模式选型

这里需要先明确一个核心边界:@capacitor-community/sqlite 内置的加密层本身是基于AES的对称加密能力,本身不直接提供非对称加密的实现。如果要实现“用非对称密钥保护本地数据库对称密钥”的非对称加密存证逻辑,对应不同业务阶段的选型是完全固定的:

  1. 数据库首次初始化加密阶段:选用encryption模式。你可以在首次创建库时生成一个随机的AES对称密钥,用服务端下发的非对称公钥加密后存到系统级的安全存储区域(iOS Keychain / Android Keystore),再用这个随机对称密钥走第一次的加密转换流程。
  2. 日常业务打开数据库阶段:固定选用secret模式。每次打开时从系统安全存储区取出加密的对称密钥,用对应的非对称解密能力(配合系统安全区的硬件加密特性)解出明文对称密钥,传入插件完成解锁即可。
  3. 非对称密钥轮换/密钥安全升级阶段:选用newsecret模式。当服务端下发新的非对称公钥、要求更新本地数据库保护密钥时,生成新的随机AES对称密钥,调用newsecret模式传入旧的有效密钥完成密钥替换,再把新的AES对称密钥用新的非对称公钥加密存回系统安全区,完成全链路的非对称保护闭环。

内容的提问来源于stack exchange,提问作者Mateusz Klimentowicz

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 06:15:08