图片、视频或文件由客户端直接上传到阿里云 OSS,可以减少业务服务器转发文件的压力。不过,网页前端、移动应用和小程序都运行在用户可接触的环境里,不能把长期 AccessKey 放进去:代码混淆或打包并不能可靠地阻止密钥被提取。一旦长期密钥泄露,影响可能不止一次上传。
常见做法是使用阿里云 OSS STS 临时授权:长期密钥留在可信服务端,服务端先校验用户和业务条件,再申请一组有时效、受权限范围约束的临时凭证,交给客户端完成指定的 OSS 操作。客户端直传文件,服务端仍负责授权判断和结果确认。
阿里云 OSS STS 是什么
STS 是安全令牌服务(Security Token Service),可以为 RAM 角色签发临时访问凭证。客户端通常需要使用 AccessKeyId、AccessKeySecret 和 SecurityToken 这三项信息访问 OSS。凭证只在有效期内可用,过期后需要重新申请。
这几个服务分工不同:OSS 负责存储、读取和管理文件;RAM 用于配置身份和权限;STS 负责签发临时凭证。STS 不保存文件,也不会判断用户是否有资格上传某项业务资料。用户身份、业务状态以及上传结果,都需要由业务服务端处理。
为什么不把长期密钥放进客户端
客户端里的密钥可能被提取或复制。若它具备较广的 OSS 权限,拿到密钥的人就可能访问不属于自己的对象,或执行超出上传需要的操作。长期密钥不会因为某一次上传结束而自动失效,后续影响也更难控制。
采用阿里云 OSS STS 后,客户端不接触长期密钥。客户端先向业务服务端申请上传授权;服务端核实登录身份、上传资格等条件,再以可信身份调用 STS。客户端拿到临时凭证后按授权范围上传,凭证到期便不能继续使用。它仍然需要妥善保管,但有效时间和权限范围都可以收紧。
客户端直传 OSS 的流程
- 用户发起上传:客户端携带业务系统的登录态请求服务端,并说明要上传的文件类型或业务用途。不要让客户端仅凭一个可随意填写的用户编号领取授权。
- 服务端检查条件:核实用户身份、上传资格和当前业务状态,也可按业务规则检查文件类型、大小等信息。未通过校验时,不应签发凭证。
- 服务端申请临时凭证:服务端以可信身份调用 STS,扮演预先配置的 RAM 角色。角色权限策略应限制可访问的 Bucket、对象范围和操作类型。
- 服务端返回必要信息:将客户端完成上传所需的临时凭证和 OSS 配置信息返回给客户端,不返回长期 AccessKey。避免把凭证写入不必要的日志或长期缓存。
- 客户端上传文件:客户端使用 OSS SDK 和完整的临时凭证,将文件上传到授权的 Bucket 或对象路径。凭证允许的操作以实际权限策略为准。
- 服务端确认结果:上传结束后,业务服务端可检查对象是否存在、路径和大小是否符合要求,再更新业务记录。不能把客户端报告“上传成功”直接当成文件已通过业务审核。
STS 凭证是访问 OSS 的临时授权,不是用户登录凭证,也不等于文件已经审核通过。即使凭证获取和上传都成功,业务服务端仍需完成必要的结果校验。
案例:用户头像上传
假设一个社区应用允许用户更换头像。若客户端持有可写入整个 Bucket 的长期密钥,用户就可能尝试覆盖其他对象,甚至执行头像上传以外的操作。改用阿里云 OSS STS 后,服务端先确认用户已登录,再按用户身份生成头像对象路径,并让临时授权只覆盖该用户需要写入的位置和上传操作。
客户端取得凭证后,只能在授权范围和有效期内操作,不能因此读取其他用户的头像或管理整个 Bucket。上传完成后,服务端再核验对象路径及文件信息,并更新用户资料。配置时要特别检查路径是否由服务端控制:如果任由客户端提交完整对象名,用户可能尝试把文件写到预期范围之外。
权限配置时要检查的事项
- 按最小权限配置:只开放当前业务需要的 Bucket、对象路径和操作类型。头像上传通常不需要列举整个存储空间、删除对象或读取其他文件;不要为了让请求通过而一次性扩大权限。
- 限制 RAM 角色的信任关系:检查哪些可信身份可以扮演该角色,避免与上传服务无关的账号也能申请到相同凭证。权限策略和信任关系解决的是不同问题,排查时不要混为一谈。
- 设置合适的有效期:有效时间需要覆盖正常上传过程,也要考虑文件大小和网络状况。时间设得太短,上传可能中途失败;设得过长,则凭证意外泄露后的可用窗口会增加。
- 保护长期 AccessKey:长期密钥只应保存在服务端安全配置中,不要写进前端代码、公开代码仓库、客户端安装包或普通业务日志。
- 由服务端控制对象路径:不要把客户端传来的文件名直接当作可信对象路径。服务端应按业务规则生成或规范化对象名,并校验文件类型、大小等条件。
常见问题与排查思路
临时凭证提示权限不足
先核对 RAM 角色的权限策略是否覆盖目标 Bucket、对象路径和实际执行的操作,再确认请求访问的资源名称与策略范围一致。还要区分两种情况:角色本身没有相应权限,或者当前服务端身份没有被允许扮演该角色。只检查权限策略,可能会漏掉角色扮演关系的问题。
凭证申请成功,上传仍然失败
客户端调用 OSS 时需要带上完整的临时凭证,包括 SecurityToken;只填写 AccessKeyId 和 AccessKeySecret 通常不够。随后检查凭证是否过期、Bucket 和地域配置是否匹配,以及请求的对象路径和操作是否落在授权范围内。若是上传较大的文件,也要确认凭证有效时间能覆盖实际上传过程。
浏览器提示跨域错误
浏览器直传还需要配置 OSS Bucket 的跨域资源共享规则。按实际网站域名、请求方法和请求头设置来源范围,不要为了省事直接对所有来源开放。跨域规则只影响浏览器能否发起和读取请求,不会授予 OSS 权限,也不能替代 RAM 策略。
让临时授权范围与上传需求一致
阿里云 OSS STS 适用于客户端直传、又不希望暴露长期密钥的场景。落地时,服务端负责验证用户和业务条件,RAM 角色限定可扮演的身份及权限范围,STS 签发短期凭证,客户端完成上传,服务端核验结果。把对象路径、操作类型和有效期都控制在业务所需范围内,既能减少长期密钥暴露,也能避免临时授权被用于无关操作。