1. 電卓を探す
  2. 数値と単位を入力する
  3. 結果の見方と信頼性
  4. 保存・共有・埋め込み
  5. APIで開発する
  6. アカウントとプラン
  7. プライバシーとデータ
  8. 問題を解決する

Webhook の署名を検証する

X-CalcLib-Signature ヘッダーから t.body の文字列を作り、シークレットで HMAC-SHA256 を計算して比較してから、受信した内容を処理してください。

APIトークン、利用状況、AIエージェント向けMCPサーバー、Webhook。

Webhooks で追加した Webhook エンドポイントには、誰かが埋め込みを実行するたびに、署名付きの POST が送信されます。すべての配信には、t=<unix time>,v1=<signature> という形式の X-CalcLib-Signature ヘッダーが付いています。

解析する前に検証する

  1. リクエストの生のボディを読み取ります。JSON を解析して再シリアライズするとバイト列が変わり、署名が一致しなくなります。
  2. ヘッダーから t を取り出し、t.body の文字列を作ります。タイムスタンプ、ドット、生のボディの順に連結します。
  3. その文字列に対して、エンドポイントのシークレットで HMAC-SHA256 を 16 進数で計算します。
  4. 計算結果を、各 v1 の値と定数時間で比較します。シークレットをローテーションしている間は、ヘッダーに v1 の値が 2 つ含まれることがあります。どちらか一方が一致すれば有効です。
  5. t がお使いのシステムの時刻から 5 分を超えてずれている場合は、その配信を拒否します。

配信に失敗した場合

1 分後、5 分後、30 分後、2 時間後、8 時間後に再試行します。連続して 20 回失敗したエンドポイントは無効になり、通知の製品メールの設定に従って、メールでお知らせします。

この記事は役に立ちましたか?

まだ解決しませんか? サポートに問い合わせる · ヘルプセンター