嗨嗨
嗨嗨
  • 发布:19 分钟前
  • 更新:19 分钟前
  • 阅读:5

给 uni-app 做了个凭据加密插件,聊聊踩过的坑

分类:uni-app

先说结论:uni.setStorageSync('token', token) 存的东西,在 Android 上就是一个明文文件,写在 App 私有目录里。

这不是 uni-app 的问题,是所有前端存储的共性。但问题在于——大多数团队是在等保测评或者被问到"token 怎么存的"那一刻,才第一次意识到这件事。

所以我写了 endsec-uts 这个插件来解决它。下面讲它是怎么做的、怎么验证的,以及为什么不建议你用"自己加密一下再存"这种方案。

一、自己"加密一下"为什么不够

最常见的做法是 AES 加密后存 storage,密钥硬编码在代码里,或者 Math.random() 生成一个存本地。

这里有两个致命问题:

第一,密钥和密文存在一起。 密钥在代码里,等于锁和钥匙挂在同一个把手上。反编译 uni-app 的 wgt 包并不难(很多工具都能解),拿不到源码也能拿到字符串常量。

第二,看不出密文被改过。 很多实现只用 AES-CBC 加密,没有 MAC。攻击者不需要解密,只要往密文里翻几个字节,你解出来的就是一段"看起来合法"的乱数据——如果这段数据是 config 或者权限位,后果比"打不开"严重得多。

举个常见场景:本地存了一段 JSON 配置,里面既有 isVip: true 也有别的字段。攻击者不解密,只把密文里的某个字节改一下——因为解密不校验完整性,解出来的很可能仍是一段"能解析"的 JSON,只是字段值变了。App 拿到后当配置用,不报任何错。"能解开"和"没被改过"是两件事,只用 CBC 加密只保证了前者。

二、这个插件的做法

核心就三句话:

  1. 主密钥不落明文。 32 字节主密钥用 AndroidKeyStore 里的 KEK(AES-256-GCM)包起来再存盘,KEK 不可导出。iOS 用 Keychain。
  2. 每条记录一把密钥。 用 HKDF-SHA256 从主密钥派生,一条记录一把 DEK,改一条不影响其他条。
  3. 容器自带完整性。 头部有 HMAC,每个分块带 AAD(记录 ID + 块序号 + 总块数),所以:改一个字节解不开、截断后面几块解不开、把 A 记录的密文挪到 B 记录的 key 上也解不开。

用起来就三行:

import { secureSet, secureGet } from '@/uni_modules/endsec-uts'  

await secureSet('auth.token', token, { credentialClass: 'token', ttlSeconds: 604800 })  
const t = await secureGet('auth.token')   // 不存在 / 过期 / 被篡改 → null

注意 secureGet 失败不抛异常,一律返回 null。这是刻意的:如果"过期"抛一种错、"被篡改"抛另一种错,攻击者可以通过错误类型推断系统状态,属于侧信道泄露。调用方需要的语义只有一种——"这个值现在不能用"。

三、还有一个更实际的问题:导出的数据

凭据加密只是第一层。真正让团队出问题的是导出:

  • 客服把用户信息复制到剪贴板,粘进工单系统
  • 测试同学把接口响应导出成文件,发到群里
  • 崩溃日志把整个请求体打进去

这三条路都不经过你的"加密存储",全是明文。所以我做了第二个能力:sanitizeForExport。

const safe = sanitizeForExport(order, 'clipboard', { keep: ['createdAt', 'orderId'] })  
uni.setClipboardData({ data: JSON.stringify(safe.data) })

判定顺序是四层,先命中先生效:

  1. 显式 redact 指定的字段
  2. 字段名注册表(用 HKDF 派生的注册密钥做 HMAC 匹配,所以 phone、手机号、mobile 都能命中,且注册表本身不以明文形式存在)
  3. 值形态正则(手机号、身份证、银行卡、车牌…)
  4. 你自己注册的规则(registerSensitiveRule({ name, pattern }))

场景分 clipboard / share / file / log 四种,强度不同:写进日志的场景连字段名都要打码,因为日志可能被采集。

四、我怎么验证它

安全组件最怕自说自话,所以我把验证做成了可复现的东西:

  • 236 项断言:JS 参考实现 55 项、index.uts 端到端流程 45 项、Swift 24+24、Kotlin 24+36、免费版内核 14×2
  • 三端逐字节一致:同一套测试向量,JS / Swift / Kotlin 三个实现必须产出完全相同的密文(否则"跨端兼容"就是空话)
  • 真机 16 项全过:小米 M2104K10AC / Android 13,付费版 6 项 + 免费版 6 项 + 云函数 4 项
  • 篡改测试是真的改文件里一个字节再读,不是 mock

一条命令跑完全部:bash test/run-all.sh。

五、我不推荐你用它的场合

写清楚边界比写卖点有用:

  • Web / 小程序:不支持。没有 Keystore / Keychain,我不会给一个"降级成明文"的假方案。
  • 要跨设备同步数据:做不到。密钥和设备绑定,换机即失效——这是安全设计,不是偷懒。
  • 想存大于 8MB 的东西:单条上限 8MB,超过返回 endsec-too-large,大文件请自己分片。
  • 想要"国密 SM4":我没有做。自研 SM4 在密评场景不仅不加分,反而会因为"未使用通过认证的密码模块"被扣分。要国密请找有商密资质的模块。
  • iOS 侧:代码和测试向量都写了,但手上没有 iOS 设备做过真机验证。这一点我会在详情页写清楚,不含糊。

六、关于价格

我做成了三个包:

插件 内容 价格
endsec-lite 加密存储内核(secureSet / secureGet / secureRemove / selfCheck) 免费
endsec-uts 完整版:+ 四场景导出脱敏 + 自定义规则 + listKeys / purgeExpired 49(源码 499)
endsec-cloud uniCloud 云函数模板:审计事件抗篡改留存 + 举证材料导出 免费

免费版和付费版共用同一把主密钥与同一个存储目录,容器格式也一样(ENDSEC01 v1)。所以升级的时候不需要写迁移脚本,把 import 路径换掉,历史密文直接能读。

云插件是可选的:不装它,端侧加密和脱敏照样工作。它是给"需要向测评师证明日志没被改过"的团队准备的——每条事件链式哈希,每天出一个签名锚点,导出 report.json + events.csv + 离线验签脚本,第三方可以独立复核。

七、最后

写这个插件的出发点很朴素:"你们本地存的凭据,怎么证明没被人改过"——这个问题在等保测评、安全评审、甲方技术尽调里出现的频率,比大多数人预期的高。

所以它不是一个"功能列表很好看"的插件,它解决的是被问到的那一刻。如果你也被问过,可以直接拿去用:

有问题在插件市场留言,我会逐条回。也欢迎直接指出设计上的问题

0 赞 关注 分享

要回复文章请先登录或注册