计算签名
更新时间：2025-09-17 08:20:19下载pdf
计算签名
物联网平台会对每个接口访问请求的发送者进行身份验证，所以API请求，都需要在请求中包含签名（Signature）信息。
说明
平台提供了Java语言的签名示例代码，参考代码，快速生成签名。下载java 签名示例代码
以下是计算签名的详细方法
1.获取密钥ID和密钥
在真正计算签名之前，有几个必备参数需要准备好
签名时，您需在控制台AccessKey管理页面查看您的密钥ID和密钥。其中， 密钥ID用于标识访问者身份；密钥是用于加密签名字符串和服务器端验证签名字符串的密钥，必须严格保密。
2.签名方法
请按照下面的方法对请求进行签名处理：
2.1.使用请求参数构造规范化的请求字符串（Canonicalized Query String）。
a. 排序参数。
按照参数名称的字典顺序，对请求参数（包括公共参数和接口的自定义参数，但不能包括“公共请求参数”的Signature参数本身）进行排序。
说明
当使用GET方法提交请求时，这些参数就是请求URL中的参数部分，即URL中?之后由&连接的部分。
b.对每个请求参数的名称和值进行URL编码。
名称和值要使用UTF-8字符集按照RFC3986规则进行编码。编码规则如下：
-
字符AZ、az、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) )
重要
计算签名时使用的Key就是您的AccessKeySecret并加上一个与号&字符（ASCII:38），使用的哈希算法是HMAC-SHA1。
2.4.计算签名值。
按照Base64编码规则把步骤3中的HMAC值编码成字符串，即得到签名值（Signature）。
Signature = Base64( HMAC-SHA1( AccessSecret, UTF-8-Encoding-Of(StringToSign) ) )
2.5.添加签名。
将得到的签名值作为Signature参数，按照RFC3986的规则进行URL编码后，再添加到请求参数中，即完成对请求签名的过程。
