计算签名

计算签名

物联网平台会对每个接口访问请求的发送者进行身份验证，所以API请求，都需要在请求中包含签名（Signature）信息。

以下是计算签名的详细方法

1.获取密钥ID和密钥

在真正计算签名之前，有几个必备参数需要准备好

签名时，您需在控制台AccessKey管理页面查看您的密钥ID和密钥。其中， 密钥ID用于标识访问者身份；密钥是用于加密签名字符串和服务器端验证签名字符串的密钥，必须严格保密。

2.签名方法

请按照下面的方法对请求进行签名处理：

2.1.使用请求参数构造规范化的请求字符串（Canonicalized Query String）。

a. 排序参数。

按照参数名称的字典顺序，对请求参数（包括公共参数和接口的自定义参数，但不能包括“公共请求参数”的Signature参数本身）进行排序。

b.对每个请求参数的名称和值进行URL编码。

名称和值要使用UTF-8字符集按照RFC3986规则进行编码。编码规则如下：

• 字符A~Z、a~z、0~9以及字符-、_、.、~不编码。

• 其它字符编码成%XY的格式，其中XY是字符对应ASCII码的16进制表示。例如英文的双引号"对应的编码为%22。

• 扩展的UTF-8字符，编码成%XY%ZA…的格式。

• 英文空格要编码成%20，而不是加号+。

该编码方式与application/x-www-form-urlencodedMIME格式编码算法相似，但又有所不同。

如果您使用的是Java标准库中的java.net.URLEncoder，可以先用标准库中percentEncode编码，随后将编码后的字符中加号+替换为%20、星号*替换为%2A、%7E替换为波浪号~，即可得到上述规则描述的编码字符串。

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;
}

c.对编码后的参数名称和值使用英文等号（=）进行连接。

d.把英文等号连接得到的字符串按参数名称的字典顺序依次使用&符号连接。

完成后，即得到规范化请求字符串（CanonicalizedQueryString）。

2.2.构造签名字符串。

使用percentEncode处理步骤1得到的规范化字符串，构造用于计算签名的字符串。可参考如下规则：

StringToSign=
  HTTPMethod + "&" +                      
  percentEncode("/") + "&" +              
  percentEncode(CanonicalizedQueryString)

参数说明：

• HTTPMethod：发送请求的HTTP方法，例如GET。

• percentEncode("/")：字符“/”进行UTF-8编码得到的值，即“%2F”。

• percentEncode(CanonicalizedQueryString)：您的规范化请求字符串。

2.3.计算HMAC值。

按照RFC2104的定义，使用步骤2得到的字符串StringToSign计算签名HMAC值。

HMAC-SHA1( AccessSecret, UTF-8-Encoding-Of(StringToSign) )

2.4.计算签名值。

按照Base64编码规则把步骤3中的HMAC值编码成字符串，即得到签名值（Signature）。

Signature = Base64( HMAC-SHA1( AccessSecret, UTF-8-Encoding-Of(StringToSign) ) )

2.5.添加签名。

将得到的签名值作为Signature参数，按照RFC3986的规则进行URL编码后，再添加到请求参数中，即完成对请求签名的过程。