手写 OBS V2 Header 签名:从 StringToSign 到 ArkTS 实现
手写 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、换行。
- 点赞
- 收藏
- 关注作者
评论(0)