웹 훅 구성

API는 조직과 관련된 변경 사항을 자동으로 시스템에 알리기 위해 webhook을 사용합니다. 중요한 이벤트가 발생할 때마다 이벤트 리소스 가 웹 훅 수신자에게 전송됩니다.

ricloud-py CLI에는 웹 후크 엔드 포인트의 샘플 구현이 포함되어 있습니다.

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 요청에는 요청의 내용이 변경되지 않았 음을 확인하는 데 사용되는 Ricloud-Signature 헤더가 포함되어 있습니다. 헤더에는 또한 재생 공격에 대응하기 위해 검증 과정에서 사용되는 타임 스탬프가 포함됩니다.

ricloud-py 에는이 서명 확인 프로세스의 구현이 포함됩니다.