文档

签名机制

更新时间:

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

概述

RESTful API需要按如下格式在API请求头(Request Header)中添加Authorization参数进行签名:

Authorization:acs:AccessKeyId:Signature

其中:

  • acs:Alibaba Cloud Service的缩写,固定标识不可修改。

  • AccessKeyId:调用者调用API所用的密钥ID。

  • Signature:使用AccessKey Secret对请求进行对称加密的签名。

计算签名

签名算法遵循RFC 2104 HMAC-SHA1规范,使用AccessSecret对编码、排序后的整个请求串计算HMAC值作为签名。签名的元素是请求自身的一些参数,由于每个API请求内容不同,所以签名的结果也不尽相同。

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

完成以下操作,计算签名:

  1. 构建待签名字符串。

    待签名字符串(StringToSign)是API请求拼装的字符串,用于计算签名,包括:

    • HTTP协议Header

    • 阿里云协议Header(CanonicalizedHeaders)

    • 规范资源(CanonicalizedResource)

    • Body

    待签名字符串必须按照以下顺序构造:

    StringToSign = 
           //http协议Header
            HTTP-Verb + "\n" +
            Accept + "\n" +
            Content-MD5 + "\n" +//Body的MD5值放在此处
            Content-Type + "\n" +
            Date + "\n" +
           //阿里云协议header(CanonicalizedHeaders)
            CanonicalizedHeaders +
           //签名中如何包含CanonicalizedResource(规范资源)
            CanonicalizedResource

    构造示例如下:

    • 原始请求

      POST /stacks?name=test_alert&status=COMPLETE HTTP/1.1
      Host: ***.aliyuncs.com
      Accept: application/json
      Content-MD5: ChDfdfwC+Tn874znq7****==
      Content-Type: application/x-www-form-urlencoded;charset=utf-8
      Date: Thu, 22 Feb 2018 07:46:12 GMT 
      x-acs-signature-nonce: 550e8400-e29b-41d4-a716-44665544****
      x-acs-signature-method: HMAC-SHA1
      x-acs-signature-version: 1.0
      x-acs-version: 2016-01-02
    • 规范请求

      POST
      application/json
      ChDfdfwC+Tn874znq7****==
      application/x-www-form-urlencoded;charset=utf-8
      Thu, 22 Feb 2018 07:46:12 GMT
      x-acs-signature-nonce: 550e8400-e29b-41d4-a716-44665544****
      x-acs-signature-method:HMAC-SHA1
      x-acs-signature-version:1.0
      x-acs-version:2016-01-02
      /stacks?name=test_alert&status=COMPLETE
  2. 添加签名。

    将计算好的签名以如下格式添加到请求的Header中:

    Authorization: acs AccessKeyId:Signature

HTTP协议Header

计算签名必须包含以下参数,并按字典顺序排列;若值不存在则以\n补齐。

  • Accept:客户端需要的返回值类型。可选择application/jsonapplication/xml

  • Content-MD5:HTTP协议消息体的128-bit MD5散列值转换成Base64编码的结果。

  • Content-Type:RFC 2616中定义的HTTP请求内容类型。

  • Date:HTTP 1.1协议中规定的GMT时间。例如Wed, 05 Sep. 2012 23:00:00 GMT

    说明

    HTTP协议Header不包含Key。

构造示例如下:

  • 原始Header

    Accept: application/json
    Content-MD5: ChDfdfwC+Tn874znq7****==
    Content-Type: application/x-www-form-urlencoded;charset=utf-8
    Date: Thu, 22 Feb 2018 07:46:12 GMT
  • 规范Header

    application/json
    ChDfdfwC+Tn874znq7****==
    application/x-www-form-urlencoded;charset=utf-8
    Thu, 22 Feb 2018 07:46:12 GMT

阿里云协议Header(CanonicalizedHeaders)

阿里云规范头,非标准HTTP头部信息,是请求中出现的以x-acs-为前缀的参数。请求中必须包含以下参数:

  • x-acs-signature-nonce:唯一随机数,用于防止网络重放攻击。在不同请求间要使用不同的随机数值。

  • x-acs-signature-version:签名版本,取值为1.0

  • x-acs-version:API版本号,请参照各产品的API文档。

完成以下操作,构造阿里云规范头:

  1. 将所有以x-acs-为前缀的HTTP请求头的名字转换成小写字母。例如将X-acs-OSS-Meta-Name: TaoBao转换成x-acs-oss-meta-name: TaoBao

  2. 将上一步得到的所有HTTP阿里云规范头按照字典序进行升序排列。

  3. 删除请求头和内容之间分隔符两端出现的任何空格。例如将x-acs-oss-meta-name: TaoBao,Alipay转换成x-acs-oss-meta-name:TaoBao,Alipay

  4. 将所有的头和内容用\n分隔符分隔拼成最后的CanonicalizedHeaders。

构造示例如下:

  • 原始Header

    x-acs-signature-nonce: 550e8400-e29b-41d4-a716-44665544****
    x-acs-signature-method: HMAC-SHA1
    x-acs-signature-version: 1.0
    x-acs-version: 2016-01-02GMT
  • 规范Header

    x-acs-signature-nonce:550e8400-e29b-41d4-a716-44665544****
    x-acs-signature-method:HMAC-SHA1
    x-acs-signature-version:1.0
    x-acs-version:2016-01-02

规范资源(CanonicalizedResource)

CanonicalizedResource表示想要访问资源的规范描述,需要将子资源和query参数一同按照字典序,从小到大排列并以&为分隔符生成子资源字符串,即?后的所有参数。

构造示例如下:

  • 原始请求

    /stacks?status=COMPLETE&name=test_alert
  • 规范请求

    /stacks?name=test_alert&status=COMPLETE

Body

将请求的body用MD5算法加密,再进行Base64编码,将结果添加到Content-MD5中。

  • 本页导读 (1)
文档反馈