Azure Logic Apps에서 HTTP 웹 후크를 사용 하 여 이벤트 기반 작업 및 워크플로 자동화Automate event-based tasks and workflows by using HTTP webhooks in Azure Logic Apps

사용 하 여 Azure Logic Apps 및 기본 제공 HTTP 웹 후크 커넥터를 기다린 후 논리 앱을 작성 하 여 HTTP 또는 HTTPS 끝점에서 발생 하는 특정 이벤트에 따라 실행 하는 워크플로 자동화할 수 있습니다.With Azure Logic Apps and the built-in HTTP Webhook connector, you can automate workflows that wait and run based on specific events that happen at an HTTP or HTTPS endpoint by building logic apps. 예를 들어, 워크플로 트리거하 및 지정 된 작업을 실행 하지 않고 정기적으로 검사 하기 전에 특정 이벤트를 대기 하 여 서비스 끝점을 모니터링 하는 논리 앱을 만들 수 있습니다 또는 폴링 끝점입니다.For example, you can create a logic app that monitors a service endpoint by waiting for a specific event before triggering the workflow and running the specified actions, rather than regularly checking or polling that endpoint.

일부 예제에서는 이벤트 기반 워크플로 다음과 같습니다.Here are some example event-based workflows:

  • 항목에서 도착을 대기는 Azure Event Hub 논리 앱 실행을 트리거하기 전에 합니다.Wait for an item to arrive from an Azure Event Hub before triggering a logic app run.
  • 워크플로 계속 하기 전에 승인을 대기 합니다.Wait for an approval before continuing a workflow.

웹 후크는 어떻게 작동 하나요?How do webhooks work?

HTTP 웹 후크 트리거는 이벤트 기반, 검사 또는 정기적으로 새 항목에 대 한 폴링에 종속 되지 않습니다는입니다.An HTTP webhook trigger is event-based, which doesn't depend on checking or polling regularly for new items. 시작 하는 웹 후크 트리거를 통해 또는 웹 후크 트리거 사용 안 함 상태에서 논리 앱을 변경 하면 논리 앱을 저장할 때 구독 특정 서비스에 등록 하 여 끝점을 콜백URL 해당 서비스 또는 끝점을 사용 하 여 합니다.When you save a logic app that starts with a webhook trigger, or when you change your logic app from disabled to enabled, the webhook trigger subscribes to a specific service or endpoint by registering a callback URL with that service or endpoint. 그런 다음 트리거는 서비스 또는 논리 앱 실행을 시작 하는 URL을 호출 하는 끝점을 기다립니다.The trigger then waits for that service or endpoint to call the URL, which starts running the logic app. 비슷합니다는 요청 트리거, 지정된 된 이벤트가 발생할 때 즉시 논리 앱에서 발생 합니다.Similar to the Request trigger, the logic app fires immediately when the specified event happens. 트리거가 구독 취소 서비스 또는 끝점에서 트리거를 제거 하 고 논리 앱을 저장 하는 경우 또는에서 논리 앱을 변경 하면 설정 사용 안 함으로 설정 합니다.The trigger unsubscribes from the service or endpoint if you remove the trigger and save your logic app, or when you change your logic app from enabled to disabled.

HTTP 웹 후크 동작 이기도 이벤트 기반 및 구독 특정 서비스 또는 등록 하 여 끝점에는 콜백 URL 해당 서비스 또는 끝점을 사용 하 여 합니다.An HTTP webhook action is also event-based and subscribes to a specific service or endpoint by registering a callback URL with that service or endpoint. 웹 후크 동작을 논리 앱 워크플로 일시 중지 하 고 호출 실행 논리 앱 다시 시작 하기 전에 URL를 서비스 또는 끝점 때까지 대기 합니다.The webhook action pauses the logic app's workflow and waits until the service or endpoint calls the URL before the logic app resumes running. 작업 논리 앱 구독 취소 서비스 또는 이러한 경우에는 끝점에서:The action logic app unsubscribes from the service or endpoint in these cases:

  • 웹 후크 동작을 성공적으로 완료 되 면When the webhook action successfully finishes
  • 논리 앱 실행 응답을 기다리는 동안 취소 되 면If the logic app run is canceled while waiting for a response
  • 앱 제한 논리 전에Before the logic app times out

