BizTalk Server에서 논리 앱 어댑터 설치 및 사용Install and use the Logic App Adapter on BizTalk Server

BizTalk Server는 Logic Apps 어댑터를 사용 하 여 Azure 논리 앱에서 메시지를 수신 하거나 Azure 논리 앱에 메시지를 보냅니다.BizTalk Server uses the Logic Apps adapter to receive messages from an Azure logic app, or send messages to an Azure logic app.

Azure에서 논리 앱을 만듭니다.In Azure, we create a logic app. 이 논리 앱은 BizTalk Connector를 사용 하 여 BizTalk Server에서 만든 수신 위치에 연결 합니다.This logic app uses the BizTalk Connector to connect to a receive location that you create on your BizTalk Server. 이 항목에서는 Azure Logic Apps에 대해 잘 알고 있다고 가정 합니다.This topic assumes you have some familiarity with Azure Logic Apps. 논리 앱을 처음 접하는 경우 자세히 배우고 고유한 논리 앱을 만드는것이 좋습니다.If you're new to logic apps, we suggest learning more about them, and even creating your own logic app.

이 항목에서는 논리 앱에서 BizTalk Server 메시지를 수신 하는 단계를 나열 합니다.In this topic, we list the steps to receive a message in BizTalk Server from a logic app. 다른 방법으로, 논리 앱이 메시지를 BizTalk Server 보냅니다.Put another way, the logic app sends messages to a BizTalk Server. 수신 측은 IIS의 응용 프로그램을 사용 하 여 Azure 서비스와의 통신을 처리 합니다.The receive-side uses applications in IIS to handle the communication with the Azure service. BizTalk Server 온-프레미스 인 경우 BizTalk Server에 데이터 게이트웨이를 설치 하 고 Azure에서 게이트웨이를 만듭니다.If BizTalk Server is on-premises, you also install a data gateway on the BizTalk Server, and create a gateway in Azure.

BizTalk Server Azure VM (가상 컴퓨터)에 설치 된 경우 VM을 HTTP 끝점으로 표시 하거나 (URL을 가져올 수 있음) HTTP 끝점으로 노출 하지 않도록 선택할 수 있습니다.If BizTalk Server is installed on an Azure virtual machine (VM), then you can choose to expose the VM as an HTTP endpoint (you get a URL), or don't expose it as an HTTP endpoint. 노출 하는 경우 게이트웨이를 사용할 필요가 없습니다.If you expose it, then you don't need to use the gateway. 논리 앱의 BizTalk Connector에서 URL을 입력할 수 있습니다.You can enter your URL in the BizTalk Connector in your logic app. VM을 노출 하지 않는 경우 (URL 없음) 게이트웨이를 사용 해야 합니다.If you don't expose the VM (no URL), then you need to use the gateway. 이러한 단계는이 항목에 나와 있습니다.These steps are listed in this topic.

또한 BizTalk Server에서 Azure 논리 앱으로 메시지를 보내는 방법을 보여 줍니다.We also show you how to send messages from BizTalk Server to an Azure logic app. 다른 방식으로 논리 앱은 BizTalk Server에서 메시지를 받습니다.Put another way, the logic app receives messages from BizTalk Server. 이 항목에서 설명 하는 것 처럼 송신 측은 매우 간단 합니다.The send side is fairly straightforward, as you will see in this topic.

이 항목을 사용 하 여 Logic Apps 어댑터를 사용 하 여 수신 위치 및 송신 포트를 만듭니다.Use this topic to create a receive location and a send port using the Logic Apps adapter. 온-프레미스 (도메인에 가입) BizTalk Server 또는 BizTalk Server를 실행 하는 Azure 가상 머신에 LogicApp 어댑터를 사용할 수 있습니다.You can use the LogicApp adapter in a on-premises (joined to your domain) BizTalk Server, or an Azure virtual machine running BizTalk Server.

요구 사항Requirements

  • Azure 구독을 통해 Azure Portal에 로그인 하 고 논리 앱을 만들 수 있습니다.An Azure subscription to sign-in to the Azure portal, and create a logic app.
  • 선택 사항입니다.Optional. 논리 앱에 테스트 메시지를 보내려면 Fiddler 또는 POSTMAN과 같은 HTTP 테스트 도구를 설치 합니다.To send a test message to your logic app, install an HTTP testing tool, such as Fiddler or Postman. 다른 방법을 사용 하 여 논리 앱에 메시지를 보내는 경우에는 이러한 도구를 사용할 필요가 없습니다.If you use another method to send a message to a logic app, you don't have to use these tools.

논리 앱 어댑터 설치Install the Logic App adapter

BizTalk Server 2020 이상BizTalk Server 2020 and newer

BizTalk Server 2020부터 논리 앱 어댑터가 BizTalk Server 설치에 포함 됩니다.Starting with BizTalk Server 2020, the Logic App adapter is included with the BizTalk Server installation.

BizTalk Server 2016BizTalk Server 2016

  1. BizTalk Server에서 논리 앱 어댑터를 다운로드 하 여 설치 합니다.On your BizTalk Server, download and install the Logic App adapter:
  2. LogicApp Adapter.msi 를 두 번 선택 하 여 설치 합니다.Double-select LogicApp Adapter.msi to install. 사용권 계약에 동의 하 고를 설치 합니다.Accept the license agreement, and Install.
  3. 설치를 완료 하 고 BizTalkServerApplicationBizTalkServerIsolatedHost 호스트 인스턴스를 다시 시작 합니다.Finish the install, and restart the BizTalkServerApplication and BizTalkServerIsolatedHost host instances.

