文档首页/ 云商店/ 接入指南/ 商品交易相关接口/ 订单通知/ 接入准备工作/ 1.2.2HTTP Body签名
更新时间：2024-10-23 GMT+08:00
查看PDF
分享

1.2.2HTTP Body签名

定义

云商店每次调用商家的接口时会根据一定规则对请求生成signature，并且将signature通过URL PARAMS的方式添加到URL上，商家在接收到请求后需要同样的规则对请求体进行重新计算signature，并且与云商店传递的signature相比较，完全相同即为校验通过，通过URL PARAMS传递的参数有：

参数

取值

描述

signature

String

加密签名，通过一定的规则对请求进行签名产生的值。

timestamp

Long

UNIX 时间戳（单位毫秒），商家需要校验这个时间戳与当前时间相差不超过60s。

nonce

String

随机字符串，云商店在每次调用时会随机生成，商家可以通过对这个随机数的缓存来防御API重放攻击。

生成规则

  1. 对请求参数排序，根据参数名自然排序，例如，以字母a开头的参数名会排在以b开头的参数前面，如果首字母相同，将会对第二个字母进行排序，以此类推，直到字符串结束
  2. 获取规范请求字符串，规则：

    canonicalRequest = accessKey + nonce + timestamp + Lowercase(HexEncode(HMAC_SHA256 (RequestPayload)))

3.根据规则对规范请求字符串，密钥取signature值，规则：

signature = HexEncode(HMAC_SHA256(canonicalRequest))

举例

商家收到的调用请求数据示例如下：

curl -X POST 'https://www.isvwebsite.com/saasproduce?signature=31BACBD867C7652D7581E8577A46D8FE778F3BC02553C4F130170613CD8C32F9×tamp=1729566664115&nonce=Of4lsV7H1qrzVDI52O5CFk2ofPcZRaA6' -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf-8' -d '{"activity":"orderNotify","orderId":"CS2211181819B4LVS","orderLineId":"CS2211181819B4LVS-000001","testFlag":"1"}'
父主题： 接入准备工作

相关文档