Azure Logic Apps의 워크플로에 대한 인바운드 HTTPS 호출 수신 및 응답

아티클
02/23/2024

적용 대상: Azure Logic Apps(사용량 + 표준)

이 방법 가이드에서는 요청 기본 제공 트리거를 사용하여 다른 서비스에서 인바운드 HTTPS 요청 또는 호출을 수신하고 처리할 수 있는 논리 앱 워크플로를 만드는 방법을 보여 줍니다. 워크플로에서 이 트리거를 사용하면 응답 기본 제공 작업을 사용하여 HTTPS 요청에 응답할 수 있습니다.

참고 항목

응답 작업은 요청 트리거를 사용할 때만 작동합니다.

예를 들어, 다음 목록에서는 요청 트리거 및 응답 작업을 사용할 때 워크플로에서 수행할 수 있는 일부 작업을 설명합니다.

온-프레미스 데이터베이스에서 데이터에 대한 HTTPS 요청을 수신하고 응답합니다.
다른 논리 앱 워크플로에서 전송된 HTTPS 요청을 수신하고 응답합니다.
외부 웹후크 이벤트가 발생하는 경우 워크플로 실행을 트리거합니다.

대신 나가는 또는 아웃바운드 요청을 전송하여 워크플로를 실행하려면 HTTP 기본 제공 트리거 또는 HTTP 기본 제공 작업을 사용합니다.

필수 조건

Azure 계정 및 구독 구독이 없는 경우 Azure 체험 계정에 가입할 수 있습니다.
인바운드 HTTPS 요청을 수신하려는 논리 앱 워크플로. 요청 트리거를 사용하여 워크플로를 시작하려면 빈 워크플로로 시작해야 합니다. 응답 작업을 사용하려면 워크플로가 요청 트리거로 시작되어야 합니다.

요청 트리거 추가

요청 트리거는 HTTPS를 통한 인바운드 요청만 처리하는 수동으로 호출 가능한 엔드포인트를 만듭니다. 호출자가 이 엔드포인트에 요청을 보내면 요청 트리거가 실행되고 워크플로가 실행됩니다. 이 트리거를 호출하는 방법에 대한 자세한 내용은 Azure Logic Apps의 HTTPS 엔드포인트를 통해 워크플로 호출, 트리거 또는 중첩을 참조하세요.

소비
Standard

Azure Portal의 디자이너에서 사용량 논리 앱과 빈 워크플로를 엽니다.
디자이너에서 다음 일반 단계에 따라 HTTP 요청이 수신될 때라는 요청 기본 제공 트리거를 찾아서 추가합니다.

트리거 정보 상자가 나타나면 필요에 따라 다음 정보를 제공합니다.

Property name	JSON 속성 이름	Required	설명
HTTP POST URL	{없음}	예	워크플로를 저장한 후 생성되고 워크플로를 트리거하는 요청을 보내는 데 사용되는 엔드포인트 URL입니다.
요청 본문 JSON 스키마	`schema`	아니요	들어오는 요청 본문의 속성 및 값을 설명하는 JSON 스키마입니다. 디자이너는 이 스키마를 사용하여 요청에서 속성에 대한 토큰을 생성합니다. 이렇게 하면 워크플로가 요청 트리거의 출력을 구문 분석하고, 사용하고, 워크플로로 전달할 수 있습니다. JSON 스키마가 없을 경우 샘플 페이로드를 사용하여 스키마 생성 기능을 사용하여 샘플 페이로드에서 스키마를 생성할 수 있습니다.

다음 예제에서는 샘플 JSON 스키마를 보여 줍니다.

Screenshot showing Consumption workflow and Request trigger with example JSON schema.

다음 예제에서는 전체 샘플 JSON 스키마를 보여 줍니다.

{
   "type": "object",
   "properties": {
      "account": {
         "type": "object",
         "properties": {
            "name": {
               "type": "string"
            },
            "ID": {
               "type": "string"
            },
            "address": {
               "type": "object",
               "properties": {
                  "number": {
                     "type": "string"
                  },
                  "street": {
                     "type": "string"
                  },
                  "city": {
                     "type": "string"
                  },
                  "state": {
                     "type": "string"
                  },
                  "country": {
                     "type": "string"
                  },
                  "postalCode": {
                     "type": "string"
                  }
               }
            }
         }
      }
   }
}

JSON 스키마를 입력하면 요청에 Content-Type 헤더를 포함하고 해당 헤더 값을 application/json으로 설정하라는 미리 알림이 디자이너에 표시됩니다. 자세한 내용은 콘텐츠 유형 처리를 참조하세요.