설치 되 면 다음을 수행 합니다.Once installed, you have the following:

  • BizTalk 관리에 LogicApp 어댑터가 추가 됩니다.The LogicApp adapter is added to BizTalk Administration.

  • 송신 핸들러가 만들어지고 BizTalkServerApplication 호스트를 사용 합니다.The send handler is created, and uses the BizTalkServerApplication host.

  • 수신 핸들러는 WCF 서비스로 만들어지며 BizTalkServerIsolatedHost 호스트를 사용 합니다.The receive handler is created as a WCF service, and uses the BizTalkServerIsolatedHost host.

  • LogicApp Adapter폴더는 BizTalk 설치 디렉터리 내에 만들어지며 관리 및 ReceiveService의 두 가지 서비스를 포함 합니다.The LogicApp Adapter folder is created inside the BizTalk installation directory, and includes two services: Management and ReceiveService.

    관리 는 논리 앱의 BizTalk Connector에서 데이터 게이트웨이를 사용 하 여 BizTalk Server에 연결 하는 데 사용 됩니다.The Management is used by the BizTalk Connector in a logic app to connect to BizTalk Server using the data gateway. 이 관리 서비스를 사용 하면 BizTalk Server 데이터 게이트웨이를 사용 하 여 Azure 논리 앱에서 메시지를 받을 수 있습니다.This management service allows BizTalk Server to receive messages from an Azure logic app using the data gateway. 이 서비스는 BizTalk의 수신 측 에서만 사용 됩니다.This service is only used on the receive-side of BizTalk. 송신 측에서 사용 되지 않습니다.It is not used by the send-side.

    ReceiveService 는 수신 위치를 입력할 때 논리 앱의 BizTalk 커넥터에서 사용 됩니다.The ReceiveService is used by the BizTalk Connector in a logic app when you enter the receive location. ReceiveService 는 논리 앱에서 메시지를 전송 하는 일을 담당 합니다.The ReceiveService is responsible for sending the messages from the logic app. 이 서비스는 BizTalk의 수신 측 에서만 사용 됩니다.This service is only used on the receive-side of BizTalk. 송신 측에서 사용 되지 않습니다.It is not used by the send-side.

논리 앱에서 메시지 받기Receive messages from a logic app

논리 앱에서 메시지를 수신 하는 BizTalk Server 관련 된 몇 가지 단계가 있습니다.There are a few steps involved for BizTalk Server to receive messages from a logic app. 이 섹션에서는 이러한 단계를 설명합니다.This section lists these steps. Azure의 사용자 인터페이스가 변경 될 수 있으므로 일부 단계가 정확 하 게 나열 되지 않을 수 있습니다.It's possible the user interface in Azure changes, so some of the steps may not be exactly as listed.

사전 요구 사항Prerequisites

NullAdapter와 논리 앱 어댑터를 함께 사용-BizTalk Server 2016만Using the NullAdapter and Logic App Adapter together - BizTalk Server 2016 only

논리 앱 어댑터와 NullAdapter를 설치 하면 다음과 같은 오류가 표시 될 수 있습니다.If you install the Logic App Adapter and the NullAdapter, you may see the following error:

Another adapter with the same OutboundEngineCLSID value already exists

어댑터 클래스의 GUID는 논리 앱 어댑터와 NullAdapter에 대해 동일 합니다.The GUID of the Adapter class is the same for Logic App Adapter and NullAdapter. 두 어댑터가 모두 필요한 경우 다음을 수행할 수 있습니다.If both adapters are needed, you can:

  1. GitHub에서 Nulladapter 소스 코드를 다운로드 합니다.Download the NullAdapter source code on GitHub.
  2. NullSendAdapter.cs 클래스에서 GUID를 업데이트 합니다.Update the GUID in the NullSendAdapter.cs class.
  3. Nulladapter .reg 파일의 OutboundEngineCLSID 값을 업데이트 합니다.Update the OutboundEngineCLSID value in the NullAdapter.reg file.
  4. NullAdapter를 빌드하고 배포 합니다.Build and deploy the NullAdapter.

1 단계: IIS 응용 프로그램 만들기Step 1: Create the IIS applications

IIS 응용 프로그램은 Management 및 ReceiveService 서비스를 사용 합니다.The IIS applications use the Management and ReceiveService services.

새 응용 프로그램 풀 또는 기존 응용 프로그램 풀을 사용 하 여 IIS 응용 프로그램을 실행할 수 있습니다.You can run the IIS applications using a new application pool, or an existing application pool. AppPool의 id에는 biztalk 응용 프로그램 사용자 및 BizTalk Isolated 호스트 사용자 그룹과 같은 BizTalk services를 실행 하는 계정과 동일한 그룹의 멤버 자격이 필요 합니다.The identity of the AppPool requires membership to the same groups as the account that runs the BizTalk services, such as the BizTalk Application Users and BizTalk Isolated Host Users groups.

새 응용 프로그램 풀을 만드는 경우 기본 .NET CLR 버전 및 관리 되는 파이프라인을 유지 합니다.If you create a new application pool, then keep the default .NET CLR version, and managed pipeline. BizTalk 서비스 계정과 동일한 BizTalk 그룹에 대 한 멤버 자격이 있는 id (고급 설정)를 선택 해야 합니다.Remember, choose an identity (Advanced Settings) that has membership to the same BizTalk groups as your BizTalk service account.

관리 IIS 응용 프로그램 만들기Create the Management IIS application

이 IIS 응용 프로그램의 URL은 BizTalk Connector (논리 앱)에서 BizTalk Server의 데이터 게이트웨이를 사용 하는 데 사용 됩니다.The URL of this IIS application is used by the BizTalk Connector (in your logic app) to use the data gateway on your BizTalk Server.

