鸿蒙云相册接入 OBS:把 AK/SK 留在服务端,而不是应用设置页
从教学 Demo 到生产应用:先解决凭据边界
鸿蒙案例“用 OBS 打造个人云相册”把上传链路讲得很清楚,但如果照着 Demo 让用户在应用设置页填写 AK/SK,并把它们保存到本地 preferences,就会留下一个容易被忽视的边界问题:客户端代码和本地存储都运行在用户设备上,不能承担服务端秘密的保管职责。
为什么不能把长期密钥放进 App
AK/SK 一旦进入客户端,就可能通过调试包、备份、日志、截图或异常采集暴露。即使 preferences 有沙箱保护,也只是隔离其他应用,并不等于只有本应用的所有者能看到。更关键的是,长期密钥通常代表账号级权限,泄露后影响面远大于一部手机。
教学环境可以强调“先跑通”,生产应用则要先回答:谁有资格上传、能上传到哪个目录、权限持续多久。
推荐架构:客户端拿短期能力,服务端做授权
更稳妥的链路是:
- 鸿蒙应用先完成用户身份认证;
- 应用向自己的业务服务请求上传能力;
- 业务服务校验用户、相册归属和文件类型,再签发短期 STS 临时凭证或预签名 URL;
- 客户端只在本次会话中使用临时能力,过期后重新申请;
- OBS 通过桶策略、IAM 权限和临时会话策略限制访问范围。
示意流程可以写成:
HarmonyOS App -> 业务鉴权服务 -> 签发短期凭证/签名
HarmonyOS App -> OBS SDK -> 上传到 user/{uid}/photo/{date}/{uuid}
客户端不需要知道长期密钥,也不应该获得账号级管理权限。临时凭证应绑定最小权限,例如只允许访问指定桶的指定前缀,并设置尽量短的有效期。
权限要拆开,不要只给一把“万能钥匙”
一个可维护的权限模型通常至少拆成三类:
ListBucket:只允许列举当前用户的相册索引,最好通过前缀和业务服务代查进一步收窄;PutObject:只允许上传到user/{uid}/前缀,并限制对象大小;GetObject:私有照片优先返回短时预签名 URL,而不是给客户端长期读取权限。
对象名按用户、日期和随机 ID 分层,例如 user/42/photo/2026-11-15/6f61....jpg。这样既便于审计,也能减少前缀越权风险。不要使用包含用户输入的原始文件名直接拼接对象键。
上传链路还需要哪些保护
除权限之外,建议同时落实以下措施:
- 全链路使用 HTTPS,拒绝明文传输;
- 上传前校验 MIME 类型和文件大小,服务端再次校验,不能只信客户端;
- 使用
Content-MD5或 SDK 校验能力确认对象完整性; - 对下载链接设置短有效期,避免公开可猜地址;
- 日志统一脱敏,不记录 Authorization、临时令牌、预签名 URL 的完整查询串;
- 为用户数据和运维操作保留审计记录,并建立密钥轮换与异常撤销流程。
如果密钥曾经进入过客户端历史版本,迁移时不能只删界面。应停用旧密钥、重新签发,并检查旧版本是否仍在分发。
从 Demo 迁移的落地步骤
第一步,移除应用设置页中的 AK/SK 输入项和 preferences 存储逻辑;第二步,在业务服务中增加上传授权接口,校验登录态、相册归属和配额;第三步,让客户端改为向该接口申请短期凭证;第四步,收紧桶策略和对象前缀,补齐大小、类型、有效期限制;第五步,用越权访问、过期凭证、超大文件错误类型等用例做安全回归。
最后要形成一个简单原则:客户端负责采集与交互,服务端负责身份、授权和审计,OBS 负责受控存储。 这样再回头理解鸿蒙云相册案例,示例仍然有价值,但它展示的是能力,而不是生产环境的最终安全边界。
- 点赞
- 收藏
- 关注作者
评论(0)