HarmonyOS 应用接入 OBS:Header 签名认证的五个关键步骤

举报
yd_235262479 发表于 2026/11/19 00:26:33 2026/11/19
【摘要】 最近在鸿蒙开发实践中心体验了一个用 OBS 打造个人云相册的案例:应用把手机里的照片、视频逐文件备份到华为云对象存储 OBS,云端可以浏览对象列表、查看缩略图和预览。整个方案里最值得单独拎出来讲的,是 OBS 的 Header 签名认证——它不依赖 SDK,完全用标准的 HTTP 请求头完成鉴权,理解了它,任何语言、任何端侧框架都能照着实现。 一、为什么是 Header 签名OBS 的桶默认...

最近在鸿蒙开发实践中心体验了一个用 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 计算。

实践中有三点要特别注意:

  1. 不要用主账号的 AK/SK 做应用配置。建议创建一个仅开启“编程访问”的专用 IAM 用户,只授予它目标桶的 obs:object:PutObject、obs:object:GetObject 和 obs:bucket:ListBucket 权限,范围以实际测试桶为限。
  2. 不要把 AK/SK 写死在代码或提交到代码仓。教学演示里常见的做法是把它们保存在应用设置页的输入框中,但要清楚:密码态输入框只隐藏显示,不等于加密存储。生产环境应使用临时授权或服务端下发签名的方案。
  3. 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,按这个顺序排查:

  1. 核对设备时间。Date 头与服务端时间偏差过大会直接被拒绝,云手机、模拟器的系统时间要先确认。
  2. 核对 StringToSign 的每一行。把本地拼出的字符串逐行打印出来,与规范逐行对照,重点看空行和换行符。
  3. 核对 AK、SK、Endpoint 和桶名。Endpoint 是区域域名,例如 obs.cn-north-4.myhuaweicloud.com,不要写成“桶名.Endpoint”或完整对象 URL。
  4. 核对桶策略与权限。签名正确不代表有权限,私有桶的访问策略和 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 的你。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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