BizTalk Server 2020 이상BizTalk Server 2020 and newer
  1. BizTalk 구성 마법사를 사용 하 여 REST Api를 구성 합니다.Configure the REST APIs using the BizTalk Configuration Wizard. 구성에 대 한 도움말은 구성 가이드를 참조 하세요.For help with configuration, please refer to the Configuration Guide. REST Api에 대 한 자세한 내용은 BizTalk REST API 참조 를 참조 하세요.For more details about the REST APIs, please refer to the BizTalk REST API Reference
  2. 웹 브라우저를 열고로 이동 http://localhost/BizTalkManagementService/Schemas 합니다.Open a web browser, and go to http://localhost/BizTalkManagementService/Schemas. 스키마를 표시 하거나 열거나 저장 하 라는 메시지가 표시 됩니다 schemas.json .Either a list of schemas display, or you are prompted to open/save schemas.json. 실제 결과는 웹 브라우저에 따라 달라 집니다.The actual result depends on your web browser. 이러한 상황이 발생 하지 않으면 REST API 구성을 확인 하세요.If neither of these happens, then please check your REST API configuration.
BizTalk Server 2016BizTalk Server 2016
  1. IIS(인터넷 정보 서비스) 관리자를 엽니다.Open the Internet Information Services (IIS) Manager.

  2. 기본 웹 사이트 를 마우스 오른쪽 단추로 클릭 하 고 응용 프로그램을 추가 합니다.Right-click Default Web Site, and Add Application. 이 새 응용 프로그램에서:In this new application:

    1. 응용 프로그램에 대 한 별칭 (이름) (예: IISLogicApp)을 입력 합니다.Enter the Alias (name) for your application, such as IISLogicApp.
    2. 응용 프로그램 풀을 선택 합니다.Select the application pool.
    3. 실제 경로 를로 설정 C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter\Management 합니다.Set the Physical path to C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter\Management.
    4. 응용 프로그램 풀 id가 인증 및 권한 부여 테스트를 통과 하는지 확인 하는 테스트 설정 입니다.Test Settings to confirm the application pool identity passes the Authentication and Authorization tests.
  3. 확인 을 선택하여 변경 내용을 저장합니다.Select OK to save your changes.

  4. 웹 브라우저를 열고와 같은로 이동 http://localhost/YourApplicationAlias/schemas?api-version=2016-10-26 http://localhost/IISLogicApp/Schemas?api-version=2016-10-26 합니다.Open a web browser, and go to http://localhost/YourApplicationAlias/schemas?api-version=2016-10-26, such as http://localhost/IISLogicApp/Schemas?api-version=2016-10-26. 스키마를 표시 하거나 열거나 저장 하 라는 메시지가 표시 됩니다 schemas.json .Either a list of schemas display, or you are prompted to open/save schemas.json. 실제 결과는 웹 브라우저에 따라 달라 집니다.The actual result depends on your web browser. 이러한 상황이 발생 하지 않으면 AppPool id가 BizTalk 그룹에 대 한 멤버 자격을 누락 했을 수 있습니다.If neither of these happens, then your AppPool identity may be missing membership to the BizTalk groups.

BizTalk ReceiveService IIS 응용 프로그램 만들기Create the BizTalk ReceiveService IIS application

이 IIS 응용 프로그램의 URL은 수신 위치를 선택할 때 논리 앱에서 BizTalk Connector에 사용 됩니다.The URL of this IIS application is used by the BizTalk Connector (in your logic app) when you choose the receive location.

  1. IIS(인터넷 정보 서비스) 관리자를 엽니다.Open the Internet Information Services (IIS) Manager.

  2. 기본 웹 사이트 를 마우스 오른쪽 단추로 클릭 하 고 응용 프로그램을 추가 합니다.Right-click Default Web Site, and Add Application. 이 새 응용 프로그램에서:In this new application:

    1. 응용 프로그램에 대 한 별칭 (이름) (예: ReceiveWCFService)을 입력 합니다.Enter the Alias (name) for your application, such as ReceiveWCFService.

    2. 이전 IIS 응용 프로그램과 동일한 응용 프로그램 풀을 선택 합니다.Select the same application pool as the previous IIS application.

    3. 실제 경로 를 다음과 같이 설정 합니다.Set the Physical path to:

      • BizTalk Server 2020: C:\Program Files (x86)\Microsoft BizTalk Server\LogicApp Adapter\ReceiveService .BizTalk Server 2020: C:\Program Files (x86)\Microsoft BizTalk Server\LogicApp Adapter\ReceiveService.
      • BizTalk Server 2016: C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter\ReceiveService .BizTalk Server 2016: C:\Program Files (x86)\Microsoft BizTalk Server 2016\LogicApp Adapter\ReceiveService.
    4. 응용 프로그램 풀 id가 인증 및 권한 부여 테스트를 통과 하는지 확인 하는 테스트 설정 입니다.Test Settings to confirm the application pool identity passes the Authentication and Authorization tests.

  3. 확인 을 선택하여 변경 내용을 저장합니다.Select OK to save your changes.

