由持有 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) |
| 建议 | 兼容旧场景 | 推荐使用 |
PUT 预签名 URL,浏览器直接把文件传到 OSS,文件流不经过应用服务器,省带宽与内存,也能绕过网关的请求体大小限制。GET URL,给用户下载或给前端 <img> 预览,无需公开 Bucket。InitiateMultipartUpload 拿 UploadId,再为每个分片各签一个 UploadPart URL,前端并发上传、断点续传。oss:PutObject 权限、10 分钟时长的临时 AK 再签名,泄露面进一步收窄。objectKey 就签名,否则等于给了整个 Bucket 的写权限(可覆盖他人文件、上传 HTML/SVG 造成 XSS)。