SGW服务会对每个访问的请求进行身份验证,所以无论使用HTTP还是HTTPS协议提交请求,都需要在请求中包含签名(Signature)信息。SGW通过使用Access Key ID和Access Key Secret进行对称加密的方法来验证请求的发送者身份。Access Key ID和Access Key Secret由阿里云官方颁发给访问者(可以通过阿里云官方网站申请和管理)。其中,Access Key ID用于标识访问者的身份,Access Key Secret是用于加密签名字符串和服务器端验证签名字符串的密钥,必须严格保密,只有阿里云和用户知道。

用户在访问时,按照下面的方法对请求进行签名处理:

  1. 使用请求参数构造规范化的请求字符串(Canonicalized Query String)。
    1. 按照参数名称的字典顺序对请求中所有的请求参数(包括文档中描述的“公共请求参数”和给定了的请求接口的自定义参数,但不能包括“公共请求参数”中提到Signature参数本身)进行排序。
      说明 当使用GET方法提交请求时,这些参数就是请求URI中的参数部分(即URL中“?”之后由“&”连接的部分)。
    2. 对每个请求参数的名称和值进行编码。名称和值要使用UTF-8字符集进行URL编码。编码规则请参考下表。
      字符 编码方式
      A-Z、a-z和0-9以及“-”、“_”、“.”和“~” 不编码。
      其它字符 编码成 %XY 的格式,其中 XY 是字符对应ASCII码的16进制表示。例如英文的双引号(””)对应的编码为 %22
      扩展的UTF-8字符 编码成 %XY%ZA…的格式。
      英文空格 编码成 %20,而不是加号(+)。

      该编码方式和一般采用的 application/x-www-form-urlencoded MIME格式编码算法(例如Java标准库中的 java.net.URLEncoder的实现)存在区别。编码时可以先用标准库的方式进行编码,然后把编码后的字符串中的加号(+)替换成 %20,星号(*)替换成 %2A%7E替换回波浪号(~),即可得到上述规则描述的编码字符串。

    3. 对编码后的参数名称和值使用英文等号(=)进行连接。
    4. 再把英文等号连接得到的字符串按参数名称的字典顺序依次使用&符号连接,即得到规范化请求字符串。
  2. 使用上一步构造的规范化字符串按照下面的规则构造用于计算签名的字符串:
    StringToSign=
      HTTPMethod + “&” +
      percentEncode(“/”) + ”&” +
      percentEncode(CanonicalizedQueryString)

    参数说明:

    • HTTPMethod 是提交请求用的HTTP方法,例如GET。
    • percentEncode(“/”) 按照1.ii中描述的URL编码规则对字符“/”进行编码得到的值,即“%2F”。
    • percentEncode(CanonicalizedQueryString) 是对第1步中构造的规范化请求字符串按步骤1.ii中描述的URL编码规则编码后得到的字符串。
  3. 按照RFC2104的定义,计算待签名字符串(StringToSign)的HMAC值。
    说明 计算签名时使用的Key就是您持有的AccessKey Secret并加上一个 “&” 字符(ASCII:38), 使用的哈希算法是SHA1。
  4. 按照Base64编码规则把上面的HMAC值编码成字符串,即得到签名值(Signature)。
  5. 将得到的签名值作为Signature参数添加到请求参数中,即完成对请求签名的过程。
    说明 得到的签名值在作为最后的请求参数值提交时要和其它参数一样,按照RFC3986的规则进行URL编码。

    以DescribeRegions为例,签名前的请求URL为:

    http://sgw.cn-shanghai.aliyuncs.com/?Timestamp=2020-02-23T12:46:24Z&Format=XML&AccessKeyId=testid&Action=DescribeRegions&SignatureMethod=HMAC-SHA1&SignatureNonce=3ee8c1b8-83d3-44af-a94f-4e0ad82fd6cf&Version=2018-05-11&SignatureVersion=1.0

    那么StringToSign就是:

    GET&%2F&AccessKeyId%3Dtestid%26Action%3DDescribeRegions%26Format%3DXML%26SignatureMethod%3DHMAC-SHA1%26SignatureNonce%3D3ee8c1b8-83d3-44af-a94f-4e0ad82fd6cf%26SignatureVersion%3D1.0%26Timestamp%3D2020-02-23T12:46:24Z%26Version%3D2018-05-11

    假如使用的Access Key Id是“testid”,Access Key Secret是“testsecret”,用于计算HMAC的Key就是“testsecret&”,则计算得到的签名值是:VaeN6G9xWXirTsh7mlSM55Ws+0s=

    签名后的请求URL为(注意增加了Signature参数):

    http://sgw.cn-shanghai.aliyuncs.com/?SignatureVersion=1.0&Action=DescribeRegions&Format=XML&SignatureNonce=3ee8c1b8-83d3-44af-a94f-4e0ad82fd6cf&Version=2018-05-11&AccessKeyId=testid&Signature=VaeN6G9xWXirTsh7mlSM55Ws+0s=&SignatureMethod=HMAC-SHA1&Timestamp=2020-02-23T12:46:24Z