署名ウェブフック配信
送信されるすべてのウェブフック配信は、HMAC-SHA256で署名されます。秘密鍵が設定されていないウェブフックには、秘密鍵が割り当てられ、一度だけ表示されます。秘密鍵が設定されていないウェブフックは「署名なし」と表示され、秘密鍵が設定されるまで配信は行われません。
- プラットフォーム › イベントとウェブフック › ウェブフック › 新機能: 署名シークレットなしで保存されたウェブフック(または、署名シークレットなしでアクティブとして再度保存されたウェブフック)には、強力なシークレットが割り当てられ、コピーボタンとともに一度だけ表示されます。その後、受信側にコピーしてください。このシークレットは二度と表示されません。
- ウェブフックに署名シークレットを設定すると、署名シークレットが設定または置き換えられます。32文字以上の文字列を入力するか、空白のままにして自動生成して一度だけ表示します。短い文字列は拒否されます。
- HMAC-SHA256は、送信ウェブフックに提供される唯一の署名形式です。
- WebhookとWebhook配信には「署名」列があります。秘密鍵が設定されていないWebhookは「署名なし - 秘密鍵が設定されていません」と表示され、配信は署名なしで送信されるのではなく、「送信されませんでした: このWebhookに署名秘密鍵が設定されていません」というエラーで失敗します。秘密鍵を設定するか(またはWebhookがアクティブな状態で再度保存する)、配信は署名付きで送信されます。
受信者の名前が検索できなかった(DNSエラー)ために配信が失敗した場合、接続失敗と同様に、Webhookの再試行回数の上限まで再試行されます。プラットフォームが拒否するターゲット(プライベートアドレス、メタデータアドレス、プラットフォームが呼び出していないスキームなど)は、最初の試行でも失敗します。
「決して失われることのないイベント」も参照してください。