不少网站和小程序允许用户上传头像、图片或附件。为了减轻服务器压力,开发者常常让前端直接把文件上传到 COS。可如果为了省事,把子用户的永久密钥写进前端代码,任何人打开浏览器开发者工具就能拿到它。万域云介绍基于临时密钥的直传方案,以及如何把权限限定在最小范围。

临时密钥直传的基本流程

整个流程分为三步:前端向自己的后端请求上传凭证;后端使用受控的永久密钥向 STS 申请临时密钥,并在申请时附带一份限定了操作和资源的策略;前端拿到临时密钥后直接调用 COS 上传。临时密钥带有有效期,到期后自动失效。按照腾讯云文档,申请时指定的权限范围决定了临时密钥能做什么。

前端请求后端获取临时密钥后直传 COS 的流程示意

配图为流程示意,非控制台截图或交易凭据。

策略限定的关键维度

维度限定方法示例思路风险提示
操作只授予上传相关操作简单上传与分块上传所需操作不授予删除、列出等操作
存储桶指定具体存储桶只允许上传到用户文件桶不使用所有桶的通配
路径前缀按用户或业务划分目录每个用户只能写入自己的目录不对整个桶授权
有效期设置较短的时长满足一次上传所需时间即可时长过长增加泄露影响

后端需要做好的几件事

第一,申请临时密钥前先校验用户登录状态,未登录的请求不发放凭证。第二,根据当前用户身份动态生成路径前缀,避免用户写入他人的目录。第三,用于申请临时密钥的永久密钥只保存在服务端,并采用最小权限的子用户。第四,记录每次发放凭证的用户和时间,便于追溯异常上传。

后端校验登录并按用户生成上传路径前缀的示意

配图为流程示意,非控制台截图或交易凭据。

示例:一次前端密钥泄露后的改造

某社区网站早期把子用户密钥写在前端脚本里,后来发现有人利用这对密钥向存储桶上传了大量无关文件。团队禁用了该密钥,改为后端发放临时密钥,策略只允许向“用户目录加用户编号”的前缀上传,有效期设为半小时。改造后,异常上传问题消失,存储费用也回到正常水平。

临时密钥能用于下载吗?

可以,只要在申请时授予相应的读取操作。但如果文件本身需要公开访问,通常通过 CDN 或公共读配置提供下载更合适,不必为每次下载都申请临时密钥。

申请临时密钥有频率限制吗?

有。官方文档提到生成临时密钥的接口存在默认的请求频率限制。对于访问量较大的站点,可以在后端为同一用户在有效期内复用凭证,避免每次上传都重新申请,同时要确保复用逻辑不会把凭证发给其他用户。

延伸阅读与办理

可继续阅读腾讯云账号给 CI 流水线发密钥,怎样最小授权并轮换?。需要办理时,先查看腾讯云账号服务说明,再通过万域云咨询入口说明用途与待核对事项。

官方资料

腾讯云:COS 临时密钥生成与使用;腾讯云:创建存储桶;腾讯云:子账号 API 密钥管理。资料核对日期:2026-11-02。文中清单为操作准备建议;产品条件、实际收费和可用功能以相应账号的官方页面及有效订单为准。