AI 助理
备案控制台
文档
输入文档关键字查找
首页 物联网无线连接服务 开发参考 API参考 签名机制

签名机制

更新时间：
产品详情
相关技术圈
我的收藏

为保证API的安全调用，在调用API时阿里云会对每个API请求通过签名（Signature）进行身份验证。无论使用HTTP还是HTTPS协议提交请求，都需要在请求中包含签名信息。

签名方法

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

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

  1. 构造规范化的请求字符串（Canonicalized Query String）。

    1. 排序参数。

      按参数名的字典顺序，对请求参数进行排序，包括公共请求参数（不包括Signature参数）和接口的自定义参数。

      说明

      当使用GET方法提交请求时，这些参数就是请求URL中的参数部分，即URL中?之后由&连接的部分。

    2. 对参数名称和参数值进行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;
}

    3. 使用等号=连接编码后的请求参数名和参数值。

    4. 使用与号&连接编码后的请求参数。参数排序与步骤i的排序一致。

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

  2. 构造签名字符串。

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

    StringToSign=
  HTTPMethod + "&" +                      //HTTPMethod：发送请求的HTTP方法，例如GET。
  percentEncode("/") + "&" +              //percentEncode("/")：字符（/）UTF-8编码得到的值，即%2F。
  percentEncode(CanonicalizedQueryString) //您的规范化请求字符串。

  3. 计算HMAC值。

    按照RFC2104的定义，使用步骤2得到的字符串StringToSign计算签名HMAC值。示例使用的是Java Base64编码方法。

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

    计算签名时，使用的Key就是您的

    AccessKeySecret

    并加上一个与号&字符（ASCII:38）。使用的哈希算法是SHA1。

  4. 计算签名值。

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

  5. 添加签名。

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

签名示例

以调用GetCardFlowInfo接口为例。假设您的AccessKeyId=testid，AccessKeySecret=testsecret，ProductKey=12345abcde、TopicFullName=/12345abcde/testdevice/user/get、MessageContent=aGVsbG8gd29ybGQ。

  1. 组成签名前的请求URL。 

    http://linkcard.aliyuncs.com/?Action=GetCardFlowInfo&MessageContent=aGVsbG8gd29ybGQ&Timestamp=2021-12-24T11:43:57Z&SignatureVersion=1.0&ServiceCode=iot&Format=XML&Qos=0&SignatureNonce=432101234567&Version=2018-01-20&AccessKeyId=testid&SignatureMethod=HMAC-SHA1&RegionId=cn-shanghai&ProductKey=12345abcde&TopicFullName=/12345abcde/testdevice/user/get

  2. 计算得到待签名字符串StringToSign。 

    GET&%2F&AccessKeyId%3Dtestid%26Action%3DPub%26Format%3DXML%26MessageContent%3DaGVsbG8gd29ybGQ%26ProductKey%3D12345abcde%26Qos%3D0%26RegionId%3Dcn-shanghai%26ServiceCode%3Diot%26SignatureMethod%3DHMAC-SHA1%26SignatureNonce%3D432101234567%26SignatureVersion%3D1.0%26Timestamp%3D2018-07-31T07%253A43%253A57Z%26TopicFullName%3D%2F12345abcde%2Ftestdevice%2Fuser%2Fget%26Version%3D2018-01-20

  3. 计算签名值。

    因为AccessKeySecret=testsecret，用于计算的Key为testsecret&，计算得到的签名值为：

    z8Mf/mjEvaLCBrwkev9S3rvsjJs=

  4. 将签名作为Signature参数加入到URL请求中，最后得到的URL为： 

    https://linkcard.aliyuncs.com/?MessageContent=aGVsbG8gd29ybGQ&Action=GetCardFlowInfo&Timestamp=2021-12-24T11%503A43%253A57Z&SignatureVersion=1.0&ServiceCode=linkcard&Format=XML&Qos=0&SignatureNonce=432101234567&Version=2021-05-20&AccessKeyId=testid&Signature=%2BWylkkU*************T0NM%3D&SignatureMethod=HMAC-SHA1&RegionId=cn-shanghai&ProductKey=12345abcde&TopicFullName=%2F12345abcde%2Ftestdevice%2Fuser%2Fget

Java代码示例

以下为签名的Java Demo供您参考。

  1. 配置文件Config.java。 

    /*   
 * Copyright © 2018 Alibaba. All rights reserved.
 */
