欢迎光临
我们一直在努力

第5篇|时间轨迹的可信存储:敏感数据加密、备份恢复与换机迁移

第5篇|时间轨迹的可信存储:敏感数据加密、备份恢复与换机迁移

如果上一篇讲的是“数据应该放在哪里”,那这一篇要继续往前走一步,讲的是:数据放进去之后,怎么让它真的可信。

这里说的“可信”,不是一个很虚的词。它至少包含四件事:

  • 数据落盘后不会被轻易看懂
  • 不同账号之间不会互相串
  • 旧版本升级后还能正常恢复
  • 换机、重装、备份导入时还能找回来

也就是说,可信存储不是“多写一个文件”,而是把加密、版本、恢复、迁移这四层一起设计好。

先把当前基础看明白

时间轨迹现在的存储结构其实已经不错了,不是乱写一气。

从代码里能看到几条很清晰的线:

  • EntryAbility.ets 负责初始化一堆 PersistentStorage 和 AppStorage
  • AccountService.ets 负责保存 session.json、device_accounts.json、accounts/{openId}/userdata.json
  • LoginPage.ets 负责登录后加载用户数据、保存会话
  • ProfilePage.ets 负责头像、退出登录、用户数据落盘
  • EntryAbility.onBackground() 会在应用进入后台时自动保存用户数据

这说明这套应用已经不是“页面上写一点状态”了,而是有了明确的数据层。

但问题也正是在这里出现的:

已经开始存数据了,就必须开始认真对待数据的可信性。

为什么光有沙盒还不够

沙盒能解决的是“数据尽量只留在应用自己的范围里”,但它解决不了下面这些事:

  • 用户手机丢了,文件被直接拷走
  • 调试包、备份包、导出包里能直接看到明文
  • 老版本的 JSON 被新版本读取时报错
  • 账号 A 的记录被错误加载到账号 B
  • 日志里不小心把敏感字段打印出去了

所以,沙盒只是边界,可信存储才是质量。

换句话说:

  • 沙盒回答的是“放哪儿”
  • 可信存储回答的是“放进去以后怎么保护、怎么恢复、怎么升级”

先看一张整体图

#mermaid-svg-YHVXTQoIv5bq0aWh{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-YHVXTQoIv5bq0aWh .error-icon{fill:#552222;}#mermaid-svg-YHVXTQoIv5bq0aWh .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-YHVXTQoIv5bq0aWh .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-YHVXTQoIv5bq0aWh .marker{fill:#333333;stroke:#333333;}#mermaid-svg-YHVXTQoIv5bq0aWh .marker.cross{stroke:#333333;}#mermaid-svg-YHVXTQoIv5bq0aWh svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-YHVXTQoIv5bq0aWh p{margin:0;}#mermaid-svg-YHVXTQoIv5bq0aWh .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-YHVXTQoIv5bq0aWh .cluster-label text{fill:#333;}#mermaid-svg-YHVXTQoIv5bq0aWh .cluster-label span{color:#333;}#mermaid-svg-YHVXTQoIv5bq0aWh .cluster-label span p{background-color:transparent;}#mermaid-svg-YHVXTQoIv5bq0aWh .label text,#mermaid-svg-YHVXTQoIv5bq0aWh span{fill:#333;color:#333;}#mermaid-svg-YHVXTQoIv5bq0aWh .node rect,#mermaid-svg-YHVXTQoIv5bq0aWh .node circle,#mermaid-svg-YHVXTQoIv5bq0aWh .node ellipse,#mermaid-svg-YHVXTQoIv5bq0aWh .node polygon,#mermaid-svg-YHVXTQoIv5bq0aWh .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-YHVXTQoIv5bq0aWh .rough-node .label text,#mermaid-svg-YHVXTQoIv5bq0aWh .node .label text,#mermaid-svg-YHVXTQoIv5bq0aWh .image-shape .label,#mermaid-svg-YHVXTQoIv5bq0aWh .icon-shape .label{text-anchor:middle;}#mermaid-svg-YHVXTQoIv5bq0aWh .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-YHVXTQoIv5bq0aWh .rough-node .label,#mermaid-svg-YHVXTQoIv5bq0aWh .node .label,#mermaid-svg-YHVXTQoIv5bq0aWh .image-shape .label,#mermaid-svg-YHVXTQoIv5bq0aWh .icon-shape .label{text-align:center;}#mermaid-svg-YHVXTQoIv5bq0aWh .node.clickable{cursor:pointer;}#mermaid-svg-YHVXTQoIv5bq0aWh .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-YHVXTQoIv5bq0aWh .arrowheadPath{fill:#333333;}#mermaid-svg-YHVXTQoIv5bq0aWh .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-YHVXTQoIv5bq0aWh .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-YHVXTQoIv5bq0aWh .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-YHVXTQoIv5bq0aWh .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-YHVXTQoIv5bq0aWh .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-YHVXTQoIv5bq0aWh .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-YHVXTQoIv5bq0aWh .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-YHVXTQoIv5bq0aWh .cluster text{fill:#333;}#mermaid-svg-YHVXTQoIv5bq0aWh .cluster span{color:#333;}#mermaid-svg-YHVXTQoIv5bq0aWh div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-YHVXTQoIv5bq0aWh .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-YHVXTQoIv5bq0aWh rect.text{fill:none;stroke-width:0;}#mermaid-svg-YHVXTQoIv5bq0aWh .icon-shape,#mermaid-svg-YHVXTQoIv5bq0aWh .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-YHVXTQoIv5bq0aWh .icon-shape p,#mermaid-svg-YHVXTQoIv5bq0aWh .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-YHVXTQoIv5bq0aWh .icon-shape .label rect,#mermaid-svg-YHVXTQoIv5bq0aWh .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-YHVXTQoIv5bq0aWh .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-YHVXTQoIv5bq0aWh .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-YHVXTQoIv5bq0aWh :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

