不少网站和小程序允许用户上传头像、图片或附件。为了减轻服务器压力,开发者常常让前端直接把文件上传到 COS。可如果为了省事,把子用户的永久密钥写进前端代码,任何人打开浏览器开发者工具就能拿到它。万域云介绍基于临时密钥的直传方案,以及如何把权限限定在最小范围。
临时密钥直传的基本流程
整个流程分为三步:前端向自己的后端请求上传凭证;后端使用受控的永久密钥向 STS 申请临时密钥,并在申请时附带一份限定了操作和资源的策略;前端拿到临时密钥后直接调用 COS 上传。临时密钥带有有效期,到期后自动失效。按照腾讯云文档,申请时指定的权限范围决定了临时密钥能做什么。

配图为流程示意,非控制台截图或交易凭据。
策略限定的关键维度
| 维度 | 限定方法 | 示例思路 | 风险提示 |
|---|---|---|---|
| 操作 | 只授予上传相关操作 | 简单上传与分块上传所需操作 | 不授予删除、列出等操作 |
| 存储桶 | 指定具体存储桶 | 只允许上传到用户文件桶 | 不使用所有桶的通配 |
| 路径前缀 | 按用户或业务划分目录 | 每个用户只能写入自己的目录 | 不对整个桶授权 |
| 有效期 | 设置较短的时长 | 满足一次上传所需时间即可 | 时长过长增加泄露影响 |
后端需要做好的几件事
第一,申请临时密钥前先校验用户登录状态,未登录的请求不发放凭证。第二,根据当前用户身份动态生成路径前缀,避免用户写入他人的目录。第三,用于申请临时密钥的永久密钥只保存在服务端,并采用最小权限的子用户。第四,记录每次发放凭证的用户和时间,便于追溯异常上传。

配图为流程示意,非控制台截图或交易凭据。
示例:一次前端密钥泄露后的改造
某社区网站早期把子用户密钥写在前端脚本里,后来发现有人利用这对密钥向存储桶上传了大量无关文件。团队禁用了该密钥,改为后端发放临时密钥,策略只允许向“用户目录加用户编号”的前缀上传,有效期设为半小时。改造后,异常上传问题消失,存储费用也回到正常水平。
临时密钥能用于下载吗?
可以,只要在申请时授予相应的读取操作。但如果文件本身需要公开访问,通常通过 CDN 或公共读配置提供下载更合适,不必为每次下载都申请临时密钥。
申请临时密钥有频率限制吗?
有。官方文档提到生成临时密钥的接口存在默认的请求频率限制。对于访问量较大的站点,可以在后端为同一用户在有效期内复用凭证,避免每次上传都重新申请,同时要确保复用逻辑不会把凭证发给其他用户。
延伸阅读与办理
可继续阅读腾讯云账号给 CI 流水线发密钥,怎样最小授权并轮换?。需要办理时,先查看腾讯云账号服务说明,再通过万域云咨询入口说明用途与待核对事项。
官方资料
腾讯云:COS 临时密钥生成与使用;腾讯云:创建存储桶;腾讯云:子账号 API 密钥管理。资料核对日期:2026-11-02。文中清单为操作准备建议;产品条件、实际收费和可用功能以相应账号的官方页面及有效订单为准。

