ARTICLE · 1374490
uni-app 里存 token,我为什么不敢用 localStorage
先说结论: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 | |
endsec-cloud |
免费版和付费版共用同一把主密钥与同一个存储目录,容器格式也一样(ENDSEC01 v1)。所以升级的时候不需要写迁移脚本,把 import 路径换掉,历史密文直接能读。
云插件是可选的:不装它,端侧加密和脱敏照样工作。它是给"需要向测评师证明日志没被改过"的团队准备的——每条事件链式哈希,每天出一个签名锚点,导出 report.json + events.csv + 离线验签脚本,第三方可以独立复核。
七、最后
写这个插件的出发点很朴素:“你们本地存的凭据,怎么证明没被人改过”——这个问题在等保测评、安全评审、甲方技术尽调里出现的频率,比大多数人预期的高。
所以它不是一个"功能列表很好看"的插件,它解决的是被问到的那一刻。如果你也被问过,可以直接拿去用:
- 端安盾·凭据加密与导出脱敏(UTS)
- 端安盾·凭据加密(免费版)
- 端安盾·审计举证(uniCloud 云函数模板)
有问题在插件市场留言,我会逐条回。也欢迎直接指出设计上的问题














































































