為保證API的安全調(diào)用，在調(diào)用API時阿里云會對每個API請求通過簽名（Signature）進(jìn)行身份驗證。無論使用HTTP還是HTTPS協(xié)議提交請求，都需要在請求中包含簽名信息。

概述

RPC API要按如下格式在API請求的Query中增加簽名（Signature）：

https://Endpoint/?SignatureVersion=1.0&SignatureMethod=HMAC-SHA1&Signature=CT9X0VtwR86fNWSnsc6v8YGOjuE%3D&SignatureNonce=3ee8c1b8-83d3-44af-a94f-4e0ad82fd6cf
其中：
  • SignatureMethod：簽名方式，目前支持HMAC-SHA1。
  • SignatureVersion：簽名算法版本，目前版本是 1.0。
  • SignatureNonce：唯一隨機數(shù)，用于防止網(wǎng)絡(luò)重放攻擊。用戶在不同請求間要使用不同的隨機數(shù)值,建議使用通用唯一識別碼（Universally Unique Identifier, UUID）。
  • Signature: 使用AccessKey Secret對請求進(jìn)行對稱加密后生成的簽名。

計算簽名

簽名算法遵循RFC 2104 HMAC-SHA1規(guī)范，使用AccessSecret對編碼、排序后的整個請求串計算HMAC值作為簽名。簽名的元素是請求自身的一些參數(shù)，由于每個API請求內(nèi)容不同，所以簽名的結(jié)果也不盡相同。

Signature = Base64( HMAC-SHA1( AccessSecret, UTF-8-Encoding-Of(
StringToSign)) )
完成以下操作，計算簽名：
  1. 構(gòu)建待簽名字符串
    1. 使用請求參數(shù)構(gòu)造規(guī)范化的請求字符串（Canonicalized Query String）:
      1. 按照參數(shù)名稱的字典順序?qū)φ埱笾兴械恼埱髤?shù)（包括公共請求參數(shù)和接口的自定義參數(shù)，但不包括公共請求參數(shù)中的Signature參數(shù)）進(jìn)行排序。

        當(dāng)使用GET方法提交請求時，這些參數(shù)就是請求URI中的參數(shù)部分，即URI中“?”之后由“&”連接的部分。

      2. 對排序之后的請求參數(shù)的名稱和值分別用UTF-8字符集進(jìn)行URL編碼。編碼規(guī)則如下：

        • 對A-Z、a-z和0-9以及“-”、“_”、“.”和“~”不編碼。

        • 其它字符編碼成 %XY 的格式，其中 XY 是字符對應(yīng)ASCII碼的16進(jìn)制表示。比如英文的雙引號（””）對應(yīng)的編碼為 %22。

        • 擴展的UTF-8字符，編碼成 %XY%ZA…的格式。

        • 英文空格要編碼成 %20，而不是加號（+）。

          該編碼方式和一般采用的 application/x-www-form-urlencoded MIME格式編碼算法（比如 Java標(biāo)準(zhǔn)庫中的 java.net.URLEncoder的實現(xiàn)）存在區(qū)別。編碼時可以先用標(biāo)準(zhǔn)庫的方式進(jìn)行編碼，然后把編碼后的字符串中的加號（+）替換成 %20，星號（*）替換成 %2A，%7E替換回波浪號（~），即可得到上述規(guī)則描述的編碼字符串。本算法可以用下面的percentEncode方法來實現(xiàn)： 

          private static final String ENCODING = "UTF-8";
private static String percentEncode(String value) throws UnsupportedEncodingException 
{
return value != null ? URLEncoder.encode(value, ENCODING).replace("+", "%20").replace("*", "%2A").replace("%7E", "~") : null;
}
        • 將編碼后的參數(shù)名稱和值用英文等號（=）進(jìn)行連接。
        • 將等號連接得到的參數(shù)組合按步驟 i 排好的順序依次使用“&”符號連接，即得到規(guī)范化請求字符串。
    2. 將第一步構(gòu)造的規(guī)范化字符串按照下面的規(guī)則構(gòu)造成待簽名的字符串。 
      StringToSign=
      HTTPMethod + “&” +
      percentEncode(“/”) + ”&” +
       percentEncode(CanonicalizedQueryString)

      其中：

      • HTTPMethod 是提交請求用的HTTP方法，比如GET。
      • percentEncode(“/”) 是按照步驟1.1中描述的 URL 編碼規(guī)則對字符 “/” 進(jìn)行編碼得到的值，即 %2F。
      • percentEncode(CanonicalizedQueryString) 是對步驟1中構(gòu)造的規(guī)范化請求字符串按步驟 1.2 中描述的URL編碼規(guī)則編碼后得到的字符串。
  2. 計算簽名
    1. 按照RFC2104的定義，計算待簽名字符串（StringToSign）的HMAC值。
      說明 計算簽名時使用的Key就是您持有的AccessKey Secret并加上一個 “&” 字符（ASCII:38）, 使用的哈希算法是SHA1。
    2. 按照Base64編碼規(guī)則把上面的HMAC值編碼成字符串，即得到簽名值（Signature）。
    3. 將得到的簽名值作為Signature參數(shù)添加到請求參數(shù)中。
      說明 得到的簽名值在作為最后的請求參數(shù)值提交時要和其它參數(shù)一樣，按照RFC3986的規(guī)則進(jìn)行URL編碼。

示例

以DescribeFabricOrganization API 為例，假設(shè)使用的AccessKey ID 為 testid， AccessKey Secret為testsecret。 簽名前的請求URL如下： 

http://baas.aliyuncs.com/?Action=DescribeFabricOrganization&Timestamp=2018-12-23T12:46:24Z&Format=XML&AccessKeyId=testid&SignatureMethod=HMAC-SHA1&SignatureNonce=3ee8c1b8-83d3-44af-a94f-4e0ad82fd6cf&Version=2018-12-21&SignatureVersion=1.0

使用testsecret&，計算得到的簽名值是： 

OLeaidS1JvxuMvnyHOwuJ+uX5qY=

最后將簽名作為Signature參數(shù)加入到URL請求中，最后得到的URL為： 

http://baas.aliyuncs.com/?Action=DescribeFabricOrganization&Timestamp=2018-12-23T12:46:24Z&Format=XML&AccessKeyId=testid&SignatureMethod=HMAC-SHA1&SignatureNonce=3ee8c1b8-83d3-44af-a94f-4e0ad82fd6cf&Version=2018-12-21&SignatureVersion=1.0&Signature=VyBL52idtt+oImX0NZC+2ngk15Q=