ngrok で UnifyPort webhook をローカル開発する

ngrok が解決すること

コマンドを一つ叩けば、すべてのリクエストをローカルポートに転送する公開 HTTPS URL が得られます。通り抜けるトラフィックはすべて http://127.0.0.1:4040 のリクエスト inspector がキャプチャ——ヘッダ、ボディ、タイミング、replay ボタンつきで。この inspector があるからこそ、無料の代替トンネルが増えた今でも私たちは ngrok を使い続けています：本来ログを追いかけ続ける作業が、目線一つで済むレベルに圧縮されます。

UnifyPort ハンドラの 5 分セットアップ

ハンドラが port 3000 で待ち受けているとして：

1. 1. ngrok http 3000——出力された https://*.ngrok-free.app URL をコピー。
2. 2. POST /v1/webhook-endpoints で URL を登録——url を https://<your-tunnel>.ngrok-free.app/events にし、必要な subscribed_events を選択（イテレーション中は ["*"] で全部受けても可）。
3. 3. ブラウザで http://127.0.0.1:4040 を開く。プロバイダ側からイベントをトリガー——Telegram の DM、WhatsApp のメッセージなど——届くのを眺めましょう。
4. 4. replay ボタンで同じ配信を更新後のハンドラに再送。これがプロバイダ側で毎回イベントを焚き直すより速く ngrok を使う理由です。

ローカルで署名を検証する

無料 ngrok トンネルは上流で TLS を終端するため、あなたのハンドラがリクエストを見るときには body はすでに復号済み——まさに UnifyPort が署名したそれです。つまり署名検証は本番と同じ：hex(HMAC-SHA256(secret, timestamp + "." + body)) を計算し、X-Device-Signature ヘッダと突き合わせる。コードを書く前に手で確かめたいときは、私たちの CyberChef レシピ でブラウザ上の同じアルゴリズムを試せます。

ngrok が最適解でなくなるとき

• staging や demo 環境。無料 URL は再起動ごとに変わり、長期設定が壊れます。有料の予約ドメインに上げるか、Cloudflare Tunnel に乗り換えて無料の固定ホスト名を入手しましょう。
• 高頻度の負荷テスト。無料 ngrok のスロットリングはきつい。アップグレードするか、実環境でハンドラを動かしてください。
• webhook 専用、他に HTTP トラフィックがないワークフロー。smee.io の方が軽い——バイナリ不要で、クライアントスクリプトだけ。