예를 들어 Office 365 Outlook 커넥터의 승인 전자 메일 보내기 작업은이 패턴을 따르는 웹 후크 동작의 예입니다.For example, the Office 365 Outlook connector's Send approval email action is an example of webhook action that follows this pattern. 웹 후크 동작을 사용 하 여 모든 서비스에이 패턴을 확장할 수 있습니다.You can extend this pattern into any service by using the webhook action.

자세한 내용은 다음 항목을 참조하세요.For more information, see these topics:

필수 조건Prerequisites

HTTP 웹 후크 트리거를 추가 합니다.Add an HTTP Webhook trigger

이 기본 제공 트리거 콜백 URL을 지정된 된 서비스를 사용 하 여 등록 하 고 해당 서비스가 해당 URL에 HTTP POST 요청을 보낼 때까지 대기 합니다.This built-in trigger registers a callback URL with the specified service and waits for that service to send an HTTP POST request to that URL. 이 이벤트가 발생 하면 트리거가 발생 하 고 즉시 논리 앱을 실행 합니다.When this event happens, the trigger fires and immediately runs the logic app.

  1. Azure Portal에 로그인합니다.Sign in to the Azure portal. 논리 앱 디자이너에서 빈 논리 앱을 엽니다.Open your blank logic app in Logic App Designer.

  2. 디자이너에서 검색 상자에서 필터로 "http 웹 후크"를 입력 합니다.On the designer, in the search box, enter "http webhook" as your filter. 트리거 목록에서 선택 합니다 HTTP 웹 후크 트리거.From the Triggers list, select the HTTP Webhook trigger.

    HTTP 웹 후크 트리거를 선택 합니다.

    이 예의 단계 보다 설명적인 이름을 갖도록 "HTTP 웹 후크 트리거" 트리거를 이름을 바꿉니다.This example renames the trigger to "HTTP Webhook trigger" so that the step has a more descriptive name. 또한 HTTP 웹 후크 작업을 나중에 추가 하는 예제 및 이름이 모두 고유 해야 합니다.Also, the example later adds an HTTP Webhook action, and both names must be unique.

  3. 에 대 한 값을 제공 합니다 HTTP 웹 후크 트리거 매개 변수 구독에 대 한 사용 및 구독 취소 호출, 예를 들어 하려는:Provide the values for the HTTP Webhook trigger parameters that you want to use for the subscribe and unsubscribe calls, for example:

    HTTP 웹 후크 트리거 매개 변수를 입력 합니다.

  4. 다른 사용 가능한 매개 변수를 추가 하려면 열을 새 매개 변수 추가 목록 및 매개 변수를 선택 합니다.To add other available parameters, open the Add new parameter list, and select the parameters that you want.

    HTTP Webhook에 대 한 인증 유형 사용할 수 있는 방법에 대 한 자세한 내용은 참조 인증 HTTP 트리거 및 작업합니다.For more information about authentication types available for HTTP Webhook, see Authenticate HTTP triggers and actions.

  5. 트리거가 발생할 때 실행되는 작업을 사용하여 논리 앱의 워크플로를 계속해서 작성합니다.Continue building your logic app's workflow with actions that run when the trigger fires.

  6. 완료 하면 논리 앱을 저장 해야 하는 완료 합니다.When you're finished, done, remember to save your logic app. 디자이너 도구 모음에서 선택 저장할합니다.On the designer toolbar, select Save.

    논리 앱 저장 구독 끝점을 호출 하 고이 논리 앱을 트리거하는 콜백 URL을 등록 합니다.Saving your logic app calls the subscribe endpoint and registers the callback URL for triggering this logic app.

  7. 대상 서비스가 보내는 때마다 이제는 HTTP POST 콜백 URL을 논리 앱 실행에 대 한 요청 및 요청을 통해 전달 되는 모든 데이터를 포함 합니다.Now, whenever the target service sends an HTTP POST request to the callback URL, the logic app fires, and includes any data that is passed through the request.

HTTP 웹 후크 작업 추가Add an HTTP Webhook action