Screenshot showing Consumption workflow, Request trigger, and reminder to include

다음 예제에서는 Content-Type 헤더가 JSON 형식으로 표시되는 방식을 보여 줍니다.

{
   "Content-Type": "application/json"
}

예상 페이로드(데이터)를 기반으로 하는 JSON 스키마를 생성하려면 JSONSchema.net과 같은 도구를 사용하거나 다음 단계를 수행합니다.

요청 트리거에서 샘플 페이로드를 사용하여 스키마 생성을 선택합니다.

샘플 페이로드를 입력하고 완료를 선택합니다.

Screenshot showing Consumption workflow, Request trigger, and sample payload entered to generate schema.

다음 예제에서는 샘플 페이로드를 보여 줍니다.

{
   "account": {
      "name": "Contoso",
      "ID": "12345",
      "address": {
         "number": "1234",
         "street": "Anywhere Street",
         "city": "AnyTown",
         "state": "AnyState",
         "country": "USA",
         "postalCode": "11111"
      }
   }
}

인바운드 호출에 특정 스키마와 일치하는 요청 본문이 있는지 확인하려면 다음 단계를 수행합니다.
1. 인바운드 메시지가 스키마에서 설명하는 것과 동일한 필드를 갖도록 하려면 스키마에서 required 속성을 추가하고 필수 필드를 지정합니다. addtionalProperties 속성을 추가하고 값을 false로 설정합니다.
  
  예를 들어 다음 스키마는 인바운드 메시지에 다른 필드가 아닌 msg 필드가 있어야 한다고 지정합니다.
```
{
   "properties": {
     "msg": {
        "type": "string"
     }
   },
   "type": "object",
   "required": ["msg"],
   "additionalProperties": false
}
```
2. 요청 트리거의 제목 표시줄에서 줄임표 단추(...)를 선택합니다.
3. 트리거의 설정에서 스키마 유효성 검사를 켜고 완료를 선택합니다.
  
  인바운드 호출의 요청 본문이 스키마와 일치하지 않는 경우 트리거가 HTTP 400 잘못된 요청 오류를 반환합니다.

트리거에 다른 속성 또는 매개 변수를 추가하려면 새 매개 변수 추가 목록을 열고 추가하려는 매개 변수를 선택합니다.

Property name	JSON 속성 이름	Required	설명
방법	`method`	아니요	들어오는 요청에서 논리 앱을 호출하는 데 사용해야 하는 메서드
상대 경로	`relativePath`	아니요	논리 앱의 엔드포인트의 URL이 수락할 수 있는 매개 변수에 대한 상대 경로입니다.

다음 예제에서는 메서드 속성을 추가합니다.

Screenshot showing Consumption workflow, Request trigger, and adding the

목록에서 메서드를 선택할 수 있도록 메서드 속성이 트리거에 표시됩니다.

Screenshot showing Consumption workflow, Request trigger, and the

준비되면 워크플로를 저장합니다. 디자이너 도구 모음에서 저장을 선택합니다.

이 단계에서는 워크플로를 트리거하는 요청을 전송하는 데 사용할 수 있는 URL을 생성합니다.
생성된 URL을 복사하려면 URL 옆에 있는 복사 아이콘을 선택합니다.

참고 항목

