如何通过API调用在IBM Datapower中添加Crypto Certificate

核心逻辑说明 #

你没找到对应文档是因为Crypto Certificate属于DataPower REST接口的配置对象分类，没有单独在证书操作章节高亮展示，直接操作CryptoCertificate配置对象即可完成新增。

前置要求 #

• 已开启目标域的REST Management Interface，操作用户分配了Crypto配置的读写权限
• 提前把待上传的证书文件转为无换行、无首尾标识的base64编码内容，删除-----BEGIN CERTIFICATE-----、-----END CERTIFICATE-----及所有换行符

REST接口调用示例 #

以下示例默认操作default域，操作自定义域时替换路径中的default为目标域名即可

• 请求方法：POST
• 请求地址：https://<datapower管理IP>:<管理端口，默认5554>/mgmt/config/default/CryptoCertificate
• 请求头：

  Content-Type: application/json
  Authorization: Basic <账号密码的base64编码>
  

• 请求体示例：

  {
    "CryptoCertificate": {
      "name": "业务侧自定义的证书标识名",
      "Filename": "证书在DataPower存储的文件名，例如pay_api_prod.cer",
      "certificate": "预处理后的证书base64编码内容",
      "AdminState": "enabled"
    }
  }
  

结果验证 #

请求成功会返回201 Created状态码，你也可以通过GET请求访问https://<datapower管理IP>:<管理端口>/mgmt/config/default/CryptoCertificate/<你设置的证书标识名>确认配置是否正确写入。

异常排查常见点 #

• 检查证书base64编码是否正确，不要带多余的空白字符
• 确认操作用户的权限范围，跨域操作需要对应域的配置权限
• 管理接口的访问IP白名单是否包含你发起请求的客户端地址

内容的提问来源于stack exchange，提问作者Vishal Ghadage