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