이 기본 제공 작업 콜백 URL을 지정된 된 서비스를 사용 하 여 등록 하 고 논리 앱 워크플로 일시 중지 및 해당 서비스가 해당 URL에 HTTP POST 요청을 보낼 때까지 대기 합니다.This built-in action registers a callback URL with the specified service, pauses the logic app's workflow, and waits for that service to send an HTTP POST request to that URL. 이 이벤트가 발생 하면 작업을 논리 앱 실행 다시 시작 합니다.When this event happens, the action resumes running the logic app.

  1. Azure Portal에 로그인합니다.Sign in to the Azure portal. Logic Apps 디자이너에서 논리 앱을 엽니다.Open your logic app in Logic App Designer.

    이 예제에서는 첫 번째 단계로 HTTP 웹 후크 트리거를 사용 합니다.This example uses the HTTP Webhook trigger as the first step.

  2. HTTP 웹 후크 동작을 추가 하려는 단계를 아래에서 선택 새 단계합니다.Under the step where you want to add the HTTP Webhook action, select New step.

    단계 사이에서 작업을 추가하려면 단계 사이에 있는 화살표 위로 포인터를 이동합니다.To add an action between steps, move your pointer over the arrow between steps. 더하기 기호 ( + ) 표시 하 고 선택한 작업 추가합니다.Select the plus sign (+) that appears, and then select Add an action.

  3. 디자이너에서 검색 상자에서 필터로 "http 웹 후크"를 입력 합니다.On the designer, in the search box, enter "http webhook" as your filter. 작업 목록에서 선택 합니다 HTTP 웹 후크 작업 합니다.From the Actions list, select the HTTP Webhook action.

    HTTP 웹 후크 작업 선택

    이 예제에서는 단계 보다 설명적인 이름을 갖도록를 "HTTP 웹 후크 작업" 작업을 이름을 바꿉니다.This example renames the action to "HTTP Webhook action" so that the step has a more descriptive name.

  4. 작업 매개 변수는 유사한 HTTP Webhook에 대 한 값을 제공 합니다 HTTP 웹 후크 트리거 매개 변수 구독에 대 한 사용 및 구독 취소 호출, 예를 들어 하려는:Provide the values for the HTTP Webhook action parameters, which are similar to the HTTP Webhook trigger parameters that you want to use for the subscribe and unsubscribe calls, for example:

    HTTP 웹 후크 작업 매개 변수를 입력 합니다.

    런타임 중 논리 앱이이 작업을 실행 하는 경우 구독 끝점을 호출 합니다.During runtime, the logic app calls the subscribe endpoint when running this action. 논리 앱에서 다음 워크플로 일시 중지 하 고 보낼 대상 서비스에 대 한 대기를 HTTP POST 콜백 URL로 요청 합니다.Your logic app then pauses the workflow and waits for the target service to send an HTTP POST request to the callback URL. 작업은 완료 하 고 끝점에서 구독 취소 작업을 논리 앱을 다시 시작 하는 경우 워크플로 실행 합니다.If the action completes successfully, the action unsubscribes from the endpoint, and your logic app resumes running the workflow.

  5. 다른 사용 가능한 매개 변수를 추가 하려면 열을 새 매개 변수 추가 목록 및 매개 변수를 선택 합니다.To add other available parameters, open the Add new parameter list, and select the parameters that you want.

    HTTP Webhook에 대 한 인증 유형 사용할 수 있는 방법에 대 한 자세한 내용은 참조 인증 HTTP 트리거 및 작업합니다.For more information about authentication types available for HTTP Webhook, see Authenticate HTTP triggers and actions.

  6. 완료 하면 논리 앱을 저장 해야 합니다.When you're finished, remember to save your logic app. 디자이너 도구 모음에서 선택 저장할합니다.On the designer toolbar, select Save.

커넥터 참조Connector reference

서로 비슷합니다는 트리거 및 작업 매개 변수에 대 한 자세한 내용은 참조 HTTP 웹 후크 매개 변수합니다.For more information about trigger and action parameters, which are similar to each other, see HTTP Webhook parameters.

출력 세부 정보Output details

HTTP 웹 후크 트리거 또는이 정보를 반환 하는 작업에서 출력에 대 한 자세한 정보는 다음과 같습니다.Here is more information about the outputs from an HTTP Webhook trigger or action, which returns this information:

속성 이름Property name 형식Type 설명Description
headersheaders objectobject 요청에서 헤더The headers from the request
bodybody objectobject JSON 개체JSON object 요청 본문 내용 사용 하 여 개체The object with the body content from the request
status codestatus code intint 요청에서 상태 코드The status code from the request
status codeStatus code 설명Description
200200 확인OK
202202 동의함Accepted
400400 잘못된 요청Bad request
401401 권한 없음Unauthorized
403403 사용할 수 없음Forbidden
404404 찾을 수 없음Not Found
500500 내부 서버 오류.Internal server error. 알 수 없는 오류 발생.Unknown error occurred.

다음 단계Next steps