AppStorage / PersistentStorage

可信序列化层

加密与完整性校验

文件沙盒 / 账号目录

HUKS 密钥能力

恢复与反序列化

版本检查

数据迁移

回写 AppStorage

导出包 / 备份包

业务页面

在这里插入图片描述

这张图里最重要的不是“流程很多”,而是数据从一开始就要被当成一个受保护的对象来处理。

哪些数据值得加密

不是所有东西都必须一刀切上加密,最好按敏感级别分层。

数据类型当前项目里的例子建议策略
高敏感 登录会话、账号标识、工作记录、时间地点历史 加密 + 完整性校验
中敏感 设备账号列表、头像路径、最近使用记录 可加密,也可以做签名校验
低敏感 主题模式、开关偏好、安全区高度 可明文保存,但仍建议走统一序列化

这里面最值得加密的,不是“看起来复杂”的字段,而是一旦泄露就会暴露用户行为轨迹的字段:

  • wrRecords
  • wmLocationHistory
  • session.json
  • customTemplatesJson
  • favoriteTemplateIds
  • recentTemplateIds

这些内容一旦被直接读到,就不只是“设置文件”,而是用户的行为画像。

当前项目里已经有的好基础

你现在的实现其实已经为可信存储铺好了底子。

1. 数据边界是清楚的

AccountService.saveUserData() 会把当前账号的数据写到:

filesDir/accounts/{openId}/userdata.json

这件事非常重要,因为它意味着:

  • 账号数据不是混写的
  • 后续可以按账号单独加密
  • 迁移和导出也可以按账号处理

2. 会话和业务数据是分开的

session.json 和 userdata.json 不在一个层级里。

这意味着:

  • 退出登录可以只清会话
  • 数据恢复可以只加载业务内容
  • 调试和排错时边界更清楚

3. 后台自动保存已经存在

EntryAbility.onBackground() 里会自动调用 AccountService.saveUserData()。

这说明应用不是等用户手动点“保存”才落盘,而是会在合适时机自动收口。这种设计很适合接“加密保存”,因为你只要把保存入口收紧,后面所有数据都能统一被保护。

真正要补的,是“可信封装层”

我更建议把现在的 JSON 保存,升级成统一的可信封装格式。

可以先想成下面这个结构:

interface TrustedEnvelope {
version: number; // 数据结构版本
namespace: string; // 数据类型,如 session / userdata / accounts
openId: string; // 当前账号标识
algorithm: string; // 加密算法标识
iv: string; // 初始化向量
cipherText: string; // 加密后的正文
tag: string; // 完整性标签
checksum: string; // 可选的校验值
updatedAt: number; // 最后更新时间
}

这个结构最大的价值,不是“看起来高级”,而是它把后面所有问题都提前想好了:

  • 版本变更了,怎么识别
  • 数据被篡改了,怎么发现
  • 重装后恢复时,怎么判断能不能读
  • 以后要多账号、多设备同步时,怎么扩展

密钥不要和数据放在一起

可信存储里最忌讳的一件事,就是:

把密钥和密文放在同一个地方,还把它们命名得很像。

