Configuration de Webhooks

L'API utilise Webhook notificatiosn afin de tenir votre système informé des changements liés à votre organisation automatiquement. Une ressource d'événement est envoyée à votre récepteur Webhook chaque fois qu'un événement important se produit.

La CLI ricloud-py contient un exemple d'implémentation d'un noeud final Webhook.

Création d'une configuration webhook

La seule chose nécessaire pour créer une configuration Webhook est l'URL à laquelle l'API enverra les événements sortants.

ricloud-py implémente une commande d'assistance:

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

L’appel cURL équivalent ressemblerait à ceci:

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>"
}'

La réponse à cette demande contiendra le secret Webhook, ce qui sera important pour sécuriser l'implémentation de votre récepteur Webhook en production.

Vérification des signatures d'événement

Chaque demande Webhook comprend un en Ricloud-Signature tête Ricloud-Signature qui doit être utilisé pour vérifier que le contenu de la demande n'a pas été modifié. L'en-tête contient également un horodatage, qui est utilisé dans le processus de vérification, afin de contrer les attaques par rejeu.

ricloud-py inclut une implémentation de ce processus de vérification de signature.