2 단계: 논리 앱 만들기Step 2: Create a logic app

  1. Azure Portal에서 새 논리 앱을 만듭니다.In the Azure portal, create a new logic app.

  2. HTTP 요청을 받을 때 트리거를 추가 합니다.Add the When an HTTP request is received trigger.

  3. JSON에서 BizTalk Server-준비 메시지 작업을 추가 합니다.Add the BizTalk Server - Prepare message from JSON action.

  4. 선택 사항: 온-프레미스 데이터 게이트웨이를 통해 연결 을 선택 하 고 다음을 입력 합니다.Optional: Select Connect via on-premise data gateway, and enter the following:

    속성Property DescriptionDescription
    BizTalk Server URLBizTalk Server URL IIS 응용 프로그램 URL에서 BizTalk 관리의 FQDN (정규화 된 도메인 이름)을 입력 합니다.Enter the fully qualified domain name (FQDN) of the BizTalk Management in IIS application URL. 예를 들어 다음과 같이 입력합니다. http://BizTalkServerName.corp.contoso.com/IISLogicApp/For example, enter http://BizTalkServerName.corp.contoso.com/IISLogicApp/.
    인증 유형Authentication Type Windows 를 선택합니다.Select Windows.
    사용자 이름Username IIS 응용 프로그램 풀의 id를 입력 합니다.Enter the identity of the IIS application pool.
    암호Password IIS 응용 프로그램 풀의 암호를 입력 합니다.Enter the password of the IIS application pool.
    게이트웨이Gateway 만든 게이트웨이를 선택 합니다.Select the gateway you created.

    데이터 게이트웨이는 다음과 같은 경우에만 필요 합니다.Remember, the data gateway is only required if:

    • 온-프레미스 BizTalk Server를 사용 하 고 있습니다.You're using an on-premises BizTalk Server
    • BizTalk Server Azure 가상 머신을 사용 하 고 있으며 VM이 HTTP 끝점 (URL 없음)으로 노출 되지 않습니다.You're using a BizTalk Server Azure virtual machine and the VM is NOT exposed as an HTTP endpoint (no URL)
  5. 만들기 를 선택합니다.Select Create.

  6. 작업을 구성 합니다.Configure the action. 본문 에서 HTTP 본문 출력을 선택 합니다.For Body, select the HTTP body output. 스키마 에서 사용 하려는 스키마를 선택 합니다.For Schema, select the schema you want to use.

    참고

    이 단계에서는 BizTalk의 스키마에 대해 잘 알고 있고 원하는 스키마를 알고 있다고 가정 합니다.This step assumes you are familiar with schemas in BizTalk, and know which schema you want. 확실 하지 않은 경우 HelloWorld SDK 샘플을 배포 하 고, 논리 앱 어댑터를 사용 하도록 아티팩트를 업데이트 하 고, 스키마 및 샘플 메시지를 사용 합니다.If you're not sure, then deploy the HelloWorld SDK sample, update its artifacts to use the Logic App adapter, and use its schema and sample message.

  7. 새 단계를 추가 하 고 BizTalk Server-메시지 보내기 작업을 선택 합니다.Add a new step, and select the BizTalk Server - Send message action. 수신 위치 의 경우 드롭다운 목록에서 URL을 선택 하거나 ReceiveService IIS 응용 프로그램 URL의 FQDN (정규화 된 도메인 이름)을 입력 합니다.For Receive Location, select the URL from the drop-down list, or enter the fully qualified domain name (FQDN) of the ReceiveService IIS application URL. 예를 들어 다음과 같이 입력합니다. http://BizTalkServerName.corp.contoso.com/ReceiveWCFService/Service1.svcFor example, enter http://BizTalkServerName.corp.contoso.com/ReceiveWCFService/Service1.svc.

    수신 위치를 만들 때이 정확한 URL이 수신 위치 전송 속성에 공용 주소 (일반 탭)로도 입력 됩니다.When you create the receive location, this exact URL will also be entered in the receive location transport properties as the Public Address (General tab).

    본문 의 경우 이전 BizTalk Server 작업에서 본문 출력을 선택 합니다.For Body, select the body output from the previous BizTalk Server action.

  8. 변경 내용을 저장 합니다.Save your changes.

저장 하면 HTTP 요청 트리거에서 URL을 자동으로 만듭니다.When you save, the HTTP Request trigger automatically creates a URL. 이 URL을 복사 합니다.Copy this URL. 4 단계: 메시지 보내기 (이 문서의)에서 필요 합니다.You need it in Step 4: Send a message (in this article).

3 단계: 수신 포트 및 수신 위치 만들기Step 3: Create a receive port and a receive location

참고

사용자 고유의 수신 포트 및 수신 위치를 만드는 대신 HelloWorld SDK 샘플을 배포할 수 있습니다.Instead of creating your own receive ports and receive location, you can deploy the HelloWorld SDK sample. Logic Apps 어댑터를 사용 하도록 아티팩트를 업데이트 합니다.Update the artifacts to use the Logic Apps adapter.

