手写 OBS V2 Header 签名:从 StringToSign 到 ArkTS 实现

举报
yd_290540706 发表于 2026/11/10 14:45:22 2026/11/10
【摘要】 私有桶+端侧直传时,SDK之外还有一条路——自己算 Authorization 头。本文把 OBS V2 Header 签名的五段式拼接逐段拆开,给出 ArkTS 与 Node 两份可复现实现,并列出四个最常见的踩坑点。

手写 OBS V2 Header 签名:从 StringToSign 到 ArkTS 实现

摘要:私有桶 + 客户端直传时,SDK 之外还有一条路——自己算 Authorization 头。本文把 OBS V2 Header 签名的五段式拼接逐段拆开,给出 ArkTS 与 Node 两份可复现实现,并列出四个最常见的踩坑点。

一、什么时候需要自己算签名

对象存储的标准用法是调 SDK。但在 HarmonyOS 这类端侧场景里,常常出现两个现实约束:一是包体积,二是部分端侧运行环境对第三方 SDK 的依赖链不友好。于是很多人会退回到最原始的方式——直接发 HTTP 请求到 OBS 的 REST 接口。

桶一旦设为私有(生产环境基本都会这么设),每个请求就必须带认证头:

Authorization: OBS <AccessKeyId>:<Signature>

问题就变成一件事:这个 Signature 怎么算。OBS 支持 V2(Header 签名)和 V4 两套算法,端侧直传这种「请求简单、不想引签名库」的场景,V2 Header 签名足够了。

二、签名串是五段拼起来的

算法的核心不是 HMAC 本身,而是先把请求"规范化"成一个确定的字符串(StringToSign),再用 SK 做 HMAC-SHA1。规范化规则是:

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

注意最后两段是直接相接的,中间没有额外的换行——这是最容易写错的一处,下面细说。

1. HTTP-Verb

大写的方法名:PUT、GET、DELETE。小写 put 算出来的签名一定是 403。

2. Content-MD5

请求体的 MD5 值(Base64 编码)。没有请求体就留空。注意是编码后的 Base64 字符串,不是十六进制摘要。

3. Content-Type

必须与请求头里的 Content-Type 逐字符一致。这里有个隐蔽的坑:签名用的 image/jpeg,实际发出去的却是 image/jpeg; charset=utf-8,两者不一致,OBS 就会判定签名不匹配。建议把 Content-Type 抽成一个常量,签名和发请求都引用它。

4. Date

GMT 格式:Tue, 10 Nov 2026 06:30:00 GMT。不能用本地时间,也不要带时区偏移量。

因为 Date 参与签名,每个请求的签名都不一样,不存在「算一次缓存起来」的做法。如果端侧时钟偏差超过 15 分钟,OBS 会直接拒绝——这也是端侧签名最常见的「代码没改却突然 403」的原因,先校时再排查代码。

5. CanonicalizedHeaders

只收集 x-obs- 开头的自定义头,规则是:

  • 键名全部小写
  • 按字典序升序排列
  • 每个头一行,格式 name:value,行尾带 \n
  • 值要去掉首尾空格,值内部多个空格压成一个

没设置任何 x-obs- 头时,这一段就是空字符串。

6. CanonicalizedResource

格式为 /<桶名>/<对象键>:

/album-demo-7m3x9/photos/IMG_0001.jpg

三个要点:

  • 桶名不带 endpoint,不能写成 album-demo-7m3x9.obs.cn-north-4.myhuaweicloud.com
  • 对象键就是桶内的完整路径,不做 URL 编码(保持原样)
  • 如果带了子资源(如 ?acl、?uploads),要按字典序追加到末尾

三、ArkTS 参考实现

@kit.CryptoArchitectureKit 里的 cryptoFramework 提供了 HMAC 能力,不需要引第三方库。

import { cryptoFramework } from '@kit.CryptoArchitectureKit';
import { buffer, util } from '@kit.ArkTS';

async function hmacSha1Base64(key: string, data: string): Promise<string> {
  // 1. 把 SK 转成 SymKey
  const keyGen = cryptoFramework.createSymKeyGenerator('HMAC');
  const keyBlob: cryptoFramework.DataBlob = {
    data: new Uint8Array(buffer.from(key, 'utf-8').buffer),
  };
  const symKey = await keyGen.convertKey(keyBlob);

  // 2. 用 SHA1 做 MAC
  const mac = cryptoFramework.createMac('SHA1');
  await mac.init(symKey);
  await mac.update({ data: new Uint8Array(buffer.from(data, 'utf-8').buffer) });
  const macBlob = await mac.doFinal();

  // 3. Base64 编码
  return new util.Base64Helper().encodeToStringSync(macBlob.data);
}

