代码术语:oss

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

后一修订版
前一修订版
代码术语: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: 
 + 
 +<code> 
 +https://bucket.oss-cn-hangzhou.aliyuncs.com/photo/a.jpg 
 +  ?OSSAccessKeyId=LTAI****** 
 +  &Expires=1735689600 
 +  &Signature=base64(hmac-sha1(secret, stringToSign)) 
 +</code> 
 + 
 +参与签名的字符串(V1 简化形式): 
 + 
 +<code> 
 +VERB + "\n" + Content-MD5 + "\n" + Content-Type + "\n" 
 +     + Date/Expires + "\n" + CanonicalizedOSSHeaders + "\n" 
 +     + CanonicalizedResource 
 +</code> 
 + 
 +**注意 Content-Type、Content-MD5 及部分自定义头也参与签名**,前端 PUT 上传时必须带上与服务端签名时一致的头,否则报 ''SignatureDoesNotMatch''。 
 + 
 +===== 签名版本对比 ===== 
 + 
 +^ 项目 ^ V1 ^ V4 ^ 
 +| 算法 | HMAC-SHA1 | HMAC-SHA256 + 派生密钥 | 
 +| 有效期上限 | 无明确硬上限,但风险大,建议很短 | 最长 7 天(604800 秒) | 
 +| 支持 STS 临时凭证 | 弱 | 支持(''x-oss-security-token'') | 
 +| 建议 | 兼容旧场景 | **推荐使用** | 
 + 
 +===== 能做什么 ===== 
 + 
 +  - **前端直传**:服务端只签发一个 ''PUT'' 预签名 URL,浏览器直接把文件传到 OSS,文件流不经过应用服务器,省带宽与内存,也能绕过网关的请求体大小限制。 
 +  - **私有文件临时下发**:后台生成 15 分钟有效期的 ''GET'' URL,给用户下载或给前端 ''<img>'' 预览,无需公开 Bucket。 
 +  - **分享给第三方**:给合作方一个限时、限对象、限方法的链接,到期自动失效,比「改成公共读」安全得多。 
 +  - **大文件分片上传**:先 ''InitiateMultipartUpload'' 拿 UploadId,再为每个分片各签一个 ''UploadPart'' URL,前端并发上传、断点续传。 
 +  - **上传约束**:配合服务端签名控制上传路径、大小上限、Content-Type 白名单。 
 +  - **上传回调**:预签名 + callback 参数,让 OSS 在接收完成后回调业务服务端。 
 + 
 +===== 使用注意事项 ===== 
 + 
 +  - **有效期就是权限本身**:URL 泄露后在到期前谁都能用,**OSS 侧无法单独吊销某条预签名 URL**。有效期要短,下载类通常 5–30 分钟,不要签「一年有效」。 
 +  - **签名只能发生在服务端**:持有 Secret 的只有服务端,前端只能接收 URL。 
 +  - **更稳的做法是 STS + 预签名**:申请只有 ''oss:PutObject'' 权限、10 分钟时长的临时 AK 再签名,泄露面进一步收窄。 
 +  - **路径由服务端决定**:不要让前端自带 ''objectKey'' 就签名,否则等于给了整个 Bucket 的写权限(可覆盖他人文件、上传 HTML/SVG 造成 XSS)。 
 +  - **与 CDN 鉴权 URL 不是一回事**:预签名是 OSS 原生签名;CDN 侧一般用 URL 鉴权(A 型 / B 型)或回源鉴权,混用容易踩坑。 
 +  - **不是唯一防线**:敏感数据仍需配合服务端加密、日志审计、防盗链、下载限速。 
 + 
 +===== 相关术语 ===== 
 + 
 +  * AccessKey / AccessKeySecret 
 +  * STS 临时访问凭证 
 +  * Multipart Upload(分片上传) 

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • 代码术语/oss.1795146837.txt.gz
  • 最后更改: 2026/11/20 11:53
  • 由 张叶安