Skip to main content
To ensure that the webhook notifications you receive are sent by CHIP and have not been tampered with, you should validate the signature included in each request.

Signature Header

Each webhook delivery request includes an X-Signature header field. This field contains a base64-encoded RSA PKCS#1 v1.5 signature of the SHA512 digest of the request body buffer.

Obtaining the Public Key

Unlike CHIP Collect, CHIP Send provides a dedicated public key for each webhook. You can obtain the public key by retrieving the webhook details via the Retrieve a Webhook API. The public_key field in the response contains the PEM-encoded RSA public key.

Verification Steps

  1. Retrieve the Payload: Get the raw request body (buffer) of the webhook notification.
  2. Get the Signature: Extract the value of the X-Signature header and base64-decode it.
  3. Verify: Use the RSA public key to verify the signature against the SHA512 digest of the raw request body.

Code Examples

Ruby

PHP

CHIP is not responsible for any financial losses incurred as a result of failing to implement payload signature verification.