package com.aliyun.iot.demo.sign;
/**
 * 服务端API签名配置文件
 * 
 * @author: ali
 * @version: 0.1 2018-08-08 08:23:54
 */
public class Config {
    // AccessKey信息
    public static String accessKey = "1234567890123456";
    public static String accessKeySecret = "123456789012345678901234567890";
    public final static String CHARSET_UTF8 = "utf8";
}

    参数

    示例

    说明

    accessKey

    1234567890123456

    登录阿里云控制台，将鼠标移至账号头像上，然后单击AccessKey管理，获取AccessKey ID和AccessKey Secret。

    说明

    如果使用RAM用户，您需授予该RAM用户管理物联网无线连接服务的权限（AliyunLinkCardFullAccess），否则将连接失败。

    accessKeySecret

    123456789012345678901234567890

  2. 配置文件UrlUtil.java。 

    /*   
 * Copyright © 2018 Alibaba. All rights reserved.
 */
package com.aliyun.iot.demo.sign;
import java.net.URLEncoder;
import java.util.Map;
import org.apache.commons.lang3.StringUtils;
/**
 * URL处理类
 * 
 * @author: ali
 * @version: 0.1 2018-06-21 20:40:52
 */
public class UrlUtil {
    private final static String CHARSET_UTF8 = "utf8";
    public static String urlEncode(String url) {
        if (!StringUtils.isEmpty(url)) {
            try {
                url = URLEncoder.encode(url, "UTF-8");
            } catch (Exception e) {
                System.out.println("Url encode error:" + e.getMessage());
            }
        }
        return url;
    }
    public static String generateQueryString(Map<String, String> params, boolean isEncodeKV) {
        StringBuilder canonicalizedQueryString = new StringBuilder();
        for (Map.Entry<String, String> entry : params.entrySet()) {
            if (isEncodeKV)
                canonicalizedQueryString.append(percentEncode(entry.getKey())).append("=")
                        .append(percentEncode(entry.getValue())).append("&");
            else
                canonicalizedQueryString.append(entry.getKey()).append("=").append(entry.getValue()).append("&");
        }
        if (canonicalizedQueryString.length() > 1) {
            canonicalizedQueryString.setLength(canonicalizedQueryString.length() - 1);
        }
        return canonicalizedQueryString.toString();
    }
    public static String percentEncode(String value) {
        try {
            // 使用URLEncoder.encode编码后，将"+","*","%7E"做替换即满足API规定的编码规范。
            return value == null ? null
                    : URLEncoder.encode(value, CHARSET_UTF8).replace("+", "%20").replace("*", "%2A").replace("%7E",
                            "~");
        } catch (Exception e) {
        }
        return "";
    }
}

  3. 配置文件SignatureUtils.java。 

    /*   
 * Copyright © 2018 Alibaba. All rights reserved.
 */
package com.aliyun.iot.demo.sign;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URI;
import java.net.URISyntaxException;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.util.Map;
import java.util.TreeMap;
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import org.apache.commons.codec.binary.Base64;
import org.apache.commons.lang3.StringUtils;
/**
 * 服务端API签名
 * 
 * @author: ali
 * @version: 0.1 2018-06-21 20:47:05
 */