이 섹션에는 사용자 고유의 아티팩트를 만드는 단계가 나와 있습니다.This section lists the steps to create your own artifacts.

  1. BizTalk Server 관리에서 BizTalk Server 관리, BizTalk 그룹, 응용 프로그램 을 차례로 확장 한 다음 수신 위치를 실행 하려는 응용 프로그램을 확장 합니다.In BizTalk Server Administration, expand BizTalk Server Administration, expand BizTalk Group, expand Applications, and then expand the application you want to run the receive location. 예를 들어 BizTalk Application 1 을 확장 합니다.For example, expand BizTalk Application 1.

  2. 수신 포트 를 마우스 오른쪽 단추로 선택 하 고 새로 만들기 를 선택한 다음 단방향 수신 포트 를 선택 합니다.Right-select Receive Ports, select New, and select One-way Receive Port.

  3. 수신 포트 속성에서 다음을 입력 합니다.In the Receive Port properties, enter the following:

    사용 항목Use this 원하는 작업To do this
    이름Name 수신 포트의 이름을 입력 합니다.Enter a name for the receive port. 예를 들어 LAReceivePort 을 입력 합니다.For example, enter LAReceivePort.
    인증Authentication 옵션:Options:
    • 인증 안 함: 기본값입니다.No Authentication: Default. 인증을 사용 하지 않습니다.Disables authentication.
    • 인증 실패 시 메시지 삭제: 인증을 사용 하도록 설정 하 고 인증 되지 않은 메시지를 삭제 합니다.Drop messages if authentication fails: Enables authentication but to drop unauthenticated messages.
    • 인증 실패 시 메시지 유지: 인증을 사용 하도록 설정 하 고 인증 되지 않은 메시지를 유지 하려면이 옵션을 클릭 합니다.Keep messages if authentication fails: Click this option to enable authentication and keep unauthenticated messages.
    실패 한 메시지에 대 한 라우팅 사용Enable routing for failed messages 처리 하지 못한 모든 메시지를 등록 응용 프로그램 (예: 다른 수신 포트 또는 오케스트레이션 일정)으로 라우팅합니다.Routes any message that fails processing to a subscribing application (such as another receive port or orchestration schedule). 실패 한 메시지를 일시 중단 하 고 부정 승인 (NACK)을 생성 하려면이 옵션의 선택을 취소 합니다.Uncheck this option to suspend failed messages and generate a negative acknowledgment (NACK). 기본적으로 선택 취소되어 있습니다.The default value is cleared. 자세한 내용은 수신 포트에 대해 실패 한 메시지 라우팅을 사용 하도록 설정 하는 방법을 참조 하세요.For more information, see How to Enable Routing for Failed Messages for a Receive Port.
  4. 수신 위치 를 선택 하 고 새로 만들기 를 선택 합니다.Select Receive Locations, and select New.

  5. 수신 위치에 대 한 이름을 입력 합니다.Enter a Name for the receive location. 예를 들어 LAReceiveLoc 을 입력 합니다.For example, enter LAReceiveLoc.

  6. 형식 의 경우 목록에서 LogicApp 를 선택 하 고 구성 단추 를 선택 합니다.For the Type, select LogicApp from the list, and select the Configure button.

  7. 일반 탭에서 논리 앱에 대 한 끝점 주소를 구성 합니다.In the General tab, configure the endpoint address for your logic app:

    사용 항목Use this 원하는 작업To do this
    주소(URI)Address (URI) 필수 요소.Required. BizTalk ReceiveService IIS 응용 프로그램 URL ()을 입력 /YourIISApp2Name/Service1.svc 합니다.Enter the BizTalk ReceiveService IIS application URL (/YourIISApp2Name/Service1.svc). 예를 들어 다음과 같이 입력합니다. /ReceiveWCFService/Service1.svcFor example, enter /ReceiveWCFService/Service1.svc.
    공용 주소Public Address 필수 요소.Required. http://<your fully qualified machine name>/YourIISApp2Name/Service1.svc를 입력합니다.Enter http://<your fully qualified machine name>/YourIISApp2Name/Service1.svc. 예를 들어 다음과 같이 입력합니다. http://btsProd.northamerica.corp.contoso.com/ReceiveWCFService/Service1.svcFor example, enter http://btsProd.northamerica.corp.contoso.com/ReceiveWCFService/Service1.svc.

    이 정확한 URL은 논리 앱의 수신 위치에도 나열 됩니다.This exact URL is also listed in your logic app in the receive location.
  8. 선택 사항입니다.Optional. 바인딩 탭에서 기본 WCF-WebHttp 바인딩의 제한 시간 및 인코딩 관련 속성을 구성 합니다.In the Binding tab, configure any timeout and encoding-related properties of the underlying WCF-WebHttp binding. 이러한 속성은 큰 메시지를 처리할 때 유용 합니다.These properties are helpful when dealing with large messages.

    사용 항목Use this 원하는 작업To do this
    열기 제한 시간Open timeout 채널 열기 작업을 완료 하는 데 소요 되는 시간 간격을 입력 합니다.Enter the time interval it should take for the channel open operation to complete. 이 값은 System.TimeSpan.Zero보다 크거나 같아야 합니다.This value should be greater than or equal to System.TimeSpan.Zero.

    기본값: 00:01:00Default value: 00:01:00
    최대값: 23:59:59Maximum value: 23:59:59
    송신 제한 시간Send timeout 보내기 작업을 완료 하는 데 소요 되는 시간 간격을 입력 합니다.Enter the time interval it should take for the send operation to complete. 이 값은 System.TimeSpan.Zero보다 크거나 같아야 합니다.This value should be greater than or equal to System.TimeSpan.Zero. 요청-응답 수신 포트를 사용 하는 경우이 값은 클라이언트에서 많은 메시지를 반환 하더라도 전체 상호 작용이 완료 될 수 있는 시간 범위를 지정 합니다.If you use a request-response receive port, this value specifies a time span for the entire interaction to complete, even if the client returns a large message.

    기본값: 00:01:00Default value: 00:01:00
    최대값: 23:59:59Maximum value: 23:59:59
    닫기 시간 제한Close timeout 채널 닫기 작업을 완료 하는 데 소요 되는 시간 간격을 입력 합니다.Enter the time interval it should take for the channel close operation to complete. 이 값은 System.TimeSpan.Zero보다 크거나 같아야 합니다.This value should be greater than or equal to System.TimeSpan.Zero.

    기본값: 00:01:00Default value: 00:01:00
    최대값: 23:59:59Maximum value: 23:59:59
    최대 수신 메시지 크기(바이트)Maximum received message size (bytes) 네트워크에서 받을 헤더를 포함 하는 메시지의 최대 크기 (바이트)를 입력 합니다.Enter the maximum size, in bytes, for a message including headers, to be received on the wire. 메시지 크기는 각 메시지에 할당 된 메모리 양에 따라 바인딩됩니다.The size of the messages is bound by the amount of memory allocated for each message. 이 속성을 사용하여 Dos(서비스 거부) 공격에 노출될 가능성을 줄일 수 있습니다.You can use this property to limit exposure to denial of service (DoS) attacks.

    기본값: 65536Default value: 65536
    최대값: 2147483647Maximum value: 2147483647
    최대 동시 호출 수Maximum concurrent calls 단일 서비스 인스턴스에 대 한 동시 호출 수를 입력 합니다.Enter the number of concurrent calls to a single service instance. 한도를 초과하는 호출은 대기됩니다.Calls in excess of the limit are queued. 이 값을 0으로 설정하는 것은 Int32.MaxValue로 설정하는 것과 같습니다.Setting this value to 0 is equivalent to setting it to Int32.MaxValue.

    기본값은 200입니다.The default is 200.
  9. 선택 사항입니다.Optional. 보안 탭에서 보안 속성을 구성 합니다.In the Security tab, configure any security properties. 개발을 위해 없음을 선택할 수 있습니다.For development purposes, you can choose None:

    사용 항목Use this 원하는 작업To do this
    보안 모드Security mode 옵션:Options:

    • 없음: 메시지가 전송되는 동안 보안이 유지되지 않습니다.None: Messages are not secured during transfer.
    • 전송: HTTPS 전송을 통해 보안이 유지됩니다.Transport: Security is provided using the HTTPS transport. SOAP 메시지는 HTTPS를 통해 보안이 유지됩니다.The SOAP messages are secured using HTTPS. 이 모드를 사용 하려면 인터넷 정보 서비스 (IIS)에서 SSL(Secure Sockets Layer) (SSL)를 설정 해야 합니다.To use this mode, you must set up Secure Sockets Layer (SSL) in Internet Information Services (IIS).
    • %): 기본값입니다.TransportCredentialOnly: Default.
    전송 클라이언트 자격 증명 유형Transport client credential types 클라이언트 인증을 사용 하는 경우 자격 증명 유형을 선택 합니다.Choose the credential type when using client authentication. 옵션:Options:

    • 없음: 전송 수준에서 인증이 수행되지 않습니다.None: No authentication occurs at the transport level.
    • 기본: 기본 인증을 사용 하 여 네트워크를 통해 사용자 이름 및 암호를 일반 텍스트로 보냅니다.Basic: Uses Basic authentication to send user names and passwords in plain text over the network. 자격 증명에 해당하는 도메인 사용자 계정이나 로컬 사용자 계정을 만들어야 합니다.You must create the domain or local user accounts corresponding to the credentials.
    • 다이제스트: 다이제스트 인증을 사용 하 여 네트워크를 통해 암호를 해시 값으로 보냅니다.Digest: Uses Digest authentication to send passwords as a hash value over the network. Windows Server 운영 체제 인증을 실행 하는 도메인 컨트롤러가 있는 도메인 에서만 사용할 수 있습니다.Only available on domains with domain controllers running Windows Server operating systems authentication. 클라이언트 자격 증명에 해당하는 도메인 사용자 계정이나 로컬 사용자 계정을 만들어야 합니다.You must create the domain or local user accounts corresponding to client credentials.
    • Ntlm: 기본값입니다.Ntlm: Default. 클라이언트는이 수신 위치로 암호를 보내지 않고 자격 증명을 보냅니다.Clients sends the credentials without sending a password to this receive location. 클라이언트 자격 증명에 해당하는 도메인 사용자 계정이나 로컬 사용자 계정을 만들어야 합니다.You must create the domain or local user accounts corresponding to client credentials.
    • Windows: Windows 통합 인증은 kerberos 또는 NTLM을 협상 하 고 도메인이 있는 경우 Kerberos를 우선적으로 제공 합니다.Windows: Windows integrated authentication negotiates Kerberos or NTLM, preferring Kerberos if a domain is present. Kerberos를 사용 하려면 클라이언트가 SPN (서비스 사용자 이름)을 사용 하 여 서비스를 식별 하는 것이 중요 합니다.To use Kerberos, it is important to have the client identify the service with a service principal name (SPN). 클라이언트 자격 증명에 해당하는 도메인 사용자 계정이나 로컬 사용자 계정을 만들어야 합니다.You must create the domain or local user accounts corresponding to client credentials.
    • Certificate: 클라이언트 인증서를 사용 합니다.Certificate: Uses a client certificate. 클라이언트가이 수신 위치에 대해 인증할 수 있도록이 컴퓨터의 신뢰할 수 있는 루트 인증 기관 인증서 저장소에 클라이언트 x.509 인증서에 대 한 CA 인증서 체인을 설치 해야 합니다.The CA certificate chain for the client X.509 certificates must be installed in the Trusted Root Certification Authorities certificate store of this computer so that the clients can authenticate to this receive location.
    • InheritedFromHostInheritedFromHost
    Single Sign-On 사용Use Single Sign-On
  10. 선택 사항입니다.Optional. 메시지 탭에서 아웃 바운드 HTTP 헤더 속성을 사용 하 여 사용자 지정 헤더를 추가 하 고 추가 속성을 사용 하 여 오류에 도움을 줍니다.In the Messages tab, use the Outbound HTTP Headers property to add any custom headers, and use the additional properties to help with faults:

    사용 항목Use this 원하는 작업To do this
    아웃바운드 HTTP 헤더Outbound HTTP Headers 응답 메시지에 스탬프를 지정할 HTTP 헤더를 입력 합니다.Enter any HTTP headers that you want stamped on the response message.
    실패 시 위치 사용 안 함Disable location on failure 수신 파이프라인 오류 또는 라우팅 오류로 인해 인바운드 처리가 실패 하는 경우 수신 위치를 사용 하지 않도록 설정 합니다.Disables the receive location if inbound processing fails due to a receive pipeline failure or a routing failure. 기본값은 선택 취소 되어 있습니다.Default is unchecked.
    실패 시 요청 메시지 일시 중단Suspend request message on failure 수신 파이프라인 오류 또는 라우팅 오류로 인해 인바운드 처리가 실패 하는 경우 요청 메시지를 일시 중단 합니다.Suspends the request message if inbound processing fails due to a receive pipeline failure or a routing failure. 기본값은 선택 취소 되어 있습니다.Default is unchecked.
    오류에 예외 정보 포함Include exception detail in faults 오류가 발생 하면에서 디버깅에 도움이 되는 SOAP 오류를 반환 합니다.When an error occurs, returns any SOAP faults to help debugging. 기본값은 선택 취소 되어 있습니다.Default is unchecked.

