目录

OSS 预签名(Presigned URL)

一句话定义

由持有 AccessKey 的服务端,为某个具体对象和某个具体操作(读或写)临时签出的带签名 URL;拿到 URL 的人无需任何凭证,在有效期内即可完成这一次操作。

解决什么问题

私有 Bucket 的文件默认只有带凭证的请求能读写,但下面这些请求方不能持有 AccessKey(泄露即等于账号被盗):

预签名把鉴权基准从「请求方是谁」换成了「URL 本身是否被合法签过名」。

原理

服务端用 AccessKeySecret 对请求要素做 HMAC 计算得到签名,再把签名与过期时间拼进 URL 的 query:

https://bucket.oss-cn-hangzhou.aliyuncs.com/photo/a.jpg
  ?OSSAccessKeyId=LTAI******
  &Expires=1735689600
  &Signature=base64(hmac-sha1(secret, stringToSign))

参与签名的字符串(V1 简化形式):

VERB + "\n" + Content-MD5 + "\n" + Content-Type + "\n"
     + Date/Expires + "\n" + CanonicalizedOSSHeaders + "\n"
     + CanonicalizedResource

注意 Content-Type、Content-MD5 及部分自定义头也参与签名,前端 PUT 上传时必须带上与服务端签名时一致的头,否则报 SignatureDoesNotMatch。

签名版本对比

项目 V1 V4
算法 HMAC-SHA1 HMAC-SHA256 + 派生密钥
有效期上限 无明确硬上限,但风险大,建议很短 最长 7 天(604800 秒)
支持 STS 临时凭证 弱 支持(x-oss-security-token)
建议 兼容旧场景 推荐使用

能做什么

使用注意事项

相关术语