AUTOMATION ・ 実機で検証

n8nのWebhookに合言葉をかける:誰でも呼び出せる状態を防ぐ設定と、試して分かったこと【テンプレート付き】

n8nのWebhookのURLは、知られると誰でも呼び出せます。ヘッダーに合言葉(トークン)を付けた呼び出しだけを受け付ける設定を、実際に作って試しました。合言葉がない・違う呼び出しは403で拒否され、実行の記録にも残らないことなど、分かったことをまとめています。

公開 2026年11月16日 約4分で読めます 役立ち情報館 編集部

PRこの記事にはアフィリエイト広告を含みます。広告についての方針

実際に操作して検証(2026年11月16日) ・検証の詳細

目次

n8nのWebhookは、外部からデータを受け取るための入口です。フォームの送信や、ほかのサービスからの通知を受け取るのに便利ですが、URLを知っている人なら誰でも呼び出せる状態のままだと、いたずらの送信で通知が大量に届いたり、意図しない処理が動いたりするおそれがあります。

n8nのWebhookには、呼び出しに認証をかける設定があります。今回は、ヘッダーに**合言葉(トークン)**を付けた呼び出しだけを受け付ける「Header Auth」を、編集部のローカル環境(n8n 2.47.7)で実際に設定して試しました。

仕組み

  1. n8nに「Header Auth」の認証情報を作る。ヘッダーの名前(例:X-Webhook-Token)と、合言葉(長いランダムな文字列)を決める
  2. Webhookノードの「Authentication」で「Header Auth」を選び、1の認証情報を指定する
  3. データを送る側は、毎回その名前のヘッダーに合言葉を付けて送る

合言葉が一致しない呼び出しは、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で公開する:暗号化されていない通信では、ヘッダーの合言葉も読み取られるおそれがある

設定の手順

  1. 合言葉つきのWebhookのテンプレート(webhook-header-auth.json)をダウンロードして、n8nに読み込む
  2. n8nの「Credentials」で「Header Auth」を新しく作り、Nameに X-Webhook-Token、Valueに合言葉を入れる
  3. テンプレートの「問い合わせを受け取る」を開き、Credentialに2を選ぶ
  4. ワークフローを有効にする(右上の「Publish」)。数秒待ってから試す
  5. 合言葉なしでは403、正しい合言葉では200が返ることを確かめる

Googleフォームの回答をWebhookで受け取る場合は、送る側(Apps Script)でヘッダーを付けて送ります。仕組みはGoogleフォームの回答を自動で通知する手順で紹介しています。ワークフローが失敗したときに気づけるよう、n8nのエラー通知もあわせて設定しておくと安心です。

n8nを動かすサーバー

Webhookで外部からデータを受け取るには、n8nをHTTPSで公開しておく必要があります。自分のサーバーで動かすなら、n8nのアプリイメージが用意されているXServer VPSなどのVPSが使えます。公開の手順と費用はn8nをVPSで動かす手順と費用にまとめています。

この記事で紹介したサービス

公式サイトで、最新の条件を確認してから申し込んでください。PR

この記事について

編集
役立ち情報館 編集部
公開前の確認
編集責任者(2026年11月16日)

編集部が実際に操作して確かめた結果と、公式情報をもとに作成し、出典と確認日を記事の末尾に載せています。調査や下書きにはAIのツールも活用しています。体験談や口コミは掲載していません。誤りを見つけた場合は訂正し、記事の末尾に履歴を残します。編集方針

この記事の検証記録
方法
実際に操作して検証
検証日
2026年11月16日
環境
n8n 2.47.7 セルフホスト版(ローカル)。Webhookノード(v2)のHeader Auth、curlでの呼び出し
範囲
ヘッダー認証つきのWebhookを有効にし、合言葉なし・違う合言葉・正しい合言葉の3通りで呼び出して、応答と実行の記録を確認。インターネットに公開した環境での動作と、Basic認証・JWT認証は試していない

参考資料・出典

次に読む

業務自動化 YAKUDACHI JOHO KAN 01 ワークフロー 02 失敗を検知 03 内容を整形 04 Slackに通知 n8nのワークフローが止まったらSlackに知らせる:エラー通知の設定と、試して分かった2つの落とし穴【テンプレート付き】 n8nの自動化が止まっても、気づかなければ請求書や通知が漏れたままになります。エラーが起きたらSlackに知らせる「エラーワークフロー」を実際に作って動かし、公式ドキュメントに書かれていない注意点と、そのまま使えるテンプレートをまとめました。

あわせて読みたい記事