对象存储
对象存储
对象存储
文档指南
请输入
产品动态
产品公告
产品计费
快速入门
用户指南
存储桶管理
基础设置
容错与容灾
ObjectSet
文件管理
监控与告警
权限配置
IAM 策略管理
典型配置场景
IAM 子用户授权
使用工具及 SDK 的授权说明
接入点
单区域接入点（SRAP）
内容感知与处理（SenseFlow）
TOS Agent
数据处理
分层命名空间（HNS）
TOS Vectors
API 参考
向量桶
SDK 参考
Python-Vectors
向量桶
向量索引
Java-Vectors
向量桶
向量索引
Node.js-Vectors
向量桶
向量索引
工具指南
tosutil
常用命令
辅助命令
TOS Browser
FSX
TOS PyTorch Connector
tosfsspec
API 参考
签名机制
存储桶
桶基础操作
自定义域名
数据处理
媒体处理
视频转码
音频转码
ObjectSet
生命周期
对象
基础操作
分片上传
SDK 参考
Java
存储桶接口
管理桶配置
ObjectSet
对象接口
下载对象
数据处理
视频处理
日志配置
分层命名空间
Python
数据处理
存储桶接口
对象接口
上传对象
C++
存储桶接口
对象接口
Go
对象接口
存储桶接口
管理桶配置
ObjectSet
数据处理
日志配置
Node.js
存储桶接口
对象接口
上传对象
数据处理
Browser.js
上传对象
.NET
对象接口
PHP
对象接口
异常处理
Android
对象接口
iOS
对象接口
Harmony
存储桶接口
对象接口
上传对象
Rust
存储桶接口
桶基础操作
桶清单
自定义域名
对象接口
基础操作
错误码
01-SERVICE_ERROR
02-AUTH
03-ACCESS_CONTROL
04-QOS
05-REQUEST
06-BUCKET
07-LIFECYCLE
08-ACL
09-CORS
10-POLICY
11-MIRROR
12-REPLICATION
13-WEBSITE
14-NOTIFICATION
15-ENCRYPT
16-CUSTOMDOMAIN
17-OBJECT
18-TAG
19-MULTIPART
20-STORAGE_CLASS
21-CALLBACK
22-DATA_PROCESS
23-BATCH
24-STORAGE_LENS
25-INVENTORY
26-DIRECTORY_BUCKET
32-WORM
常见问题
最佳实践
AIGC-豆包大模型最佳实践
校验数据一致性
- 文档首页
对象存储API 参考签名机制URL 中包含签名
复制全文
下载 pdfURL 中包含签名
文档反馈
问问助手您可以在 URL 的查询参数中增加签名信息。该 URL 中包含 AK、有效期、资源、操作、签名等信息，任何使用该 URL 的人在有效期内都可以执行该 URL 对应的操作。这种方法称作预签名。
预签名 URL 格式
https://bucketname.tos-cn-beijing.volces.com/object
?X-Tos-Algorithm=TOS4-HMAC-SHA256
&X-Tos-Credential=<access-key-id>/<YYYYMMDD>/<region>/tos/request
&X-Tos-Date=20130721T201207Z
&X-Tos-Expires=86400
&X-Tos-SignedHeaders=host
&X-Tos-Signature=<signature>
&X-Tos-Security-Token=<security-token>
参数说明
参数 | 描述 | 是否必选 |
参数 | 描述 | 是否必选 |
X-Tos-Algorithm | 用于标记签名的版本及算法，当前只支持 TOS4-HMAC-SHA256。 | 是 |
X-Tos-Credential | 提供 AccessKey ID、日期，区域和服务信息。 格式为<acces-key-id>/<date>/<region>/tos/request，date格式为yyyyMMdd。 | 是 |
X-Tos-Date | 当前请求时间（UTC 时间），格式为yyyyMMddTHHmmssZ。 | 是 |
X-Tos-Expires | URL 的有效期，单位为秒，最小为 1，无固定上限，请根据业务需要设置。请确保使用的 SDK 为最新版本。 | 是 |
X-Tos-SignedHeaders | 列出用于计算签名的 Header，说明如下：
| 是 |
X-Tos-Signature | 计算出的签名。 | 否 |
X-Tos-Security-Token | 使用临时 AK/SK 鉴权时，必须加上该头域，值为 SecurityToken。 | 否 |
签名计算
URL 计算签名方式与 Header 签名，除了构造规范化请求（CanonicalRequest）上有所差异，其他流程都是相同的，差异点如下：
- 在创建预签名 URL 时，由于请求的内容未知，需要使用 UNSIGNED-PAYLOAD 代替 HashedPayload。
- CanonicalQueryString 中不包含 X-Tos-Signature 参数。
- 使用临时 AK/SK 鉴权时，必须带上 X-Tos-Security-Token 参数。
预签名 URL 示例
以下载对象为例，相关信息如下。
参数 | 值 |
参数 | 值 |
桶名 | examplebucket |
对象名 | exampleobject |
区域 | cn-beijing |
时间 | Sat, 1 Jan 2022 00:00:00 GMT |
AccessKeyId | testAK |
SecretAccessKey | testSK |
CanonicalRequest
GET
/exampleobject
X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=testAK%2F20220101%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20220101T000000Z&X-Tos-Expires=86400&X-Tos-SignedHeaders=host
host:examplebucket.tos-cn-beijing.volces.com
host
UNSIGNED-PAYLOAD
StringToSign
TOS4-HMAC-SHA256
20220101T000000Z
20220101/cn-beijing/tos/request
b0cda3030fc2db31d57af22c2a7ab4229434edff63f0982db8a3fb99b190677d
SigningKey
HMAC-SHA256(HMAC-SHA256(HMAC-SHA256(HMAC-SHA256("testSK", "20220101"), "cn-beijing"), "tos"), "request")
Signture
353aa55583eceb222aad4bdcb70d4045a202a4af9a3096f25a656b82c8ec2f56
预签名 URL
https://examplebucket.tos-cn-beijing.volces.com/exampleobject?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=testAK%2F20220101%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20220101T000000Z&X-Tos-Expires=86400&X-Tos-SignedHeaders=host&X-Tos-Signature=353aa55583eceb222aad4bdcb70d4045a202a4af9a3096f25a656b82c8ec2f56
最近更新时间：2026.10.19 15:05:57
这个页面对您有帮助吗？
有用
有用
无用
无用