UiPath Documentation
integration-service
2.2510
true

Integration Service ユーザー ガイド

最終更新日時 2026年4月24日

HTTP Webhook 認証

前提条件​

Webhook プロバイダーによっては、ハンドシェイクが必要な場合があります。チャレンジ検証の設定方法の詳細については、「 Webhook チャレンジ検証 」セクションを参照してください。

トリガーを作成した場所に応じて、生成された Webhook URL は [HTTP Webhook トリガー] アクティビティまたはトリガーの作成ページに表示されますが、これはコネクションが正常に作成された後にのみです。失敗を避けるため、ワークフローのパブリッシュ後、または UiPath Orchestrator でトリガーが正常に作成された 後に 、アプリケーションに Webhook URL を貼り付けます。

HTTP Webhook 接続を作成する​

  1. 左側のレールから [Integration Service] を選択します。
  2. [ コネクタ] のリストから [ HTTP Webhook] を選択します。検索バーを使用してコネクタを検索することもできます。
  3. [ HTTP Webhook に接続] を選択します。
  4. [ この Webhook はどのアプリケーションですか ] フィールドに、Webhook アプリケーションのわかりやすい名前を入力します。これにより、このコネクションがどのベンダーまたは連携に属しているかを簡単に識別できます。この値が 接続識別子になります。
  5. チャレンジの場所を設定する
    UiPath が正しく対応できるよう、ベンダーがチャレンジ トークンを送信する方法を選択します。
    • チャレンジなし - ベンダーはハンドシェイクを必要とせず、接続に進むことができます。
    • クエリ パラメーター (例: ?challenge=...)
    • JSON 本文 (POST と { "challenge": "..." })
    • ヘッダー (例: X-Hub-Challenge)
  6. 本人確認検証の設定と接続
    ベンダーがハンドシェイクを必要とする場合は、ベンダーのパターン(読み取るフィールド/ヘッダー/クエリーと、それをエコー/検証する方法)に一致する チャレンジ検証 を入力します。設定が完了したら、[ 接続] をクリックします。
ヒント:
  • 混乱を避けるため、ベンダーと環境を含む名前 (Stripe-prod や Slack-staging など) を使用してください。
  • ベンダーが使用しているチャレンジ パターンがわからない場合は、ベンダーの Webhook ドキュメントを確認するか、テスト登録を実行してハンドシェイク リクエストを検査します。

Webhook チャレンジの検証​

一部のベンダーは、実際のイベントの送信を開始する前に、Webhook URL の検証を要求しています。これは、チャレンジ レスポンス メカニズムを使用して行われます。Webhook を登録すると、ベンダーは特別なチャレンジ要求を送信し、エンドポイントは期待どおりに正確に応答する必要があります。

HTTP Webhook コネクタは、 Webhook チャレンジ フレームワークを介してこれらの検証フローをサポートしており、UiPath がベンダーのチャレンジをどのように読み取って対応するかを設定できます。

チャレンジ検証のサポート​

UiPath では、ベンダー Webhook の両方の種類の動作がサポートされています。

  • チャレンジ検証を使用していないベンダー
  • Webhook をアクティブ化する前にチャレンジ ハンドシェイクを必要とするベンダー

これにより、単純な Webhook プロバイダーだけでなく、より高度なセキュリティ要件を持つプロバイダーにも対応できます。

ベンダーがチャレンジ検証​を使用しない場合

多くのアプリケーションは、Webhook URL を受け入れるだけで、すぐにイベントの配信を開始します。
これらのベンダーの場合:

  • ユーザーは 、コネクションを作成または選択するだけです。
  • Webhook URL をコピーします。
  • これをベンダーの Webhook 設定に貼り付けます。

追加の手順は不要です。Webhook は、ベンダーがイベントの送信を開始するとすぐにアクティブになります。

これは最も一般的でシンプルなシナリオであり、UiPath はシームレスに処理します。

ベンダー が チャレンジ検証を要求する場合​

一部のベンダーは、Webhook URL を有効化する前に、その URL を検証するための チャレンジ リクエスト を送信します。
これらのケースでは、次のようになります。

  • ユーザーは、HTTP Webhook 接続で チャレンジ応答を設定する必要があります 。
  • UiPath はベンダーのチャレンジ要求をリッスンします。
  • UiPath は、設定に基づいて正しいチャレンジ値を自動的に返します。
  • ベンダーが応答を検証すると、通常のイベントが流れ始めます。

チャレンジの送信方法 (クエリ パラメーター、JSON 本文、ヘッダーなど) はベンダーによって異なるため、UiPath の設定ではこれらのパターンをすべて処理できます。

これにより、Slack、Meta (Facebook/Instagram)、Stripe など、セキュリティ ハンドシェイクを適用する Webhook プロバイダーとの相互運用性が確保されます。

チャレンジ検証の設定​

チャレンジ動作は、次の 4 つのパラメーターを使用して設定します。

  • チャレンジ キー
    チャレンジ値を含むフィールド/キー。チャレンジ要求を検出するために使用します (null にすることはできません)。

  • チャレンジの場所
    キーが表示される場所:

    • 本文
    • クエリ パラメーター
    • ヘッダー

  • チャレンジ応答コンテンツの種類
    ベンダーに返される応答の形式:

    • テキスト/プレーン
    • application/json

  • チャレンジ応答の形式
    返される値を定義します (通常はチャレンジ キー自体)。
    UiPath は、受信したチャレンジから値を抽出し、それに応じて回答します。

