差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 后一修订版 | 前一修订版 | ||
| 代码术语:oss [2026/11/20 11:53] – 创建 张叶安 | 代码术语:oss [2026/11/20 11:55] (当前版本) – 去掉指向本页自身的自链接 张叶安 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | 1 | + | ====== OSS 预签名(Presigned URL) ====== |
| + | |||
| + | ===== 一句话定义 ===== | ||
| + | |||
| + | 由持有 AccessKey 的服务端,为**某个具体对象**和**某个具体操作(读或写)**临时签出的带签名 URL;拿到 URL 的人无需任何凭证,在有效期内即可完成这一次操作。 | ||
| + | |||
| + | ===== 解决什么问题 ===== | ||
| + | |||
| + | 私有 Bucket 的文件默认只有带凭证的请求能读写,但下面这些请求方不能持有 AccessKey(泄露即等于账号被盗): | ||
| + | |||
| + | * 浏览器前端、移动端 App | ||
| + | * 第三方合作方 | ||
| + | * 邮件 / IM 里临时分享的下载链接 | ||
| + | |||
| + | 预签名把鉴权基准从「请求方是谁」换成了「URL 本身是否被合法签过名」。 | ||
| + | |||
| + | ===== 原理 ===== | ||
| + | |||
| + | 服务端用 AccessKeySecret 对请求要素做 HMAC 计算得到签名,再把签名与过期时间拼进 URL 的 query: | ||
| + | |||
| + | < | ||
| + | https:// | ||
| + | ? | ||
| + | & | ||
| + | & | ||
| + | </ | ||
| + | |||
| + | 参与签名的字符串(V1 简化形式): | ||
| + | |||
| + | < | ||
| + | VERB + " | ||
| + | + Date/ | ||
| + | + CanonicalizedResource | ||
| + | </ | ||
| + | |||
| + | **注意 Content-Type、Content-MD5 及部分自定义头也参与签名**,前端 PUT 上传时必须带上与服务端签名时一致的头,否则报 '' | ||
| + | |||
| + | ===== 签名版本对比 ===== | ||
| + | |||
| + | ^ 项目 ^ V1 ^ V4 ^ | ||
| + | | 算法 | HMAC-SHA1 | HMAC-SHA256 + 派生密钥 | | ||
| + | | 有效期上限 | 无明确硬上限,但风险大,建议很短 | 最长 7 天(604800 秒) | | ||
| + | | 支持 STS 临时凭证 | 弱 | 支持('' | ||
| + | | 建议 | 兼容旧场景 | **推荐使用** | | ||
| + | |||
| + | ===== 能做什么 ===== | ||
| + | |||
| + | - **前端直传**:服务端只签发一个 '' | ||
| + | - **私有文件临时下发**:后台生成 15 分钟有效期的 '' | ||
| + | - **分享给第三方**:给合作方一个限时、限对象、限方法的链接,到期自动失效,比「改成公共读」安全得多。 | ||
| + | - **大文件分片上传**:先 '' | ||
| + | - **上传约束**:配合服务端签名控制上传路径、大小上限、Content-Type 白名单。 | ||
| + | - **上传回调**:预签名 + callback 参数,让 OSS 在接收完成后回调业务服务端。 | ||
| + | |||
| + | ===== 使用注意事项 ===== | ||
| + | |||
| + | - **有效期就是权限本身**:URL 泄露后在到期前谁都能用,**OSS 侧无法单独吊销某条预签名 URL**。有效期要短,下载类通常 5–30 分钟,不要签「一年有效」。 | ||
| + | - **签名只能发生在服务端**:持有 Secret 的只有服务端,前端只能接收 URL。 | ||
| + | - **更稳的做法是 STS + 预签名**:申请只有 '' | ||
| + | - **路径由服务端决定**:不要让前端自带 '' | ||
| + | - **与 CDN 鉴权 URL 不是一回事**:预签名是 OSS 原生签名;CDN 侧一般用 URL 鉴权(A 型 / B 型)或回源鉴权,混用容易踩坑。 | ||
| + | - **不是唯一防线**:敏感数据仍需配合服务端加密、日志审计、防盗链、下载限速。 | ||
| + | |||
| + | ===== 相关术语 ===== | ||
| + | |||
| + | * AccessKey / AccessKeySecret | ||
| + | * STS 临时访问凭证 | ||
| + | * Multipart Upload(分片上传) | ||