HarmonyOS 应用接入华为云 OBS:临时签名 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 的难点不在客户端代码,而在授权模型:凭证永远不下发到端上,服务端签发短时效、最小权限的授权,客户端只负责把字节发出去。把这层想清楚,云相册、头像、附件这些场景的实现都只是重复同一套模板。
- 点赞
- 收藏
- 关注作者
评论(0)