HarmonyOS 应用接入华为云 OBS:临时签名 URL 的落地实践

举报
yd_272594434 发表于 2026/11/19 13:18:00 2026/11/19
【摘要】 一、为什么不建议在 ArkTS 里直连 OBS给鸿蒙应用加一个"云相册"功能,最常见的想法是把华为云 OBS 的 AK/SK 写进应用里,用官方 SDK 直接上传。这在开发阶段跑得通,但一旦发布就是明显的安全问题:HAP 包可以被解包,密钥能被反编译拿到,别人可以用你的桶做任何事,账单也会记在你头上。正确做法是把凭证留在服务端,客户端只拿"一次性的临时凭证"或者"预签名 URL"。二、两种临...

一、为什么不建议在 ArkTS 里直连 OBS

给鸿蒙应用加一个"云相册"功能,最常见的想法是把华为云 OBS 的 AK/SK 写进应用里,用官方 SDK 直接上传。这在开发阶段跑得通,但一旦发布就是明显的安全问题:HAP 包可以被解包,密钥能被反编译拿到,别人可以用你的桶做任何事,账单也会记在你头上。正确做法是把凭证留在服务端,客户端只拿"一次性的临时凭证"或者"预签名 URL"。

二、两种临时授权方式

方式一:后端签发预签名 URL。服务端用正式 AK/SK 计算出一个带过期时间和签名的 PUT/GET 地址,客户端拿到后直接 PUT 文件。优点是客户端完全不需要 OBS SDK,只用 @ohos.net.http 发请求;缺点是一次只能传一个固定对象名,且签名要包含 Content-Type 等参与计算的头部,客户端不能随意改。

方式二:STS 临时密钥。服务端通过 IAM 委托换取临时 AK/SK 和 SecurityToken,下发给客户端,客户端再初始化 OBS SDK。适合一次授权连续上传多个文件,但临时密钥的权限要用 Policy 收窄到具体桶和前缀,最小化授权范围。

三、客户端上传的关键代码

import http from '@ohos.net.http';

async function putObject(signedUrl: string, fileUri: string) {
  const req = http.createHttp();
  const resp = await req.request(signedUrl, {
    method: http.RequestMethod.PUT,
    header: { 'Content-Type': 'application/octet-stream' },
    extraData: fileBuffer   // 从 fs 读出的 ArrayBuffer
  });
  return resp.responseCode === 200;
}

四、几个踩过的坑

1. Content-Type 必须一致。签名时如果把 Content-Type 计入待签头,客户端上传时必须发送完全相同的值,否则返回 SignatureDoesNotMatch。

2. 时钟偏差。预签名 URL 的过期判断依赖服务端时间,设备时间偏几分钟就可能"链接一生成就过期",建议拿服务器返回的时间校准。

3. 大文件要分片。单个请求超过几十兆后失败重传成本很高,应改用分片上传,把每片 5MB 左右,失败只重传单片。

4. 不要在前端拼接对象名。对象名由服务端生成(比如按用户 ID 和日期分前缀),既能避免覆盖,也方便后续按前缀做生命周期规则。

五、小结

鸿蒙端接 OBS 的难点不在客户端代码,而在授权模型:凭证永远不下发到端上,服务端签发短时效、最小权限的授权,客户端只负责把字节发出去。把这层想清楚,云相册、头像、附件这些场景的实现都只是重复同一套模板。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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