先说结论: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 加密只保证了前者。
二、这个插件的做法
核心就三句话:
- 主密钥不落明文。 32 字节主密钥用 AndroidKeyStore 里的 KEK(AES-256-GCM)包起来再存盘,KEK 不可导出。iOS 用 Keychain。
- 每条记录一把密钥。 用 HKDF-SHA256 从主密钥派生,一条记录一把 DEK,改一条不影响其他条。
- 容器自带完整性。 头部有 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) })
判定顺序是四层,先命中先生效:
- 显式
redact指定的字段 - 字段名注册表(用 HKDF 派生的注册密钥做 HMAC 匹配,所以
phone、手机号、mobile都能命中,且注册表本身不以明文形式存在) - 值形态正则(手机号、身份证、银行卡、车牌…)
- 你自己注册的规则(
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 个评论
要回复文章请先登录或注册