HarmonyOS 应用接入 OBS:Header 签名认证的五个关键步骤
最近在鸿蒙开发实践中心体验了一个用 OBS 打造个人云相册的案例:应用把手机里的照片、视频逐文件备份到华为云对象存储 OBS,云端可以浏览对象列表、查看缩略图和预览。整个方案里最值得单独拎出来讲的,是 OBS 的 Header 签名认证——它不依赖 SDK,完全用标准的 HTTP 请求头完成鉴权,理解了它,任何语言、任何端侧框架都能照着实现。
一、为什么是 Header 签名
OBS 的桶默认是私有的,任何读写请求都必须证明“你是谁、你有没有权限”。Header 签名(V1 签名方式)的核心思想很简单:把请求的关键信息拼成一个字符串,用 Secret Key(SK)对它做 HMAC-SHA1,再把结果放进 Authorization 请求头。服务端收到请求后用同样的规则重新算一遍签名,对得上就放行,对不上就返回 403。
这样做的好处是:SK 从不出现在请求体或 URL 里,签名只对当次请求有效,请求头、请求方法或资源路径被篡改都会导致签名失效。
二、准备凭证:最小权限是底线
开始之前需要两样东西:Access Key(AK)和 Secret Key(SK)。AK 是公开标识,相当于用户名;SK 是签名密钥,相当于密码,只在本地参与 HMAC 计算。
实践中有三点要特别注意:
- 不要用主账号的 AK/SK 做应用配置。建议创建一个仅开启“编程访问”的专用 IAM 用户,只授予它目标桶的
obs:object:PutObject、obs:object:GetObject和obs:bucket:ListBucket权限,范围以实际测试桶为限。 - 不要把 AK/SK 写死在代码或提交到代码仓。教学演示里常见的做法是把它们保存在应用设置页的输入框中,但要清楚:密码态输入框只隐藏显示,不等于加密存储。生产环境应使用临时授权或服务端下发签名的方案。
- AK/SK 绝不发到聊天记录、Issue、截图或公开文章里。一旦泄露,立即在控制台删除并重新创建。
三、构造 StringToSign:最容易出错的一步
StringToSign 是待签名的字符串,由六行按固定顺序拼接而成:
| 行 | 内容 | 说明 |
|---|---|---|
| 1 | HTTP Method | 如 PUT、GET、DELETE |
| 2 | Content-MD5 | 请求体的 MD5,无 body 时留空行 |
| 3 | Content-Type | 如 application/octet-stream,无则留空行 |
| 4 | Date | GMT 格式时间,如 Wed, 19 Nov 2026 08:00:00 GMT |
| 5 | CanonicalizedHeaders | 以 x-obs- 开头的自定义头,按字典序排列 |
| 6 | CanonicalizedResource | /桶名/对象 key,带子资源(如 ?acl) |
这里有三个经典踩坑点:
- 空行不能省略。第 2、3 行没有值时,必须保留一个空行和换行符,否则签名一定对不上。
- x-obs- 头要排序。所有自定义头按字典序升序排列,key 全小写,
key:value之间用冒号,每行末尾加换行符。 - 资源路径以斜杠开头。操作桶本身(如列举对象)时,对象 key 部分为空,只写
/桶名。
四、计算签名并组装 Authorization 头
以 SK 为密钥、StringToSign 为消息做 HMAC-SHA1 运算,得到 20 字节的二进制结果,再对它做 Base64 编码,就得到签名字符串 Signature。在 HarmonyOS 中,可以用系统提供的 @ohos.security.cryptoFramework 的 Mac 实例指定 SHA1 算法完成 HMAC 计算,Base64 用 util.Base64Helper。
组装后的请求头格式为:
Authorization: OBS <AK>:<Signature>
其中 OBS 是固定前缀。发送请求时还要带上参与签名的全部请求头:Date、Content-Type、Content-MD5(如果参与签名)以及所有 x-obs-* 自定义头。关键约束是:实际发送的请求头值必须与参与签名的值逐字节一致,差一个空格都会导致服务端重算的签名不匹配。
五、排障:先对时间,再对字符串
如果返回 403 SignatureDoesNotMatch,按这个顺序排查:
- 核对设备时间。Date 头与服务端时间偏差过大会直接被拒绝,云手机、模拟器的系统时间要先确认。
- 核对 StringToSign 的每一行。把本地拼出的字符串逐行打印出来,与规范逐行对照,重点看空行和换行符。
- 核对 AK、SK、Endpoint 和桶名。Endpoint 是区域域名,例如
obs.cn-north-4.myhuaweicloud.com,不要写成“桶名.Endpoint”或完整对象 URL。 - 核对桶策略与权限。签名正确不代表有权限,私有桶的访问策略和 IAM 授权要同时满足。
六、一个完整的请求长什么样
以“上传一张照片”为例,整体流程可以概括为:
AK / SK
│
▼
构造 StringToSign(Method + MD5 + Type + Date + x-obs 头 + 资源路径)
│
▼
HMAC-SHA1(SK, StringToSign) → Base64 → Signature
│
▼
Authorization: OBS AK:Signature
│
▼
发送 PUT 请求,服务端验签后写入对象
备份完成后,应用再按同样的签名方式发 GET 请求列举对象、拉取缩略图和预览,整条链路用的都是同一套认证逻辑。
结语
Header 签名看起来步骤多,但本质上只有一句话:把请求内容变成字符串,用 SK 签名后放进请求头。掌握了 StringToSign 的构造规则和“逐字节一致”的约束,再遇到 403 就能按部就班地定位,而不是凭感觉反复试错。希望这篇梳理能帮到正在把 HarmonyOS 应用接到 OBS 的你。
- 点赞
- 收藏
- 关注作者
评论(0)