チャレンジの設定例​

一般的な例​

受信要求

 {
  "challenge": "ABC123"
 }
 {
  "challenge": "ABC123"
 }

構成

  • チャレンジキー: challenge != null
  • チャレンジ場所:ボディ
  • 応答の種類: text/plain
  • 応答の形式: challenge

レスポンス

ABC123

WhatsAppチャレンジ検証の例​

WhatsApp は、 hub.challenge でクエリパラメータベースのチャレンジメソッドを使用します。

構成

パラメーター値 (Value)
チャレンジ キーhub.challenge != null
チャレンジの場所クエリ パラメーター
チャレンジ応答コンテンツの種類text/plain
チャレンジ応答の形式hub.challenge

仕入先要求

GET https://your-webhook-url?hub.challenge=1234567890

UiPath の期待される回答

HTTP/1.1 200 OK
Content-Type: text/plain

1234567890
HTTP/1.1 200 OK
Content-Type: text/plain

1234567890

これにより所有権が確認され、WhatsAppはその後、実際のWebhookイベントの送信を開始します。

docs image

概要—ジェネリックとWhatsApp​
手順一般的な例WhatsAppの例
チャレンジの場所本文/クエリ/ヘッダークエリ
キーフォーマット単純キー (例: challenge)ドット付きのキー ("hub.challenge")
応答の種類text/plain または application/jsonテキスト/プレーン
応答値キーの値値 "hub.challenge"
メソッドPOST または GETGET のみ

ベンダー パターン別の例​

例1:テキスト応答を伴う単純なボディチャレンジ​

ベンダーは以下を送信します。

{"challenge":"abc123","type":"url_verification"}

フィールド値 (Value)
チャレンジの場所Body
チャレンジ キーchallenge
チャレンジ応答のコンテンツの種類text
チャレンジの応答形式challenge

応答: abc123 (テキスト/プレーン、200)

例 2: テキスト応答によるクエリ パラメーター チャレンジ​

ベンダーは以下を送信します。

GET /webhook?challenge=CHALLENGE_STRING

フィールド値 (Value)
チャレンジの場所Query Parameter
チャレンジ キーchallenge
チャレンジ応答のコンテンツの種類text
チャレンジの応答形式challenge

応答: CHALLENGE_STRING (テキスト/プレーン、200)

例 3: JSON 応答を使用したボディ チャレンジ​

ベンダーは以下を送信します。

{"challenge":"abc123"}

フィールド値 (Value)
チャレンジの場所Body
チャレンジ キーchallenge
チャレンジ応答のコンテンツの種類json
チャレンジの応答形式{ "challenge": "challenge" }

応答: {"challenge":"abc123"} (application/json, 200)

例 4: テキスト応答の​を含む入れ子になった本文パス (例: verification.token

ベンダーは以下を送信します。

{"verification":{"token":"abc123"}}

フィールド値 (Value)
チャレンジの場所Body
チャレンジ キーverification.token
チャレンジ応答のコンテンツの種類text
チャレンジの応答形式verification.token

応答: abc123 (テキスト/プレーン、200)

例 5: JSON 応答を含む深く入れ子になったパス​

ベンダーは以下を送信します。

{"event":{"challenge":"abc123","type":"verify"}}

フィールド値 (Value)
チャレンジの場所Body
チャレンジ キーevent.challenge
チャレンジ応答のコンテンツの種類json
チャレンジの応答形式{ "result": "event.challenge" }

応答: {"result":"abc123"} (application/json, 200)

例 6: テキスト応答を含むヘッダーベースのチャレンジ (ハイフンでつながれたヘッダー名)​

ベンダーは以下を送信します。

POST /webhook x-webhook-challenge: abc123

フィールド値 (Value)
チャレンジの場所Header
チャレンジ キー"x-webhook-challenge"
チャレンジ応答のコンテンツの種類text
チャレンジの応答形式"x-webhook-challenge"

応答: abc123 (テキスト/プレーン、200)

注:

ヘッダー名にはハイフンが含まれています。これは、解析コンテキストで演算子と誤解される可能性があります。識別子を二重引用符で囲むと (例: "x-webhook-challenge") リテラルキー名として扱われます。ハイフン、ドット、その他の特殊文字を含む識別子は、必ず二重引用符で囲んでください。

例 7: 異なる応答キーによるブール値検出​

ベンダーは以下を送信します。

{"type":"url_verification","challenge":"abc","token":"legacytoken"}

typeフィールドで検出したいが、challenge値で応答したい。

フィールド値 (Value)
チャレンジの場所body
チャレンジ キーtype == url_verification」
チャレンジ応答のコンテンツの種類json
チャレンジの応答形式{ "challenge": "challenge" }

応答: {"challenge":"abc"} (application/json, 200)

このページは役に立ちましたか?

接続

ヘルプ リソース サポート

学習する UiPath アカデミー

質問する UiPath フォーラム

最新情報を取得