Webhook の署名を検証する
X-CalcLib-Signature ヘッダーから t.body の文字列を作り、シークレットで HMAC-SHA256 を計算して比較してから、受信した内容を処理してください。
Webhooks で追加した Webhook エンドポイントには、誰かが埋め込みを実行するたびに、署名付きの POST が送信されます。すべての配信には、t=<unix time>,v1=<signature> という形式の X-CalcLib-Signature ヘッダーが付いています。
解析する前に検証する
- リクエストの生のボディを読み取ります。JSON を解析して再シリアライズするとバイト列が変わり、署名が一致しなくなります。
- ヘッダーから
tを取り出し、t.bodyの文字列を作ります。タイムスタンプ、ドット、生のボディの順に連結します。 - その文字列に対して、エンドポイントのシークレットで HMAC-SHA256 を 16 進数で計算します。
- 計算結果を、各
v1の値と定数時間で比較します。シークレットをローテーションしている間は、ヘッダーにv1の値が 2 つ含まれることがあります。どちらか一方が一致すれば有効です。 tがお使いのシステムの時刻から 5 分を超えてずれている場合は、その配信を拒否します。
配信に失敗した場合
1 分後、5 分後、30 分後、2 時間後、8 時間後に再試行します。連続して 20 回失敗したエンドポイントは無効になり、通知の製品メールの設定に従って、メールでお知らせします。