配置webhook

API使用webhook通知，以便系统自动通知您的系统与组织相关的更改。每当发生重大事件时，都会向您的webhook接收器发送事件资源 。

ricloud-py CLI包含Webhook端点的示例实现。

创建webhook配置

创建webhook配置所需的唯一内容是API将发送传出事件的URL。

ricloud-py实现了一个帮助命令：

> ricloud webhook-config create --url "<webhook receiver URL>"

等效的cURL调用看起来像：

curl https://ricloud-api.reincubate.com/configs/webhook \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "<webhook receiver URL>"
}'

对此请求的响应将包含webhook secret ，这对于保护您的webhook接收器实现在生产中非常重要。

验证事件签名

每个webhook请求都包含一个Ricloud-Signature标头，该标头应用于验证请求的内容是否未被更改。标头还包含一个时间戳，用于验证过程，以便对抗重放攻击。

ricloud-py包括此签名验证过程的实现。