注意事项

• 使用在URL中签名的方式，会将授权的数据在过期时间内曝露在互联网上，请预先评估使用风险。
• OSS不支持同时在URL和Header中包含签名。
• PUT和GET请求都支持在URL中签名。
• 您可以为PUT操作生成一个预签名的URL，该URL检查用户是否上传了正确的内容。SDK对请求进行预签名时，将计算请求正文的校验和，并生成包含在预签名URL中的MD5校验和。用户必须上传与SDK生成的MD5校验和相同的内容，否则操作失败。如果要验证MD5，只需在请求中增加Content-MD5头即可。

实现方式

• URL签名示例

  http://oss-example.oss-cn-hangzhou.aliyuncs.com/oss-api.pdf?OSSAccessKeyId=nz2pc56s936****&Expires=1141889120&Signature=vjbyPxybdZaNmGa%2ByT272YEAiv****

  如果需要使用STS用户构造URL签名，则必须携带 security-token，URL签名示例如下：

  http://oss-example.oss-cn-hangzhou.aliyuncs.com/oss-api.pdf?OSSAccessKeyId=nz2pc56s936****&Expires=1141889120&Signature=vjbyPxybdZaNmGa%2ByT272YEAiv****&security-token=SecurityToken

• 参数

  名称	是否必选	描述
  Expires	是	一个Unix时间戳（自UTC时间1970年01月01号开始的秒数），用于标识该URL的超时时间。如果OSS接收到该URL请求的时间晚于签名中包含的Expires参数时，则返回请求超时的错误码。例如当前时间是1141889060，开发者希望创建一个60秒后自动失效的URL，则可以设置Expires时间为1141889120。 说明 出于安全考虑，OSS控制台中默认URL的有效时间为3600秒，最大值为32400秒。
  OSSAccessKeyId	是	密钥中的AccessKeyId。
  Signature	是	签名信息。 签名信息的格式如下： Signature = urlencode(base64(hmac-sha1(AccessKeySecret, VERB + "\n" + CONTENT-MD5 + "\n" + CONTENT-TYPE + "\n" + EXPIRES + "\n" + CanonicalizedOSSHeaders + CanonicalizedResource))) 所有OSS支持的请求和各种Header参数，在URL中进行签名的算法和在Header中包含签名的算法基本一样。 生成URL中的签名字符串时，除了将Date参数替换为Expires参数外，仍然包含CONTENT-TYPE、CONTENT-MD5、CanonicalizedOSSHeaders等在Header中包含签名中定义的Header（请求中虽然仍有Date请求Header，但无需将Date加入签名字符串中）。 在URL中包含签名时必须对URL进行urlencode。如果在URL中多次传入Signature、Expires或OSSAccessKeyId，则以第一次传入的值为准。 使用URL签名时，OSS会先验证请求时间是否晚于Expires时间，然后再验证签名。
  security-token	否	安全令牌。只有当使用STS用户构造URL签名时，才需要设置此参数。 说明 关于搭建STS服务的具体操作，请参见开发指南中的 使用STS临时访问凭证访问OSS。您可以通过调用STS服务的 AssumeRole接口或者使用 各语言STS SDK来获取临时访问凭证。临时访问凭证包括临时访问密钥（AccessKeyId和AccessKeySecret）和安全令牌（SecurityToken）。

• 使用SDK生成URL签名
  URL中添加签名的Python示例代码：

  import base64
  import hmac
  import hashlib
  import urllib
  h = hmac.new("OtxrzxIsfpFjA7SwPzILwy8Bw21TLhquhboDYROV",
               "GET\n\n\n1141889120\n/oss-example/oss-api.pdf",
               hashlib.sha1)
  urllib.quote (base64.encodestring(h.digest()).strip())

  OSS SDK的URL签名实现，请参见下表。

  SDK	URL签名方法	实现文件
  Java SDK	OSSClient.generatePresignedUrl	OSSClient.java
  Python SDK	Bucket.sign_url	api.py
  .Net SDK	OssClient.GeneratePresignedUri	OssClient.cs
  PHP SDK	OssClient.signUrl	OssClient.php
  JavaScript SDK	signatureUrl	Object.js
  C SDK	oss_gen_signed_url	oss_object.c
  C++ SDK	OssClient::GeneratePresignedUrl	OssClient.cc

SDK

错误码