Azure Logic Apps で HTTP Webhook を使用してイベントがワークフローを実行するのをサブスクライブして待機する

適用対象: Azure Logic Apps (従量課金 + Standard)

そのエンドポイントを呼び出すサービス エンドポイントまたはアクションを定期的にチェックまたは "ポーリング" するトリガーを使用するのではなく、サービス エンドポイントにサブスクライブし、特定のイベントを待機して、ワークフローで特定のアクションを実行する HTTP Webhook トリガーまたはアクションを使用できます。

Webhook ベースのワークフローの例を次に示します。

• Azure Event Hubs からイベントが到着するのを待機してからワークフローの実行をトリガーする。
• 承認を待ってからワークフローを続行する。

このガイドでは、 HTTP Webhook トリガーと HTTP Webhook アクションを使用して、ワークフローがサービス エンドポイントでイベントを受信して応答できるようにする方法について説明します。

Webhook のしくみ

Webhook トリガーは、イベントに基づいており、新しいデータやイベントの定期的な確認 (ポーリング) に依存しません。 Webhook トリガーを空のワークフローに追加してからワークフローを保存した後、または無効にしたロジック アプリ リソースを再度有効にした後、Webhook トリガーは、そのエンドポイントにコールバック URL を登録することによって、指定されたサービス エンドポイントにサブスクライブします。 その後、このトリガーは、そのサービス エンドポイントが URL を呼び出すまで待機し、呼び出しが発生するとワークフローの開始がトリガーされます。 要求トリガーと同様に、webhook トリガーはすぐに起動します。

次のアクションを手動で実行しない限り、Webhook トリガーもサービス エンドポイントにサブスクライブされたままです。

• トリガーのパラメーター値を変更します。
• トリガーを削除し、ワークフローを保存します。
• ロジック アプリ リソースを無効にします。

webhook トリガーと同様に、webhook アクションもイベント ベースです。 Webhook アクションを既存のワークフローに追加してからワークフローを保存した後、または無効にしたロジック アプリ リソースを再度有効にした後、Webhook アクションは、そのエンドポイントにコールバック URL を登録することによって、指定されたサービス エンドポイントにサブスクライブします。 ワークフローが実行されると、Webhook アクションがワークフローを一時停止し、サービス エンドポイントが URL を呼び出すまで待機した後、ワークフローの実行が再開されます。 Webhook アクションは、次の条件が発生すると、サービス エンドポイントからサブスクライブ解除します。

• Webhook アクションが正常に終了した。
• 応答を待機しているときにワークフローの実行がキャンセルされた。
• ワークフロー実行がタイムアウトする前。
• Webhook トリガーによって入力として使用される Webhook アクション パラメーター値を変更します。

たとえば、Office 365 Outlook コネクタの [承認メールの送信] アクションは、このパターンに従う Webhook アクションの例です。 Webhook アクションを使用することで、このパターンをあらゆるサービスに適用できます。

詳しくは、次のドキュメントをご覧ください。

• Webhook とサブスクリプション
• Webhook をサポートするカスタム API を作成する

トランスポート層セキュリティ (TLS) や Microsoft Entra ID オープン認証など、ロジック アプリへの受信呼び出しの暗号化、セキュリティ、承認の詳細については、「要求ベースのトリガーへの受信呼び出しのアクセス」を参照してください。

コネクタに関するテクニカル リファレンス

トリガーとアクションのパラメーターの詳細については、HTTP Webhook のパラメーターに関するページを参照してください。

前提条件

• Azure アカウントとサブスクリプション。 Azure サブスクリプションがない場合は、無料の Azure アカウントにサインアップしてください。

• 必要に応じて、ワークフロー内の Webhook トリガーまたはワークフロー内の Webhook アクションのためのサブスクライブおよび解除パターンをサポートする、既にデプロイされているエンドポイントまたはAPIのURL。

• ターゲット エンドポイントで特定のイベントを待機する Standard または従量課金ロジック アプリ ワークフロー。

  HTTP Webhook トリガーから開始するには、空のワークフローを含むロジック アプリを作成します。

  HTTP Webhook アクションを使用するには、任意のトリガーでワークフローを開始します。 この例では、最初の手順として HTTP トリガーを使用します。

HTTP Webhook トリガーの追加

この組み込みトリガーは、ターゲット サービスでサブスクライブ エンドポイントを呼び出し、そのコールバック URL をターゲット サービスに登録します。 その後、ワークフローは、ターゲット サービスがコールバック URL に HTTP POST 要求を送信するのを待ちます。 このイベントが発生すると、トリガーが起動され、要求内のすべてのデータがワークフローに渡されます。

ワークフローを保存すると、ターゲット サービスでサブスクライブ エンドポイントが呼び出され、コールバック URL が登録されます。 その後、ワークフローは、ターゲット サービスがコールバック URL に HTTP POST 要求を送信するのを待ちます。 このイベントが発生すると、トリガーが起動され、要求内のすべてのデータがワークフローに渡されます。 この操作が正常に完了すると、トリガーはエンドポイントからサブスクライブ解除され、ワークフローでは次のアクションが続行されます。

HTTP Webhook アクションの追加

この組み込みアクションは、ターゲット サービスでサブスクライブ エンドポイントを呼び出し、そのコールバック URL をターゲット サービスに登録します。 その後、ワークフローは一時停止し、ターゲット サービスがコールバック URL に HTTP POST 要求を送信するのを待ちます。 このイベントが発生すると、アクションは要求内のすべてのデータをワークフローに渡します。 操作が正常に完了すると、アクションはエンドポイントからサブスクライブ解除され、ワークフローでは次のアクションが続行されます。

このアクションが実行されると、ワークフローはターゲット サービスでサブスクライブ エンドポイントを呼び出し、コールバック URL を登録します。 その後、ワークフローは一時停止し、ターゲット サービスがコールバック URL に HTTP POST 要求を送信するのを待ちます。 このイベントが発生すると、アクションは要求内のすべてのデータをワークフローに渡します。 操作が正常に完了すると、アクションはエンドポイントからサブスクライブ解除され、ワークフローでは次のアクションが続行されます。

トリガーとアクションの出力

HTTP Webhook トリガーまたはアクションからの出力の詳細については、次の情報を返します。

セカンダリ アクセス キーを使用してコールバック URL を生成する

ロジック アプリ ワークフローには、プライマリとセカンダリの 2 つのアクセス キーがあります。 既定では、Azure Logic Apps は主キーを使用して HTTP webhook トリガーのコールバック URL を生成します。

代わりに、コールバック URL の生成にセカンダリ キーを使用するには、次の手順に従います。

1. ワークフロー デザイナーから、コード ビューに切り替えます。

2. HttpWebhook トリガー定義で、accessKeyType パラメーターを見つけます。

3. パラメーター値として単語 Secondary を指定します。

4. 忘れずに変更を保存してください。

次の例は、 accessKeyType パラメーターを Secondary に設定した webhook トリガー定義を示しています。

{
  "type": "HttpWebhook",
  "inputs": {
    "subscribe": {
      "method": "POST",
      "uri": "<subscription-URL>",
      "body": "@listCallbackUrl()"
    },
    "accessKeyType": "Secondary"
  },
  "runAfter": {}
}

関連コンテンツ

• 要求ベースのトリガーへの受信呼び出しへのアクセス
• すべての Logic Apps コネクタの一覧
• Azure Logic Apps の組み込みコネクタ