요청 트리거를 호출할 때 URI에 해시 또는 파운드 기호(#)를 포함하고자 하는 경우 대신 인코딩된 버전(%25%23)을 사용합니다.

Azure Portal의 디자이너에서 표준 논리 앱 리소스와 빈 워크플로를 엽니다.
디자이너에서 다음 일반 단계에 따라 HTTP 요청이 수신될 때라는 요청 기본 제공 트리거를 찾아서 추가합니다.

트리거 정보 상자가 나타나면 필요에 따라 다음 정보를 제공합니다.

Property name	JSON 속성 이름	Required	설명
HTTP POST URL	{없음}	예	워크플로를 저장한 후 생성되고 워크플로를 트리거하는 요청을 보내는 데 사용되는 엔드포인트 URL입니다.
요청 본문 JSON 스키마	`schema`	아니요	들어오는 요청 본문의 속성 및 값을 설명하는 JSON 스키마입니다. 디자이너는 이 스키마를 사용하여 요청에서 속성에 대한 토큰을 생성합니다. 이렇게 하면 워크플로가 요청 트리거의 출력을 구문 분석하고, 사용하고, 워크플로로 전달할 수 있습니다. JSON 스키마가 없을 경우 샘플 페이로드를 사용하여 스키마 생성 기능을 사용하여 샘플 페이로드에서 스키마를 생성할 수 있습니다.

다음 예제에서는 샘플 JSON 스키마를 보여 줍니다.

Screenshot showing Standard workflow and Request trigger with example JSON schema.

다음 예제에서는 전체 샘플 JSON 스키마를 보여 줍니다.

{
   "type": "object",
   "properties": {
      "account": {
         "type": "object",
         "properties": {
            "name": {
               "type": "string"
            },
            "ID": {
               "type": "string"
            },
            "address": {
               "type": "object",
               "properties": {
                  "number": {
                     "type": "string"
                  },
                  "street": {
                     "type": "string"
                  },
                  "city": {
                     "type": "string"
                  },
                  "state": {
                     "type": "string"
                  },
                  "country": {
                     "type": "string"
                  },
                  "postalCode": {
                     "type": "string"
                  }
               }
            }
         }
      }
   }
}

Screenshot showing Standard workflow, Request trigger, and reminder to include

다음 예제에서는 Content-Type 헤더가 JSON 형식으로 표시되는 방식을 보여 줍니다.

{
   "Content-Type": "application/json"
}

예상 페이로드(데이터)를 기반으로 하는 JSON 스키마를 생성하려면 JSONSchema.net과 같은 도구를 사용하거나 다음 단계를 수행합니다.

요청 트리거에서 샘플 페이로드를 사용하여 스키마 생성을 선택합니다.

샘플 페이로드를 입력하고 완료를 선택합니다.

Screenshot showing Standard workflow, Request trigger, and sample payload entered to generate schema.

다음 예제에서는 샘플 페이로드를 보여 줍니다.

{
   "account": {
      "name": "Contoso",
      "ID": "12345",
      "address": {
         "number": "1234",
         "street": "Anywhere Street",
         "city": "AnyTown",
         "state": "AnyState",
         "country": "USA",
         "postalCode": "11111"
      }
   }
}

인바운드 호출에 특정 스키마와 일치하는 요청 본문이 있는지 확인하려면 다음 단계를 수행합니다.
1. 인바운드 메시지가 스키마에서 설명하는 것과 동일한 필드를 갖도록 하려면 스키마에서 required 속성을 추가하고 필수 필드를 지정합니다. addtionalProperties 속성을 추가하고 값을 false로 설정합니다.
  
  예를 들어 다음 스키마는 인바운드 메시지에 다른 필드가 아닌 msg 필드가 있어야 한다고 지정합니다.
```
{
   "properties": {
     "msg": {
        "type": "string"
     }
   },
   "type": "object",
   "required": ["msg"],
   "additionalProperties": false
}
```
2. 디자이너에서 요청 트리거를 선택합니다. 열리는 정보 창에서 설정 탭을 선택합니다.
3. 데이터 처리를 확장하고 스키마 유효성 검사를 켜기로 설정합니다.
  
  인바운드 호출의 요청 본문이 스키마와 일치하지 않는 경우 트리거가 HTTP 400 잘못된 요청 오류를 반환합니다.

트리거에 다른 속성이나 매개 변수를 추가하려면 매개 변수 탭을 선택하고 새 매개 변수 추가 목록을 열고 추가할 매개 변수를 선택합니다.

Property name	JSON 속성 이름	Required	설명
방법	`method`	아니요	들어오는 요청에서 논리 앱을 호출하는 데 사용해야 하는 메서드
상대 경로	`relativePath`	아니요	논리 앱의 엔드포인트의 URL이 수락할 수 있는 매개 변수에 대한 상대 경로입니다.

다음 예제에서는 메서드 속성을 추가합니다.

Screenshot showing Standard workflow, Request trigger, and adding the

목록에서 메서드를 선택할 수 있도록 메서드 속성이 트리거에 표시됩니다.

Screenshot showing Standard workflow, Request trigger, and the

준비되면 워크플로를 저장합니다. 디자이너 도구 모음에서 저장을 선택합니다.

이 단계에서는 워크플로를 트리거하는 요청을 전송하는 데 사용할 수 있는 URL을 생성합니다.
생성된 URL을 복사하려면 URL 옆에 있는 복사 아이콘을 선택합니다.

참고 항목

요청 트리거를 호출할 때 URI에 해시 또는 파운드 기호(#)를 포함하고자 하는 경우 대신 인코딩된 버전(%25%23)을 사용합니다.

요청 트리거의 URL은 워크플로의 스토리지 계정과 연결됩니다. 스토리지 계정이 변경되면 이 URL도 변경됩니다. 예를 들어, 표준 논리 앱을 사용하는 경우 스토리지 계정을 수동으로 변경하고 워크플로를 새 스토리지 계정에 복사하면 요청 트리거의 URL도 새 스토리지 계정을 반영하도록 변경됩니다. 동일한 워크플로에 다른 URL이 있습니다.

이제 다음 단계로 다른 작업을 추가하여 워크플로를 계속 빌드합니다. 예를 들어 사용자 지정된 응답을 반환하는 데 사용할 수 있으며 이 문서의 뒷부분에서 설명하는 응답 작업을 추가하여 요청에 응답할 수 있습니다.

참고 항목

워크플로는 제한된 시간 동안만 인바운드 요청을 열어 둡니다. 워크플로에 응답 작업도 포함되어 있다고 가정하고, 이 시간이 만료된 후 워크플로가 호출자에게 응답을 반환하지 않으면 워크플로는 504 게이트웨이 시간 초과 상태를 호출자에게 반환합니다. 워크플로에 응답 작업이 포함되지 않은 경우 워크플로는 호출자에게 202 수락됨 상태를 즉시 반환합니다.

이전 명칭이 SSL(Secure Sockets Layer)이었던 TLS(전송 계층 보안), 논리 앱 리소스를 Azure API Management에 노출시키는 Microsoft Entra ID OAuth(Microsoft Entra ID Open Authentication) 같은 워크플로에 대한 인바운드 호출의 보안, 인증, 그리고 암호화, 또는 인바운드 호출을 시작하는 IP 제한에 대한 자세한 정보는 액세스 및 데이터 보안 - 요청 기반 트리거의 인바운드 호출 액세스를 참조하세요.

트리거 출력

다음 표에는 요청 트리거의 출력이 나와 있습니다.

JSON 속성 이름	데이터 형식	설명
headers	Object	요청의 헤더를 설명하는 JSON 개체입니다.
body	Object	요청의 본문 콘텐츠를 설명하는 JSON 개체입니다.

응답 작업 추가

요청 트리거를 사용하여 인바운드 요청을 수신하는 경우 요청 트리거와만 함께 작동하는 응답 기본 제공 작업을 사용하여 응답을 모델링하고 페이로드 결과를 다시 호출자에게 보낼 수 있습니다. 이 조합은 요청 트리거 및 응답 작업과 함께 요청-응답 패턴을 만듭니다. Foreach 루프와 Until 루프, 병렬 분기를 제외하면 워크플로의 어디에서나 응답 작업을 추가할 수 있습니다.

Important

응답 작업에 다음과 같은 헤더가 포함된 경우 Azure Logic Apps는 경고 또는 오류를 표시하지 않고 생성된 응답 메시지에서 이러한 헤더를 자동으로 제거합니다. 이러한 헤더가 포함된 응답 작업이 있는 워크플로를 저장하지 못하는 것은 아니지만 Azure Logic Apps에는 이러한 헤더가 포함되지 않습니다.
- Allow
- POST 및 PUT 작업을 사용하지만 GET 작업에는 포함되지 않는 경우의 Content-Disposition, Content-Encoding, Content-Type을 제외한 Content-* 헤더
- Cookie
- Expires
- Last-Modified
- Set-Cookie
- Transfer-Encoding
분기가 있는 복잡한 워크플로에 하나 이상의 응답 작업이 있는 경우 워크플로가 런타임 중에 하나 이상의 응답 작업을 처리하는지 확인합니다. 그렇지 않고 모든 응답 작업을 건너뛰면 워크플로가 성공적으로 완료되더라도 호출자는 502 잘못된 게이트웨이 오류를 수신합니다.
표준 논리 앱 상태 비저장 워크플로에서 응답 작업은 워크플로에 마지막으로 표시되어야 합니다. 작업이 다른 곳에 표시되면 Azure Logic Apps는 다른 모든 작업의 실행이 완료될 때까지 작업을 실행하지 않습니다.

소비
Standard

워크플로 디자이너에서 다음 일반 단계에 따라 응답이라는 응답 기본 제공 작업을 찾아서 추가합니다.

간단한 설명을 위해 다음 예제에서는 축소된 요청 트리거를 보여 줍니다.

작업 정보 상자에 응답 메시지에 필요한 값을 추가합니다.

Property name	JSON 속성 이름	Required	설명
상태 코드	`statusCode`	예	응답에 반환할 상태 코드
헤더	`headers`	아니요	응답에 포함할 하나 이상의 헤더를 설명하는 JSON 개체입니다.
본문	`body`	아니요	응답 본문

텍스트 필드 내부를 선택하면 동적 콘텐츠 목록이 자동으로 열립니다. 그런 다음, 워크플로의 이전 단계에서 사용 가능한 출력을 나타내는 토큰을 선택할 수 있습니다. 지정한 스키마의 속성도 이 동적 콘텐츠 목록에 나타납니다. 워크플로에서 사용할 속성을 선택할 수 있습니다.

예를 들어, 헤더 필드에 키 이름으로 Content-Type을 포함하고 이 문서 앞부분에서 언급한 대로 키 값을 application/json으로 설정합니다. 본문 상자의 경우 동적 콘텐츠 목록에서 트리거 본문 출력을 선택할 수 있습니다.

Screenshot showing Azure portal, Consumption workflow, and Response action information.

헤더를 JSON 형식으로 보려면 텍스트 뷰로 전환를 선택합니다.

Screenshot showing Azure portal, Consumption workflow, and Response action headers in

응답 본문의 JSON 스키마와 같은 작업에 대한 추가 속성을 추가하려면 새 매개 변수 추가 목록에서 추가하려는 매개 변수를 선택합니다.
완료되면 워크플로를 저장합니다. 디자이너 도구 모음에서 저장을 선택합니다.

워크플로 디자이너에서 다음 일반 단계에 따라 응답이라는 응답 기본 제공 작업을 찾아서 추가합니다.

작업 정보 상자에 응답 메시지에 필요한 값을 추가합니다.

Property name	JSON 속성 이름	Required	설명
상태 코드	`statusCode`	예	응답에 반환할 상태 코드
헤더	`headers`	아니요	응답에 포함할 하나 이상의 헤더를 설명하는 JSON 개체입니다.
본문	`body`	아니요	응답 본문

텍스트 필드 내부를 선택하면 동적 콘텐츠 목록(번개 아이콘)을 열 수 있는 옵션이 제공됩니다. 그런 다음, 워크플로의 이전 단계에서 사용 가능한 출력을 나타내는 토큰을 선택할 수 있습니다. 지정한 스키마의 속성도 이 동적 콘텐츠 목록에 나타납니다. 워크플로에서 사용할 속성을 선택할 수 있습니다.

예를 들어 헤더 상자의 경우 이 문서의 앞부분에서 설명한 것처럼 Content-Type을 키 이름으로 입력하고 키 값을 application/json으로 설정합니다. 본문 상자의 경우 동적 콘텐츠 목록에서 트리거 본문 출력을 선택할 수 있습니다.

Screenshot showing Azure portal, Standard workflow, and Response action information.

헤더를 JSON 형식으로 보려면 텍스트 뷰로 전환를 선택합니다.

Screenshot showing Azure portal, Standard workflow, and Response action headers in

응답 본문에 대한 JSON 스키마와 같은 작업의 추가 속성을 지정하려면 새 매개 변수 추가 목록을 열고 추가하려는 매개 변수를 선택합니다.
완료되면 워크플로를 저장합니다. 디자이너 도구 모음에서 저장을 선택합니다.

워크플로 테스트

워크플로를 테스트하려면 생성된 URL에 HTTP 요청을 보냅니다. 예를 들어 Postman과 같은 도구를 사용하여 HTTP 요청을 보낼 수 있습니다. 트리거의 기본 JSON 정의 및 이 트리거를 호출하는 방법에 대한 자세한 내용은 요청 트리거 형식 및 Azure Logic Apps의 HTTP 엔드포인트를 통해 워크플로 호출, 트리거 또는 중첩을 참조하세요.

보안 및 인증

요청 트리거(웹후크 트리거 아님)로 시작하는 표준 논리 앱 워크플로에서는 관리 ID를 사용하여 해당 트리거에서 만든 엔드포인트로 전송된 인바운드 호출을 인증하기 위해 Azure Functions 프로비전을 사용할 수 있습니다. 이 프로비전을 "Easy Auth"라고도 합니다. 자세한 내용은 간편한 인증을 사용하여 표준 논리 앱에서 트리거 워크플로를 검토하세요.

이전 명칭이 SSL(Secure Sockets Layer)이었던 TLS(전송 계층 보안), 논리 앱을 Azure API Management에 노출시키는 Microsoft Entra ID OAuth(Microsoft Entra ID Open Authentication) 같은 논리 앱 워크플로에 대한 인바운드 호출의 보안, 인증, 그리고 암호화, 혹은 인바운드 호출을 시작하는 IP 제한에 대한 자세한 정보는 액세스 및 데이터 보안 - 요청 기반 트리거의 인바운드 호출 액세스를 참조하세요.