跳到主要内容

一、介绍

Webhook - WEBHOOK 类型的部署节点用于实现将OHTTPS中申请的证书通过webhook推送给用户。


二、使用方法

使用 Webhook - WEBHOOK 类型的部署节点,首先要在OHTTPS中创建Webhook类型部署节点,创建该类型部署节点时,需要提供Webhook的回调地址,以及生成一个回调令牌,当进行证书自动部署或者手动部署时,OHTTPS会通过POST方式去调用配置的回调地址,请求参数类型为application/json,具体请求参数格式如下:

{
timestamp, // 请求时间戳
payload: {
certificateName, // 证书ID
certificateDomains, // 证书关联域名
certificateCertKey, // 证书私钥(PEM格式)
certificateFullchainCerts, // 证书(包含证书和中间证书)(PEM格式)
certificateExpireAt // 证书过期时间
},
sign // 请求签名,`${timestamp}:${回调令牌}`的32位小写md5值
}

用户的回调地址服务可通过请求参数中的请求时间戳和的请求签名对请求进行校验,判断请求是否合法。

如果用户回调地址服务成功接收到了证书内容,需要返回响应状态200,响应体类型application/json,响应内容如下:

{
success: true
}