수신 위치 관리 는 추가 속성을 설명 합니다.Managing Receive Locations describes the additional properties.

4 단계: 메시지 보내기Step 4: Send a message

  1. Fiddler 또는 Postman (또는 선호 하는 항목)을 엽니다.Open Fiddler or Postman (or whatever you prefer).

  2. 논리 앱에서 요청 트리거의 URL을 붙여넣습니다.Paste the URL of the Request trigger from your logic app. 3 단계에서이 URL을 복사 했습니다.You copied this URL in Step 3.

  3. HTTP 동사로 게시 를 선택 하 고 content-type 헤더를로 설정 application/json 합니다.Select POST as the HTTP verb, and set the Content-type header to application/json. 본문에서 다음 JSON을 붙여넣습니다.In the body, paste the following JSON:

    {"hello":"world"}
    
  4. BizTalk에 대 한 단방향 호출 이므로 결과는 HTTP 202 이어야 합니다.Because this is a one-way call to BizTalk, the result should be an HTTP 202. HelloWorld SDK 샘플을 사용 하는 경우 BizTalk server로 이동 합니다.If you're using the HelloWorld SDK sample, go to your BizTalk server. 송신 폴더에 파일이 있을 수 있습니다.There may be a file in your send folder.

논리 앱에 메시지 보내기Send messages to a logic app

