OpenApi签名生成工具使用说明（海康威视Infovision IoT）.pdfVIP

OpenApi 签名生成工具使用说明 一、背景描述 现场项目 进行OpenAPI 对接的时候，很多第三方都会用 postman 来验证我们的接口 是否正常，但是我们的接口调用需要签名认证，第三方会因为无法生成签名而无法正常调 用我们的接口。为了解决这个问题，特此编写该工具，一方面可以生成签名，方便第三方 通过 postman 测试；一方面展示签名的生成规则以及接口调用方式，使第三方对接口调用 认证更加容易理解。 二、软件说明 依赖.net 4.5 环境； 三、使用方法 1. 运行程序 2. 参数说明   Method：HTTP 请求方法GET/POST；   请求头(Headers)包括Accept ，Content-MD5，Content-Type ，Date，X-Ca-Key，X- Ca-Timestamp ，X-Ca-Nonce，X-Ca-Signature，X-Ca-Signature-Headers 等   Accept ：默认值为*/*。   Content-MD5 设置值：MD5 计算 body 的信息摘要，对信息摘要使用 BASE64 生成 Conten-MD5 字  符串，示例：encoderBase64(MD5(body.getBytes(“UTF-8”)))//其中 body 就是请求调用 接口时的 json 参数；允许为空。   Content-Type：默认值为 application/json   Date：当前时间，格式不做要求；允许为空。   X-Ca-Key：appKey，即 AK。   X-Ca-Timestamp：当前时间对应的时间戳；允许为空。   X-Ca-Nonce： UUID，结合时间戳防重复；允许为空。   X-Ca-Signature：签名，以 appSecret （即SK）为密钥，使用 HmacSHA256 算法对签名字符 串生成消息摘要，对消息摘要使用 BASE64 算法生成签名（签名过程中的编码方式全为 UTF- 8），公式如下：X-Ca-Signature=BASE64(HmacSHA256 (appSecret,UTF-8(httpHeaders + customHeaders + url));    X-Ca-Signature-Headers：参与签名计算的 header (请求头)的 key 值(转换为小写字母，多个 key 值按照字典排序，以英文逗号分隔，例如：x-ca-key,x-ca-nonce,x-ca-timestamp)。    接口地址：具体接口的相对地址(接口说明中的接口地址在调用前需要加上/artemis 的上下文)；  HmacSHA256 加密(生成签名)：以Secret （即SK）为密钥，使用HmacSHA256 算法对签名 字符串生成签名。签名字符串由 httpHeaders(指http 标准 header)、customHeaders （指自 定义header）、url 组成。各种语言 HmacSHA256 算法可以参  考如下博客说明：/love-snow/articles/8241314.html 3. 效果展示 以下以查询组织列表的接口(/api/resource/v1/org/advance/orgList) 为例展示下具体效 果，根据需求勾选需要传入的请求头信息，生成签名，把工具中勾选上的请求头信息复制 到PostMan 中，传入对应的头信息，填写Body 内容，发送请求，验证接口。