鸿蒙云相册 OBS Header 签名排障:从 SignatureDoesNotMatch 到一次通过

举报
yd_239575663 发表于 2026/11/13 02:32:10 2026/11/13
【摘要】 做鸿蒙云相册时,App 不经过自建后端,而是直接调用华为云 OBS 的 REST API 上传、列举和读取照片。直连的代价是认证必须自己算:OBS 的 Header 签名只要拼串与实际请求有一处不一致,返回的就是 403 SignatureDoesNotMatch。本文按鸿蒙开发实践中心案例《用 OBS 打造个人云相册 app》的实现,讲清楚签名串怎么拼、403 如何定位,以及备份去重与清理...

做鸿蒙云相册时,App 不经过自建后端,而是直接调用华为云 OBS 的 REST API 上传、列举和读取照片。直连的代价是认证必须自己算:OBS 的 Header 签名只要拼串与实际请求有一处不一致,返回的就是 403 SignatureDoesNotMatch。本文按鸿蒙开发实践中心案例《用 OBS 打造个人云相册 app》的实现,讲清楚签名串怎么拼、403 如何定位,以及备份去重与清理怎么做。

一、签名串的固定格式

OBS Header 签名的待签字符串 StringToSign 由六部分按换行拼接:

StringToSign = HTTP-Verb + "\n"
  + Content-MD5 + "\n"
  + Content-Type + "\n"
  + Date + "\n"
  + CanonicalizedOBSHeaders
  + CanonicalizedResource

签名再按下面方式生成,放到请求头里:

Signature = Base64(HMAC-SHA1(SK, StringToSign))
Authorization: OBS <Access Key ID>:<Signature>

上传一张照片的 PUT 请求,待签字符串通常长这样(Date 用 GMT 时间):

PUT\n\nimage/jpeg\nWed, 12 Nov 2026 10:00:00 GMT\n/album-demo-7m3x9/photo_backup/v2/abc.jpg

先在本地把签名算对,再去拼请求。离线验算脚本:

import base64, hashlib, hmac

def obs_signature(sk: str, string_to_sign: str) -> str:
    digest = hmac.new(
        sk.encode("utf-8"),
        string_to_sign.encode("utf-8"),
        hashlib.sha1,
    ).digest()
    return base64.b64encode(digest).decode()

string_to_sign = (
    "PUT\n\nimage/jpeg\n"
    "Wed, 12 Nov 2026 10:00:00 GMT\n"
    "/album-demo-7m3x9/photo_backup/v2/abc.jpg"
)
print(obs_signature("请填自己的 SK,不要写真实密钥", string_to_sign))

注意:脚本里的 SK 只是占位写法。真实的 AK、SK 只填在 App 的设置页,不要写进文章、代码仓库或公开问题里。

二、SignatureDoesNotMatch 排查清单

按命中概率从高到低核对,每改一项就重新算一次签名再发请求:

  1. 设备时间。服务端会校验 Date,设备时间与服务器时间偏差过大直接判失败。先确认设备时间正确,再怀疑其他项。
  2. CanonicalizedResource。格式是 /桶名/对象键。对象键不要重复做 URL 编码,也不要把桶名拼进 Endpoint 再拼一次。
  3. x-obs- 开头的请求头。所有 x-obs- 前缀的请求头都要按字典序拼进 CanonicalizedOBSHeaders,漏一个或多一个,签名都会变。案例里同名对象保护用的 x-obs-forbid-overwrite 就属于这一类。
  4. Content-Type 与 Content-MD5。签名时填了什么,请求就发什么;没传就留空行,不要一边空着一边又补默认值。
  5. Endpoint 与区域。桶在哪个区域,就用哪个区域的 Endpoint,例如华北-北京四是 obs.cn-north-4.myhuaweicloud.com,不要照抄示例值。资源包、桶的区域与单 / 多 AZ 策略也要匹配,否则抵扣不上。
  6. AK、SK 本身。确认是已开启编程访问的最小权限 IAM 用户的密钥,权限至少覆盖本桶的 obs:bucket:ListBucket、obs:object:PutObject、obs:object:GetObject;密钥被删除或重新创建后,旧的立即失效。
  7. 私有桶的读取。云端列表、缩略图和预览都是对原对象做签名 GET,请求头与签名不一致同样报 403,不要只排上传不排读取。

三、备份去重:不重复传已备份的文件

案例的对象键由本地 URI、大小、修改时间与 MD5 等信息生成,统一用 photo_backup/v2/ 前缀。备份逻辑有三点值得照搬:

  • 已完成的文件跳过:依据目标隔离的本地记录、MD5 和云端 ETag 核验,匹配上的不再上传;
  • 取消要重传当前文件:取消后当前文件需整文件重新上传,不支持字节级断点续传;
  • 上限要记牢:单文件上传和预览上限 64 MiB,云预览磁盘缓存上限 128 MiB,超过这个体量的视频要另外做分段上传。

四、安全与清理,测完就做

  • AK、SK 在 App 设置页是密码态输入,但这只隐藏显示,不加密沙箱中保存的明文,生产应用应采用临时授权方案。
  • 测试用最小权限凭据和非敏感媒体,测完按控制台实际状态删除测试对象与不再用的桶,撤销或轮换测试密钥。
  • 桶启用版本管理时,删除当前对象不一定删除历史版本,要按控制台实际版本清理并确认费用。
  • 资源包只抵扣存储费,公网下载流量、读写请求以及超出额度或有效期的用量仍可能产生费用。

小结

OBS Header 签名的问题大多不在算法本身,而在拼串与实际请求不一致。先把 StringToSign 在本地算出来,逐项核对时间、资源路径、x-obs- 请求头、Content-Type 和区域 Endpoint,再发请求,SignatureDoesNotMatch 通常一次就能定位。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。