export async function buildAuthorization(
  ak: string, sk: string, bucket: string, objectKey: string,
  contentType: string, date: string, xobsHeaders: Record<string, string> = {},
): Promise<string> {
  const canonicalHeaders = Object.keys(xobsHeaders)
    .map((k): [string, string] => [k.toLowerCase(), xobsHeaders[k].trim()])
    .filter(([k]) => k.startsWith('x-obs-'))
    .sort((a, b) => (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0))
    .map(([k, v]) => `${k}:${v}\n`)
    .join('');

  const stringToSign =
    'PUT' + '\n' +
    '' + '\n' +               // Content-MD5,无请求体时留空
    contentType + '\n' +
    date + '\n' +
    canonicalHeaders + '/' + bucket + '/' + objectKey;

  const signature = await hmacSha1Base64(sk, stringToSign);
  return `OBS ${ak}:${signature}`;
}

最后把 Authorization、Content-Type、Date 和 x-obs-* 头一起塞进请求即可。签名本身不包含 Host,但发请求时 Host 必须与桶所在区域的 endpoint 一致。

四、用脚本离线验证签名

签名算错时,靠肉眼比对 StringToSign 很难定位。更稳的做法是先用 Node 把整个流程跑一遍,拿到确定的中间值,再去对照端侧实现。

const crypto = require('crypto');

function sign({ ak, sk, bucket, objectKey, contentType, date, extraHeaders = {} }) {
  const canonicalHeaders = Object.keys(extraHeaders)
    .map((k) => [k.toLowerCase(), String(extraHeaders[k]).trim()])
    .filter(([k]) => k.startsWith('x-obs-'))
    .sort((a, b) => (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0))
    .map(([k, v]) => `${k}:${v}\n`)
    .join('');

  const stringToSign = [
    'PUT', '', contentType, date,
    canonicalHeaders + '/' + bucket + '/' + objectKey,
  ].join('\n');

  const signature = crypto.createHmac('sha1', sk).update(stringToSign, 'utf8').digest('base64');
  return { stringToSign, signature, authorization: `OBS ${ak}:${signature}` };
}

const r = sign({
  ak: 'AKIAIOSFODNN7EXAMPLE',        // 占位符,勿用真实密钥
  sk: 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY',
  bucket: 'album-demo-7m3x9',
  objectKey: 'photos/IMG_0001.jpg',
  contentType: 'image/jpeg',
  date: 'Tue, 10 Nov 2026 06:30:00 GMT',
  extraHeaders: { 'x-obs-acl': 'private' },
});

console.log(JSON.stringify(r.stringToSign));
console.log(r.authorization);

这段代码的输出是确定可复现的:

StringToSign:
"PUT\n\nimage/jpeg\nTue, 10 Nov 2026 06:30:00 GMT\nx-obs-acl:private\n/album-demo-7m3x9/photos/IMG_0001.jpg"

Authorization:
OBS AKIAIOSFODNN7EXAMPLE:W8PGKPR1bv20Hg+mcHsoDLgmNSE=

有了这个基准,端侧算出来的签名只要对不上,就逐段 diff StringToSign:先看行数对不对(说明换行有没有丢),再看每行内容,最后看末两段是否被错误地插了换行。

五、四个高频错误

1. 末两段之间多插了换行。 把 CanonicalizedHeaders 和 CanonicalizedResource 当成两个独立数组元素拼进 join('\n'),结果多出一个 \n。代码看起来完全正确,签名永远对不上。

2. 没有 x-obs- 头时,仍拼了空字符串加换行。 正确做法是这一段为空,直接接资源路径。

3. Header 键名没转小写。 发了 X-OBS-ACL,签名里写的是 x-obs-acl,两边不一致。

4. 对象键做了 URL 编码。 签名里必须是未编码的原始键,编码只发生在实际请求行里。

六、一个必须说清的安全边界

上面这套流程里,AK/SK 是直接参与端侧计算的,意味着密钥落在了客户端。做实验、跑通链路没问题,但生产环境不该这么做:

  • 长期 AK/SK 写在客户端,一旦被逆出就是整个桶的读写权限;
  • 更合理的做法是用 临时凭证(IAM 委托 / STS 临时密钥,有效期可设到分钟级),或者干脆把签名放到服务端,端侧只拿一个短时效的预签名 URL;
  • 至少也要给专用 IAM 用户,权限收到单个桶的 obs:object:PutObject / obs:object:GetObject,别用主账号密钥。

签名算法本身不分生产测试,但密钥怎么放,决定了这套代码能不能上线。

小结

OBS V2 Header 签名的难点不在密码学,而在规范化:五个字段、固定的换行位置、确定的排序规则。把它写成一个纯函数、用脚本先跑出基准值、再用 diff 定位差异,基本可以一次通过。真出问题时,优先怀疑三件事——时钟、Content-Type、换行。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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