ホームに戻る

Webhookガイド

localhost トンネリング、ローカル Webhook デバッグ、ngrok の代替、最新の開発チーム向けの安全な HTTPS トンネルに関するガイド。

401 と 403 と記された施錠された扉に阻まれた Webhook リクエストと、それを開ける鍵。

なぜ Webhook が 401 や 403 を返すのか(そして直し方)

Webhook の 401・403 エラーはほぼ常に 5 つのうちのどれか。半日を無駄にする前にどれかを特定する診断ウォークスルー。

2026-06-15T13:41:56.000ZPortPreview Team
webhook debuggingHTTP errorsauthenticationtroubleshooting
リクエストのタイムラインから保存済みWebhookリクエストがローカルハンドラへ再送される様子。

Webhookリプレイ: 再送せずにデバッグする

Webhookリプレイは、上流イベントを再発生させずに、捕捉したコールバックをローカルハンドラへ再送します。リクエスト履歴とワンクリックリプレイで高速にデバッグ。

2026-06-15T13:41:56.000ZPortPreview Team
webhook debuggingreplaytestingcallbacks
重複するWebhookリクエストが冪等性キーのフィルタで1つのイベントに重複排除される様子。

Webhookのリトライと冪等性を涙なしで

Webhookプロバイダーは同じイベントを2回届けます。バグではなく仕様として扱いましょう。冪等なハンドラ、重複排除キー、リプレイ安全なコードの実践パターン。

2026-06-15T13:41:56.000ZPortPreview Team
webhook designidempotencyretriesdistributed systems
署名されたWebhookリクエストが署名検証ゲートで鍵に対して検証される様子。

Webhook署名検証、もう謎ではない

署名検証の失敗の多くは暗号のバグではなくパースのバグです。HMAC、タイミングセーフ比較、リプレイ攻撃、生ボディ処理への実践的な解決策。

2026-06-15T13:41:56.000ZPortPreview Team
webhook securityHMACsignature verificationbest practices
クラウドサービスから、リクエストインスペクターパネルを表示したノート PC へ流れる Webhook リクエスト。

Webhook をローカルでデバッグ:完全ガイド

安全なトンネル URL で Webhook をローカルにデバッグする方法を学びましょう。Stripe、GitHub、Twilio のコールバックをテストし、ペイロードを検査し、数秒でリクエストを再送できます。

2026-06-04T11:42:00.000ZPortPreview Team
webhook debuggingStripeGitHublocal testing