1
回答済み API

Webhook の署名検証には何を使いますか?

グレープ · 2026/11/06 10:54

社内で Webhook の受信処理を確認しています。X-RR-Signature の検証には、アプリのクライアントIDと Webhook のシークレットのどちらを使いますか?


回覆 (1)

Webhook 登録時のシークレットを使います。

2026-10-23の修正より前に登録した Webhook には、署名に使うシークレットがありません。このような Webhook は、配信のときに停止されます。届かなくなった場合は、Webhook を登録し直して、表示されたシークレットで検証してください。

検証の手順は次のとおりです。

  • X-RR-Signature の値は sha256= に続けて、リクエスト本文の HMAC-SHA256 を16進数で表したものです。
  • 本文はパースする前の生のバイト列を使います。
  • 鍵には Webhook のシークレットを使います。
var expected = "sha256=" + Convert.ToHexStringLower(
    HMACSHA256.HashData(Encoding.UTF8.GetBytes(secret), rawBodyBytes));
var isValid = CryptographicOperations.FixedTimeEquals(
    Encoding.UTF8.GetBytes(expected),
    Encoding.UTF8.GetBytes(Request.Headers["X-RR-Signature"]));

再送でも X-RR-Delivery は同じ値なので、処理済みのイベントを見分けるのに使えます。

変更の内容: https://receiptroller.io/ja-JP/developers/changelog

下田 工作人員 · 2026/11/06 10:57

您必須登入才能回覆。

登入