鸿蒙云相册实践笔记:OBS Header 签名备份的三个关键点
今天上午,我先浏览了一个鸿蒙案例:用 OBS 打造个人云相册 app。随后,我在 AI DevSpace 里把其中最关键、也最容易写错的一步又追问了一遍——照片备份时,OBS 的 Header 签名到底应该怎么做。这篇笔记就是把这两件事合在一起的整理:不复述案例的操作步骤,只讲我自己想清楚的三个关键点。
一、为什么不能简单拼接 URL?
做云相册的第一直觉,往往是把访问地址拼出来:桶名、对象名、再加上一串参数,手机端直接请求就行了。照片能打开,看起来也“能用”,但备份这件事不能只看“能打开”。
如果把密钥直接放进 URL,或者把长期有效的凭证拼在地址里,问题不在当下能不能上传,而在之后谁能拿到这个地址。URL 会出现在日志、分享链接、浏览器历史和抓包记录里,一旦泄露,别人拿到的就不只是一张照片的地址,而是一把能反复使用的钥匙。
Header 签名的思路正好反过来:密钥本身不出现在请求里,出现在请求里的只是一次性的“证明”。
大体流程是这样的:先把这次请求的关键要素按固定顺序拼成一个待签名字符串 StringToSign,包括请求方法、内容类型、日期,以及和 OBS 相关的规范化请求头和规范化资源路径;再用 Secret Key 对它做 HMAC-SHA1 运算,得到签名;最后把 Access Key 和签名一起放进 Authorization 请求头。服务端收到请求后,用同样的规则重新算一遍,两边对得上,才认为是合法请求。
这样做的好处有三点。第一,密钥不传输、不暴露在 URL 里;第二,签名和这一次请求绑定,改一个方法、改一个对象名、改一个时间,签名就失效了;第三,日期本身就是防重放的一部分,过期请求即使被截获,也不能一直拿来用。
所以,备份照片不是“拼一个能用的地址”,而是“为每一次上传生成一次可验证的身份证明”。
二、PUT 上传与错误处理:三个关键点
关键点一:StringToSign 必须一字不差
签名失败最常见的原因,不是算法选错了,而是签名前后用的内容不一致。
比如,签名时用的 Content-Type 是 image/jpeg,真正发 PUT 请求时却写成了别的类型;签名时对象名里有一个斜杠或中文字符,实际请求里又被编码成了另一种形式;日期格式不是标准的 GMT 格式,或者时区换算错了。这些细节只要有一处对不上,服务端算出的签名就和客户端不一样,返回的往往是签名不匹配的错误。
我的做法是:先把方法、请求头、资源路径写成一份清单,签名和发送共用同一份清单,而不是在两个地方各写一遍。
关键点二:PUT 上传要先想好“传坏了怎么办”
照片备份的 PUT 上传,成功时状态码一般是 200,但不能只看“没有报错”就当作备份完成了。
一个比较稳妥的检查顺序是:先看状态码,再看服务端返回的错误码和请求 ID,最后再确认对象确实存在、大小和类型符合预期。遇到签名不匹配、权限不足这类错误,重试是没有意义的,应该先停下来核对签名字符串、密钥、桶和对象名;只有网络抖动、超时这类临时性失败,才适合等一会儿再重试,而且要限制重试次数,避免同一张照片被反复上传。
对象名的设计也值得提前想好。用日期加文件名、或者用内容相关的标识来命名,可以减少同名覆盖;如果确实允许覆盖,也要想清楚旧照片会不会被误替换。备份的价值在于“丢了还能找回来”,命名混乱本身就是一种风险。
关键点三:不要在端侧长期保存密钥
在 AI DevSpace 里验证这个思路时,我特意确认了一点:演示和笔记里都不应该出现真实的 Access Key 和 Secret Key。
Header 签名的好处,恰恰是让客户端不必、也不应该长期持有能直接操作整个桶的密钥。更合理的做法,是让服务端按需发放有范围、有有效期的临时凭证,或者由服务端直接生成带签名的上传地址,端侧只负责拿着这一次的凭证完成上传。这样即使手机丢失、请求被记录,损失也是有限的。
三、端侧直传和自有后端中转,怎么选?
这是做云相册时最容易纠结的一点,两种路线没有绝对的好坏,关键看你要换什么。
端侧直传 OBS 的优点很直接:照片不经过自己的服务器,上传路径短,服务器的带宽和存储压力小,个人小项目做起来也轻。缺点也很明确:权限控制、审核、压缩、去重这些事,都要在端侧或借助临时凭证的规则来做,设计不好就容易把口子开得太大。
经过自有后端中转的优点,是控制权集中:后端可以先校验用户身份,再决定能不能上传、上传到哪个桶、文件有多大、类型合不合法,还能顺手做压缩、生成缩略图、记录备份日志。缺点是所有照片都要先过一次自己的服务器,带宽、成本和单点压力都会上来,上传速度也多了一跳。
我的判断是:个人云相册、照片量不大、以备份和查看为主时,端侧直传加有范围、有有效期的临时凭证,是更轻、也更符合直觉的选择;而一旦要做多人共享、付费空间、内容审核或统一的备份策略,就应该把控制权收回到后端,哪怕多走一跳也值得。
四、今天在 AI DevSpace 里验证了什么
今天在 AI DevSpace 里,我主要验证的是思路本身,而不是一次真实的生产上传。
我把问题拆成了三步来问:第一步,StringToSign 应该包含哪些要素、顺序能不能乱;第二步,HMAC-SHA1 之后,Authorization 头应该长什么样子;第三步,PUT 上传失败时,哪些错误应该重试、哪些错误应该先停下来改签名。
得到的回答和我上午从案例里形成的理解是一致的:签名要素要固定、请求头和签名要共用同一份数据、错误要先分类再决定重试还是修正。这个过程没有产生新的实验数据,我也没有把某一次上传的耗时或成功率写成结论。真正被验证的,是“先签名、再上传、最后按状态码和错误码核对”这个顺序本身是自洽的。
结尾:一份可以照着检查的清单
如果以后再做类似的备份功能,我会先按这份清单检查一遍:
- 密钥有没有出现在 URL、日志或前端代码里;
- StringToSign 的方法、类型、日期、资源路径,和实际请求是不是同一份;
- PUT 成功后,有没有用状态码和错误码确认,而不是只看没有崩溃;
- 临时凭证的权限和有效期,是不是只够完成这一次备份;
- 端侧直传还是后端中转的选择,是不是和照片量、共享需求、审核需求匹配。
云相册看起来做的是“把照片存起来”,实际上做的是“把照片安全、可找回地存起来”。签名、上传和错误处理,都是为后面这一句服务的。
- 点赞
- 收藏
- 关注作者
评论(0)