public class SignatureUtils {
    private final static String CHARSET_UTF8 = "utf8";
    private final static String ALGORITHM = "HmacSHA1";
    private final static String SEPARATOR = "&";
    public static Map<String, String> splitQueryString(String url)
            throws URISyntaxException, UnsupportedEncodingException {
        URI uri = new URI(url);
        String query = uri.getQuery();
        final String[] pairs = query.split("&");
        TreeMap<String, String> queryMap = new TreeMap<String, String>();
        for (String pair : pairs) {
            final int idx = pair.indexOf("=");
            final String key = idx > 0 ? pair.substring(0, idx) : pair;
            if (!queryMap.containsKey(key)) {
                queryMap.put(key, URLDecoder.decode(pair.substring(idx + 1), CHARSET_UTF8));
            }
        }
        return queryMap;
    }
    public static String generate(String method, Map<String, String> parameter, String accessKeySecret)
            throws Exception {
        String signString = generateSignString(method, parameter);
        System.out.println("signString---" + signString);
        byte[] signBytes = hmacSHA1Signature(accessKeySecret + "&", signString);
        String signature = newStringByBase64(signBytes);
        System.out.println("signature----" + signature);
        if ("POST".equals(method))
            return signature;
        return URLEncoder.encode(signature, "UTF-8");
    }
    public static String generateSignString(String httpMethod, Map<String, String> parameter) throws IOException {
        TreeMap<String, String> sortParameter = new TreeMap<String, String>();
        sortParameter.putAll(parameter);
        String canonicalizedQueryString = UrlUtil.generateQueryString(sortParameter, true);
        if (null == httpMethod) {
            throw new RuntimeException("httpMethod can not be empty");
        }
        StringBuilder stringToSign = new StringBuilder();
        stringToSign.append(httpMethod).append(SEPARATOR);
        stringToSign.append(percentEncode("/")).append(SEPARATOR);
        stringToSign.append(percentEncode(canonicalizedQueryString));
        return stringToSign.toString();
    }
    public static String percentEncode(String value) {
        try {
            return value == null ? null
                    : URLEncoder.encode(value, CHARSET_UTF8).replace("+", "%20").replace("*", "%2A").replace("%7E",
                            "~");
        } catch (Exception e) {
        }
        return "";
    }
    public static byte[] hmacSHA1Signature(String secret, String baseString) throws Exception {
        if (StringUtils.isEmpty(secret)) {
            throw new IOException("secret can not be empty");
        }
        if (StringUtils.isEmpty(baseString)) {
            return null;
        }
        Mac mac = Mac.getInstance("HmacSHA1");
        SecretKeySpec keySpec = new SecretKeySpec(secret.getBytes(CHARSET_UTF8), ALGORITHM);
        mac.init(keySpec);
        return mac.doFinal(baseString.getBytes(CHARSET_UTF8));
    }
    public static String newStringByBase64(byte[] bytes) throws UnsupportedEncodingException {
        if (bytes == null || bytes.length == 0) {
            return null;
        }
        return new String(Base64.encodeBase64(bytes, false), CHARSET_UTF8);
    }
}

  4. 配置主入口文件Main.java。 

    /*   
 * Copyright © 2018 Alibaba. All rights reserved.
 */
package com.aliyun.iot.demo.sign;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;
import java.util.HashMap;
import java.util.Map;
/**
 * 签名工具主入口
 * 
 * @author: ali
 * @version: 0.1 2018-09-18 15:06:48
 */
public class Main {
    // 1.需要修改Config.java中的AccessKey信息。
    // 2.建议使用方法二，所有参数都需要一一填写。
    // 3."最终signature"才是您需要的签名最终结果。
    public static void main(String[] args) throws UnsupportedEncodingException {
        // 方法一
        System.out.println("方法一：");
        String str = "GET&%2F&AccessKeyId%3D" + Config.accessKey
                + "%26Action%3DRegisterDevice%26DeviceName%3D1533023037%26Format%3DJSON%26ProductKey%3DaxxxUtgaRLB%26RegionId%3Dcn-shanghai%26SignatureMethod%3DHMAC-SHA1%26SignatureNonce%3D1533023037%26SignatureVersion%3D1.0%26Timestamp%3D2018-07-31T07%253A43%253A57Z%26Version%3D2018-01-20";
        byte[] signBytes;
        try {
            signBytes = SignatureUtils.hmacSHA1Signature(Config.accessKeySecret + "&", str.toString());
            String signature = SignatureUtils.newStringByBase64(signBytes);
            System.out.println("signString---" + str);
            System.out.println("signature----" + signature);
            System.out.println("最终signature: " + URLEncoder.encode(signature, Config.CHARSET_UTF8));
        } catch (Exception e) {
            e.printStackTrace();
        }
        System.out.println();
        // 方法二
        System.out.println("方法二：");
        Map<String, String> map = new HashMap<String, String>();
        // 公共参数
        map.put("Format", "JSON");
        map.put("Version", "2018-01-20");
        map.put("AccessKeyId", Config.accessKey);
        map.put("SignatureMethod", "HMAC-SHA1");
        map.put("Timestamp", "2018-07-31T07:43:57Z");
        map.put("SignatureVersion", "1.0");
        map.put("SignatureNonce", "1533023037");
        map.put("RegionId", "cn-shanghai");
        // 请求参数
        map.put("Action", "RegisterDevice");
        map.put("DeviceName", "1533023037");
        map.put("ProductKey", "a***UtgaRLB");
        try {
            String signature = SignatureUtils.generate("GET", map, Config.accessKeySecret);
            System.out.println("最终signature: " + signature);
        } catch (Exception e) {
            e.printStackTrace();
        }
        System.out.println();
    }
}
上一篇：公共参数下一篇：错误码
文档推荐