那样做本质上只是“把明文换个样子”,不是真正的保护。

更合理的方式是:

  • 数据放在应用沙盒里
  • 密钥单独托管
  • 密钥生成和使用尽量依赖 HarmonyOS 的安全能力
  • 应用只知道“怎么用”,不要自己手搓密钥管理
  • HarmonyOS 官方文档里已经有 HUKS 相关的加密、解密和密钥能力说明,这类能力适合用来承接“密钥不落地”的需求。
    对应用层来说,你不需要把密钥算法写死在业务里,只需要把“数据加密前后”这层接口收好。

    一个更合理的保存流程

    我建议把保存流程拆成四步:

  • 先把业务数据整理成稳定的 JSON
  • 对 JSON 做加密和完整性保护
  • 再写入账号目录
  • 最后把索引和元信息单独保存
  • // 结构示意,不是直接可运行的最终实现
    function saveTrustedUserData(openId: string, data: UserData): void {
    const plain = JSON.stringify({
    version: 2,
    openId,
    updatedAt: Date.now(),
    payload: data
    });

    const envelope = encryptWithTrustedKey(plain); // 由安全能力处理密钥
    writeText(`filesDir/accounts/${openId}/userdata.enc`, JSON.stringify(envelope));
    }

    function loadTrustedUserData(openId: string): UserData {
    const raw = readText(`filesDir/accounts/${openId}/userdata.enc`);
    const envelope = JSON.parse(raw) as TrustedEnvelope;
    const plain = decryptWithTrustedKey(envelope);
    const parsed = JSON.parse(plain);
    return migrateIfNeeded(parsed);
    }

    这段代码的重点不是具体函数名,而是这条链路:

    序列化 -> 加密 -> 落盘 -> 恢复 -> 校验 -> 迁移

    只要这条链路清楚了,后面怎么换算法、怎么换字段、怎么做导入导出,都会比较稳。

    备份和恢复,才是可信存储真正值钱的地方

    很多文章只讲“加密”,但其实对用户来说,更重要的是:

    我换手机以后还能不能把东西找回来。

    所以可信存储不能只讲保护,还要讲恢复。

    推荐的恢复路径

    #mermaid-svg-1TIonbotUw1bTien{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-1TIonbotUw1bTien .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-1TIonbotUw1bTien .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-1TIonbotUw1bTien .error-icon{fill:#552222;}#mermaid-svg-1TIonbotUw1bTien .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-1TIonbotUw1bTien .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-1TIonbotUw1bTien .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-1TIonbotUw1bTien .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-1TIonbotUw1bTien .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-1TIonbotUw1bTien .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-1TIonbotUw1bTien .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-1TIonbotUw1bTien .marker{fill:#333333;stroke:#333333;}#mermaid-svg-1TIonbotUw1bTien .marker.cross{stroke:#333333;}#mermaid-svg-1TIonbotUw1bTien svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-1TIonbotUw1bTien p{margin:0;}#mermaid-svg-1TIonbotUw1bTien .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-1TIonbotUw1bTien .cluster-label text{fill:#333;}#mermaid-svg-1TIonbotUw1bTien .cluster-label span{color:#333;}#mermaid-svg-1TIonbotUw1bTien .cluster-label span p{background-color:transparent;}#mermaid-svg-1TIonbotUw1bTien .label text,#mermaid-svg-1TIonbotUw1bTien span{fill:#333;color:#333;}#mermaid-svg-1TIonbotUw1bTien .node rect,#mermaid-svg-1TIonbotUw1bTien .node circle,#mermaid-svg-1TIonbotUw1bTien .node ellipse,#mermaid-svg-1TIonbotUw1bTien .node polygon,#mermaid-svg-1TIonbotUw1bTien .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-1TIonbotUw1bTien .rough-node .label text,#mermaid-svg-1TIonbotUw1bTien .node .label text,#mermaid-svg-1TIonbotUw1bTien .image-shape .label,#mermaid-svg-1TIonbotUw1bTien .icon-shape .label{text-anchor:middle;}#mermaid-svg-1TIonbotUw1bTien .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-1TIonbotUw1bTien .rough-node .label,#mermaid-svg-1TIonbotUw1bTien .node .label,#mermaid-svg-1TIonbotUw1bTien .image-shape .label,#mermaid-svg-1TIonbotUw1bTien .icon-shape .label{text-align:center;}#mermaid-svg-1TIonbotUw1bTien .node.clickable{cursor:pointer;}#mermaid-svg-1TIonbotUw1bTien .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-1TIonbotUw1bTien .arrowheadPath{fill:#333333;}#mermaid-svg-1TIonbotUw1bTien .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-1TIonbotUw1bTien .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-1TIonbotUw1bTien .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-1TIonbotUw1bTien .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-1TIonbotUw1bTien .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-1TIonbotUw1bTien .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-1TIonbotUw1bTien .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-1TIonbotUw1bTien .cluster text{fill:#333;}#mermaid-svg-1TIonbotUw1bTien .cluster span{color:#333;}#mermaid-svg-1TIonbotUw1bTien div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-1TIonbotUw1bTien .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-1TIonbotUw1bTien rect.text{fill:none;stroke-width:0;}#mermaid-svg-1TIonbotUw1bTien .icon-shape,#mermaid-svg-1TIonbotUw1bTien .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-1TIonbotUw1bTien .icon-shape p,#mermaid-svg-1TIonbotUw1bTien .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-1TIonbotUw1bTien .icon-shape .label rect,#mermaid-svg-1TIonbotUw1bTien .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-1TIonbotUw1bTien .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-1TIonbotUw1bTien .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-1TIonbotUw1bTien :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

    是

    否

    用户登录 / 选择账号

    读取本地索引

    是否存在加密数据

    解密

    初始化新数据

    版本检查

    数据迁移

    回写 AppStorage

    恢复页面状态

    在这里插入图片描述

    恢复这件事一定要分清楚两种情况:

    • 本地恢复:同一台设备上重新登录
    • 迁移恢复:换机、重装、导入备份包

    这两种情况的入口类似,但策略不同。

    版本号一定要写

    很多本地 JSON 文件一开始都很干净,后来一复杂就开始出问题。
    所以我建议任何可信数据都要带版本号。

    比如:

    {
    "version": 2,
    "openId": "user_123",
    "updatedAt": 1710000000000,
    "payload": { … }
    }

    这样做以后,你就可以很自然地处理:

    • version = 1 的旧数据
    • version = 2 的新数据
    • 某个字段废弃后的兼容
    • 某次结构升级后的自动迁移

    这也是“可信”很重要的一部分:不只是今天能读,明天也能读。

    从“可存”到“可迁移”

    如果你真想把这篇做得更像一个系列里的高阶章节,我建议重点强调“迁移”。

    因为迁移是最能看出一个项目有没有工程感的地方。

    迁移时要考虑的几件事

  • 字段新增后,旧数据怎么补默认值
  • 字段改名后,旧字段怎么映射
  • 多账号目录怎么合并
  • 备份包怎么确认来源
  • 导入失败后怎么回滚
  • 一个比较稳的思路是:

    • 先导入到临时目录
    • 校验版本和完整性
    • 再迁移到正式账号目录
    • 最后才切换到新的索引

    这样即使导入失败,也不会把当前可用数据破坏掉。

    这套项目现在最适合的升级路线

    如果结合你现在的代码,我会这样排优先级:

    第一层:先统一封装数据入口

    把 saveUserData() / loadUserData() / saveSession() 这几个入口先集中起来,不让文件操作散落到各页面。

    第二层:给用户数据加密

    优先保护:

    • 工作记录
    • 地址历史
    • 模板收藏
    • 设备账号索引

    第三层:把导出和恢复做成独立流程

    不要让“导出”和“平时保存”共用一套逻辑。
    导出是给人看的,平时保存是给应用自己用的,这两者的安全要求不一样。

    第四层:补日志脱敏

    这一步很容易被忽略,但很关键。
    如果日志里直接打印 openId、地址、记录内容,那就算数据本身加密了,泄露也可能从日志里出去。

    这一篇想收住的核心结论

    时间轨迹走到可信存储这一步,说明它已经不只是一个“能记录”的应用了,而是在往“可长期使用、可换机恢复、可版本演进”的方向走。

    我觉得这里最重要的三句话是:

    • 沙盒解决的是边界
    • 加密解决的是暴露
    • 版本和迁移解决的是未来

    如果上一篇是在讲“数据放哪儿最合理”,那这一篇就是在讲“数据放进去以后,怎么让用户放心把它留在这里”。

    对一个时间轨迹类应用来说,这已经不是小修小补了,而是真正开始有产品底层味道了。

    赞(0)
    未经允许不得转载:171主机测评 » 第5篇|时间轨迹的可信存储:敏感数据加密、备份恢复与换机迁移
    分享到: 更多 (0)

    评论 抢沙发

    • 昵称 (必填)
    • 邮箱 (必填)
    • 网址