签名机制

签名算法

1. 根据请求参数(公共参数和业务参数，不包含公共参数Signature)构造规范化请求字符串：CanonicalizedQueryString。

   第一步：请求参数排序。排序规则以参数名按照字典排序。

   第二步：请求参数编码。使用UTF-8字符集对每个请求参数的名称和参数取值进行URLEncode，一般在URLEncode后需对三种字符替换：加号（+）替换成 %20、星号（*）替换成 %2A、 %7E 替换回波浪号（~）。

   第三步：每对URLEncode后的参数名称和参数值，用=进行连接。每对之间使用&进行连接。得到规范化请求字符串：CanonicalizedQueryString。

2. 计算签名。
   sign = hash_hmac(‘sha256’, CanonicalizedQueryString, sk)

sign值为签名算法返回的16进制格式小写字符串。

签名样例：
b28616f50f00380341a647c73101a459d8119c9d4a98fcff5fa4a023f82ef229

计算签名时使用的sk为Accesskey对应的秘钥，使用的哈希算法是：HMAC-SHA256。

3. 将签名值作为Signature参数值添加到请求参数中。

签名计算完整样例

1. 构造规范化请求字符串样例

请求参数数组: 
array (
  'Mobile' => '1xxxxxxxxxx',
  'TplId'  => '1',
  'Code' => '123456',
  'PlayTimes'  => 1,
  'Action'  => 'CallVerify',
  'Version' => '2020-05-01',
  'SignatureVersion' => '1.0',
  'SignatureMethod' => 'HMAC-SHA256',
  'Timestamp' => '2020-04-15T14:58:22Z',
  'Service'   => 'voice',
  'Accesskey' => 'AKxxx',
)
第一步，请求参数排序：排序结果如下。
array (
  'Accesskey' => 'AKxxx',
  'Action'  => 'CallVerify',
  'Code' => '123456',
  'Mobile' => '1xxxxxxxxxx',
  'PlayTimes'  => 1,
  'Service'   => 'voice',
  'SignatureMethod' => 'HMAC-SHA256',
  'SignatureVersion' => '1.0',
  'Timestamp' => '2020-04-15T14:58:22Z',
  'TplId'  => '1',
  'Version' => '2020-05-01',
)
第二步请求参数和参数值URLEncode，结果如下：
array (
  'Accesskey' => 'AKxxx',
  'Action'  => 'CallVerify',
  'Code' => '123456',
  'Mobile' => '1xxxxxxxxxx',
  'PlayTimes'  => 1,
  'Service'   => 'voice',
  'SignatureMethod' => 'HMAC-SHA256',
  'SignatureVersion' => '1.0',
  'Timestamp' => '2020-04-15T14%3A58%3A22Z',
  'TplId'  => '1',
  'Version' => '2020-05-01',
)
第三步字符串拼接如下：
Accesskey=AKxxx&Action=CallVerify&Code=123456&Mobile=1xxxx&PlayTimes=1&Service=voice&SignatureMethod=HMAC-SHA256&SignatureVersion=1.0&Timestamp=2020-04-15T14%3A58%3A22Z&TplId=1&Version=2020-05-01

2.  根据待签串计算签名
sk = 'SKxxx'
CanonicalizedQueryString = "Accesskey=AKxxx&Action=CallVerify&Code=123456&Mobile=1xxxx&PlayTimes=1&Service=voice&SignatureMethod=HMAC-SHA256&SignatureVersion=1.0&Timestamp=2020-04-15T14%3A58%3A22Z&TplId=1&Version=2020-05-01"
//sign = hash_hmac('sha256', CanonicalizedQueryString, sk)
sign: b28616f50f00380341a647c73101a459d8119c9d4a98fcff5fa4a023f82ef229

各语言版本的签名

PHP (版本5.5+)

function sign($params, $secret_key)
{
    ksort($params, SORT_STRING);
    $str_encode = '';
    foreach($params as $k=>$v) {
        $str_encode .= rawurlencode($k).'='.rawurlencode($v).'&';
    }
    $str_encode = substr($str_encode, 0, -1);
    return hash_hmac("sha256", $str_encode, $secret_key);
}
//rawurlencode 实现的urlencode，符合上述签名URLEncode的要求，所以无需做替换

Python (版本2.7)

#-*- coding:utf-8 -*-
import sys, os, base64, datetime, hashlib, hmac 
import urllib
def sign(params, secret_key):
    str_encode = ''
    param_keys = sorted(params.keys())
    for key in param_keys:
        str_encode += urllib.quote(key,'~') + '=' + urllib.quote(str(params[key]),'~') + '&'
    print(str_encode[:-1])
    return hmac.new(secret_key, str_encode[:-1], hashlib.sha256).hexdigest()