1단계: 논리 앱 만들기Step 1: Create a logic app

  1. Azure Portal에서 새 논리 앱을 만듭니다.In the Azure portal, create a new logic app.

  2. HTTP 요청을 받을 때 트리거를 추가 합니다.Add the When an HTTP request is received trigger

  3. Office 365 Outlook-전자 메일 보내기 작업을 추가 합니다.Add the Office 365 Outlook - Send an email action. To Address에서 Office 365 주소를 입력 합니다.For the To address, enter your Office 365 address. 제목 에를 입력 Sending from BizTalk 합니다.For the Subject, enter Sending from BizTalk. 본문 의 경우 HTTP 요청을 받을 때 트리거 트리거를 선택 합니다.For Body, choose the Body output from the When an HTTP request is received trigger.

  4. 논리 앱은 다음 예제와 유사 합니다.Your logic app looks similar to the following example:

    Office 365 및 Outlook을 사용 하는 LogicApp 어댑터 예제

  5. 논리 앱을 저장할 때 자동으로 생성 되는 HTTP POST URL을 복사 합니다. 이 URL은 다음 단계에서 필요 합니다.Copy the HTTP POST URL that is automatically created when you save the logic app; you need this URL in the next step. URL을 보려면 논리 앱을 닫았다가 다시 열어야 할 수도 있습니다.You may have to close and reopen the logic app to see the URL.

2 단계: 송신 포트 만들기Step 2: Create a Send Port

