目次
n8nのWebhookは、外部からデータを受け取るための入口です。フォームの送信や、ほかのサービスからの通知を受け取るのに便利ですが、URLを知っている人なら誰でも呼び出せる状態のままだと、いたずらの送信で通知が大量に届いたり、意図しない処理が動いたりするおそれがあります。
n8nのWebhookには、呼び出しに認証をかける設定があります。今回は、ヘッダーに**合言葉(トークン)**を付けた呼び出しだけを受け付ける「Header Auth」を、編集部のローカル環境(n8n 2.47.7)で実際に設定して試しました。
仕組み
- n8nに「Header Auth」の認証情報を作る。ヘッダーの名前(例:
X-Webhook-Token)と、合言葉(長いランダムな文字列)を決める - Webhookノードの「Authentication」で「Header Auth」を選び、1の認証情報を指定する
- データを送る側は、毎回その名前のヘッダーに合言葉を付けて送る
合言葉が一致しない呼び出しは、n8nがワークフローを動かす前に拒否します。
試した結果
ヘッダー認証を設定したWebhookを有効にし、3通りの方法で呼び出しました。
| 呼び出し方 | 応答 | ワークフローの実行 |
|---|---|---|
| 合言葉のヘッダーなし | 403 Authorization data is wrong! |
動かない |
| 違う合言葉 | 403 Authorization data is wrong! |
動かない |
| 正しい合言葉 | 200 {"受付":"受け付けました:山田"} |
動いた |
# 正しい合言葉を付けて送る例(合言葉は自分で決めた長い文字列に置き換える)
curl -X POST https://n8n.example.com/webhook/secure-inquiry \
-H "Content-Type: application/json" \
-H "X-Webhook-Token: ここに合言葉" \
-d '{"name":"山田"}'
試して分かったこと
1. 拒否された呼び出しは、実行の記録に残らない
n8nの「Executions(実行の一覧)」には、正しい合言葉で受け付けた2回だけが記録され、403で拒否した呼び出しは表示されませんでした。拒否された呼び出しがどれくらい来ているかは、n8nの画面では分かりません。不審な呼び出しが気になる場合は、サーバーの手前(リバースプロキシなど)のアクセスログで確認することになります。
2. 有効にした直後の数秒は、呼び出しが届かないことがある
ワークフローを有効にしてすぐ(1秒以内)に呼び出したところ、404 The requested webhook "POST secure-inquiry" is not registered. と返りました。数秒後にもう一度呼び出すと、正常に受け付けました。有効にした直後は、Webhookの登録が終わるまで少し待つ必要があります。
3. テスト用のURLと本番のURLは別
n8nのWebhookには、画面で試すためのテスト用のURL(/webhook-test/…)と、有効にしたときに使う本番のURL(/webhook/…)があります。テスト用のURLは、画面の「Execute workflow」を押した直後の1回だけ受け付けます。外部のサービスやフォームには、本番のURLを設定してください。
合言葉の扱い方
- 長くてランダムな文字列にする:パスワード管理ツールの生成機能などで、20文字以上の文字列を作る
- URLに入れない:URLのクエリ(
?token=…)に入れると、ログや履歴に残りやすい。ヘッダーで送る - 漏れたら作り直す:n8nの認証情報の値を変え、送る側の設定も変える
- HTTPSで公開する:暗号化されていない通信では、ヘッダーの合言葉も読み取られるおそれがある
設定の手順
- 合言葉つきのWebhookのテンプレート(webhook-header-auth.json)をダウンロードして、n8nに読み込む
- n8nの「Credentials」で「Header Auth」を新しく作り、Nameに
X-Webhook-Token、Valueに合言葉を入れる - テンプレートの「問い合わせを受け取る」を開き、Credentialに2を選ぶ
- ワークフローを有効にする(右上の「Publish」)。数秒待ってから試す
- 合言葉なしでは403、正しい合言葉では200が返ることを確かめる
Googleフォームの回答をWebhookで受け取る場合は、送る側(Apps Script)でヘッダーを付けて送ります。仕組みはGoogleフォームの回答を自動で通知する手順で紹介しています。ワークフローが失敗したときに気づけるよう、n8nのエラー通知もあわせて設定しておくと安心です。
n8nを動かすサーバー
Webhookで外部からデータを受け取るには、n8nをHTTPSで公開しておく必要があります。自分のサーバーで動かすなら、n8nのアプリイメージが用意されているXServer VPS
などのVPSが使えます。公開の手順と費用はn8nをVPSで動かす手順と費用にまとめています。
この記事で紹介したサービス
公式サイトで、最新の条件を確認してから申し込んでください。PR
- XServer VPSの公式サイト

エックスサーバー株式会社のVPS。n8nなどを自分のサーバーで動かすときに使えます
この記事について
- 編集
- 役立ち情報館 編集部
- 公開前の確認
- 編集責任者(2026年11月16日)
編集部が実際に操作して確かめた結果と、公式情報をもとに作成し、出典と確認日を記事の末尾に載せています。調査や下書きにはAIのツールも活用しています。体験談や口コミは掲載していません。誤りを見つけた場合は訂正し、記事の末尾に履歴を残します。編集方針
この記事の検証記録
- 方法
- 実際に操作して検証
- 検証日
- 2026年11月16日
- 環境
- n8n 2.47.7 セルフホスト版(ローカル)。Webhookノード(v2)のHeader Auth、curlでの呼び出し
- 範囲
- ヘッダー認証つきのWebhookを有効にし、合言葉なし・違う合言葉・正しい合言葉の3通りで呼び出して、応答と実行の記録を確認。インターネットに公開した環境での動作と、Basic認証・JWT認証は試していない
参考資料・出典
- n8n公式ドキュメント:Webhook node (2026年11月16日 確認)
次に読む
n8nのワークフローが止まったらSlackに知らせる:エラー通知の設定と、試して分かった2つの落とし穴【テンプレート付き】 n8nの自動化が止まっても、気づかなければ請求書や通知が漏れたままになります。エラーが起きたらSlackに知らせる「エラーワークフロー」を実際に作って動かし、公式ドキュメントに書かれていない注意点と、そのまま使えるテンプレートをまとめました。