논리 앱에 메시지를 보내는 BizTalk Server의 경우, 논리 앱은 수동-HTTP 요청을 받을 때 와 같은 수동 트리거를가지고 있어야 합니다.For BizTalk Server to send messages to a logic app, the logic app must have a Manual trigger, such as Manual - When an HTTP request is received.

  1. BizTalk Server 관리에서 BizTalk Server 관리, BizTalk 그룹, 응용 프로그램 을 차례로 확장 한 다음 송신 포트를 실행 하려는 응용 프로그램을 확장 합니다.In BizTalk Server Administration, expand BizTalk Server Administration, expand BizTalk Group, expand Applications, and then expand the application you want to run the send port. 예를 들어 BizTalk Application 1 을 확장 합니다.For example, expand BizTalk Application 1.

  2. 송신 포트 를 마우스 오른쪽 단추로 선택 하 고 새로 만들기 를 선택한 다음 정적 단방향 송신 포트 를 선택 합니다.Right-select Send Ports, select New, and select Static One-way Send Port.

  3. 송신 포트의 이름을 입력 합니다.Enter a Name for the send port. 예를 들어 LASendPort 을 입력 합니다.For example, enter LASendPort.

  4. 형식 의 경우 목록에서 LogicApp 를 선택 하 고 구성 단추를 선택 합니다.For the Type, select LogicApp from the list, and select the Configure button.

  5. 일반 탭에서 논리 앱 트리거의 콜백 URI 를 구성 합니다.In the General tab, configure the Callback URI of your logic app trigger. 여기에는 두 가지 방법이 있습니다.There are two ways to do this:

    옵션 1 : 트리거 (콜백 URI) 속성의 이전 단계에서 복사한 HTTP POST URL을 붙여넣습니다.Option 1 : Paste the HTTP POST URL you copied in the previous step in the Trigger (Callback URI) property. 다음 단계를 사용 하 여 URI를 복사할 수도 있습니다.You can also copy the URI using the following steps:

    1. Azure Portal에서 Logic Apps 디자이너 (편집 모드)에서 논리 앱을 엽니다.In the Azure portal, open your logic app in the Logic Apps designer (edit mode).

    2. HTTP 요청이 수신 되 면 카드를 선택 하 고 URL 을 복사 합니다.Select the When an HTTP request is received card, and copy the URL.

    3. 송신 포트에서이 URL을 트리거 (콜백 URI) 속성에 붙여넣습니다.In your send port, paste this URL in the Trigger (Callback URI) property.

      관리 Api를 사용 하 여이 URI를 가져올 수도 있습니다.You can also use your management APIs to get this URI.

      옵션 2 : 트리거에 대 한 콜백 URI를 모르는 경우 구성 을 선택 하 고 Azure에 로그인 합니다.Option 2 : If you don't know the Callback URI for your trigger, select Configure, and sign-in to Azure. 그런 다음 드롭다운 목록을 사용 하 여 구독, 리소스 그룹, 논리 앱트리거 를 선택 합니다.Then, use the drop-down lists to choose your Subscription, Resource Group, Logic App, and Trigger.

  6. 선택 사항입니다.Optional. 바인딩 탭에서 기본 WCF-WebHttp 바인딩의 제한 시간 및 인코딩 관련 속성을 구성 합니다.In the Binding tab, configure any timeout and encoding-related properties of the underlying WCF-WebHttp binding. 이러한 속성은 큰 메시지를 처리할 때 유용 합니다.These properties are helpful when dealing with large messages.

    사용 항목Use this 원하는 작업To do this
    열기 제한 시간Open timeout 채널 열기 작업을 완료 하는 데 소요 되는 시간 간격을 입력 합니다.Enter the time interval it should take for the channel open operation to complete. 이 값은 System.TimeSpan.Zero보다 크거나 같아야 합니다.This value should be greater than or equal to System.TimeSpan.Zero.

    기본값: 00:01:00Default value: 00:01:00
    최대값: 23:59:59Maximum value: 23:59:59
    송신 제한 시간Send timeout 보내기 작업을 완료 하는 데 소요 되는 시간 간격을 입력 합니다.Enter the time interval it should take for the send operation to complete. 이 값은 System.TimeSpan.Zero보다 크거나 같아야 합니다.This value should be greater than or equal to System.TimeSpan.Zero. 요청-응답 수신 포트를 사용 하는 경우이 값은 클라이언트에서 많은 메시지를 반환 하더라도 전체 상호 작용이 완료 될 수 있는 시간 범위를 지정 합니다.If you use a request-response receive port, this value specifies a time span for the entire interaction to complete, even if the client returns a large message.

    기본값: 00:01:00Default value: 00:01:00
    최대값: 23:59:59Maximum value: 23:59:59
    닫기 시간 제한Close timeout 채널 닫기 작업을 완료 하는 데 소요 되는 시간 간격을 입력 합니다.Enter the time interval it should take for the channel close operation to complete. 이 값은 System.TimeSpan.Zero보다 크거나 같아야 합니다.This value should be greater than or equal to System.TimeSpan.Zero.

    기본값: 00:01:00Default value: 00:01:00
    최대값: 23:59:59Maximum value: 23:59:59
    최대 수신 메시지 크기(바이트)Maximum received message size (bytes) 네트워크에서 받을 헤더를 포함 하는 메시지의 최대 크기 (바이트)를 입력 합니다.Enter the maximum size, in bytes, for a message including headers, to be received on the wire. 메시지 크기는 각 메시지에 할당 된 메모리 양에 따라 바인딩됩니다.The size of the messages is bound by the amount of memory allocated for each message. 이 속성을 사용하여 Dos(서비스 거부) 공격에 노출될 가능성을 줄일 수 있습니다.You can use this property to limit exposure to denial of service (DoS) attacks.

    논리 appa 어댑터는 버퍼링 된 전송 모드에서 WebHttpBinding 클래스 를 활용 하 여 끝점과 통신 합니다.The logic appa adapter leverages the WebHttpBinding class in the buffered transfer mode to communicate with an endpoint. 버퍼링된 전송 모드에서는 WebHttpBinding.MaxBufferSize 속성이 항상 이 속성의 값과 일치합니다.For the buffered transport mode, the WebHttpBinding.MaxBufferSize property is always equal to the value of this property.

    기본값: 65536Default value: 65536
    최대값: 2147483647Maximum value: 2147483647
  7. 선택 사항입니다.Optional. 메시지 탭에서 아웃 바운드 HTTP 헤더 속성을 사용 하 여 보내는 메시지에 사용자 지정 헤더를 추가 합니다.In the Messages tab, use the Outbound HTTP Headers property to add any custom headers on the outgoing message.

  8. 확인 을 선택하여 구성을 저장합니다.Select OK to save your configuration.

송신 포트 및 송신 포트 그룹 관리 는 추가 송신 포트 속성을 설명 합니다.Managing Send Ports and Send Port Groups describes the additional send port properties.

3 단계: 일부 메시지 보내기Step 3: Send some messages

File 어댑터를 사용 하 여 수신 포트 및 수신 위치를 만들 수 있습니다.You can create a receive port and receive location using the File adapter. 논리 앱이 사용 하도록 설정 되어 있어야 합니다.Be sure your logic app is enabled.

  1. Filesendport 와 같은 수신 포트를 만듭니다.Create a receive port, such as FileSendPort,

  2. 수신 위치를 만들고 다음과 같은 속성을 설정 합니다.Create a receive location, and set the properties similar to:

    속성Property 샘플 입력Sample input
    수신 폴더Receive folder C:\temp\InC:\temp\In\
    파일 마스크File mask *.txt*.txt
    파이프라인Pipeline PassThruReceivePassThruReceive
  3. 만든 송신 포트에서 필터 를로 설정 합니다.In the send port you created, set the Filter to:

    속성Property 연산자Operator Value
    BTS.ReceivePortNameBTS.ReceivePortName == FileSendPortFileSendPort
  4. 다음 텍스트를 사용 하 여 텍스트 파일 (FileName.txt)을 만듭니다.Create a text file (FileName.txt) with the following text. 이 텍스트 파일을 샘플 메시지로 사용 합니다.Use this text file as your sample message:

    <Data>
      <DataID>DataID_0</DataID>
      <DataDetails>DataDetails_0</DataDetails>
    </Data>
    
  5. 샘플 메시지 (FileName.txt)를 receive 폴더에 복사 합니다.Copy your sample message (FileName.txt) into the receive folder. 송신 포트는 입력 한 URI를 사용 하 여 논리 앱에 .txt 파일을 보냅니다.The send port sends the .txt file to the logic app using the URI you entered. 논리 앱은 파일을 받습니다.Your logic app receive the files. Office 365 Outlook 커넥터를 사용 하는 경우 받는 사람 전자 메일 주소가 샘플 메시지와 함께 전자 메일을 받게 됩니다.If you used the Office 365 Outlook connector, your To email address should receive the email, with the sample message.

다음Next

Logic Apps 정의What are Logic Apps

논리 앱 만들기Create a logic app

BizTalk Server에서 어댑터 사용Using adapters in BizTalk Server