엔터프라이즈 통합 팩이 포함된 Azure Logic Apps에서 B2B 엔터프라이즈 통합용 AS2 메시지 교환Exchange AS2 messages for B2B enterprise integration in Azure Logic Apps with Enterprise Integration Pack

중요

원래 AS2 커넥터는 사용 되지 않으므로 추적 기능이 필요 하지 않는 한 AS2 (v2) 커넥터를 대신 사용 합니다.The original AS2 connector is being deprecated, so unless you need tracking capabilities, use the AS2 (v2) connector instead. 추적을 제외 하 고, v2 커넥터는 원래 버전과 동일한 기능을 제공 하 고, Logic Apps 런타임의 기본 기능을 제공 하며, 메시지 크기, 처리량 및 대기 시간에 상당한 성능 향상을 제공 합니다.Except for tracking, the v2 connector provides the same capabilities as the original version, is native to the Logic Apps runtime, and has significant performance improvements in message size, throughput, and latency. 또한 v2 커넥터를 사용할 경우 통합 계정에 대 한 연결을 만들 필요가 없습니다.Also, the v2 connector doesn't require that you create a connection to your integration account. 대신, 필수 구성 요소에 설명 된 대로 커넥터를 사용 하려는 논리 앱에 통합 계정을 연결 해야 합니다.Instead, as described in the prerequisites, make sure that you link your integration account to the logic app where you plan to use the connector.

Azure Logic Apps에서 AS2 메시지를 사용 하려면 as2 (버전 1.2) 통신을 지원 하 고 관리 하는 트리거 및 작업을 제공 하는 AS2 커넥터를 사용할 수 있습니다.To work with AS2 messages in Azure Logic Apps, you can use the AS2 connector, which provides triggers and actions that support and manage AS2 (version 1.2) communication. 예를 들어 메시지를 전송할 때 보안 및 안정성을 설정 하려면 다음 작업을 사용할 수 있습니다.For example, to establish security and reliability when transmitting messages, you can use these actions:

  • 비 거부를 지 원하는 MDN (메시지 처리 알림)을 통해 암호화, 디지털 서명 및 승인을 제공 하기 위한 AS2 인코딩 동작 입니다.AS2 Encode action for providing encryption, digital signing, and acknowledgments through Message Disposition Notifications (MDN), which help support non-repudiation. 예를 들어이 작업은 AS2/HTTP 헤더를 적용 하 고 구성 될 때 이러한 작업을 수행 합니다.For example, this action applies AS2/HTTP headers and performs these tasks when configured:

    • 보내는 메시지에 서명 합니다.Signs outgoing messages.
    • 나가는 메시지를 암호화 합니다.Encrypts outgoing messages.
    • 메시지를 압축 합니다.Compresses the message.
    • MIME 헤더의 파일 이름을 전송 합니다.Transmits the file name in the MIME header.
  • MDN (메시지 처리 알림)을 통해 암호 해독, 디지털 서명 및 승인을 제공 하기 위한 AS2 디코드 동작 입니다.AS2 Decode action for providing decryption, digital signing, and acknowledgments through Message Disposition Notifications (MDN). 예를 들어이 작업은 다음 작업을 수행 합니다.For example, this action performs these tasks:

    • AS2/HTTP 헤더를 처리 합니다.Processes AS2/HTTP headers.
    • 수신 된 Mdn를 원래 아웃 바운드 메시지와 조정 합니다.Reconciles received MDNs with the original outbound messages.
    • 부인 방지 데이터베이스에서 레코드를 업데이트 하 고 상관 관계를 합니다.Updates and correlates records in the non-repudiation database.
    • AS2 상태 보고에 대 한 레코드를 씁니다.Writes records for AS2 status reporting.
    • 페이로드 콘텐츠를 b a s e 64로 인코딩된로 출력 합니다.Outputs payload contents as base64-encoded.
    • Mdn가 필요한 지 여부를 결정 합니다.Determines whether MDNs are required. AS2 규약을 기반으로 Mdn이 동기 인지 비동기 인지 결정 합니다.Based on the AS2 agreement, determines whether MDNs should be synchronous or asynchronous.
    • AS2 규약에 따라 동기 또는 비동기 Mdn 생성 합니다.Generates synchronous or asynchronous MDNs based on the AS2 agreement.
    • Mdn의 상관 관계 토큰과 속성을 설정 합니다.Sets the correlation tokens and properties on MDNs.

    또한이 작업은 구성 될 때 다음 작업을 수행 합니다.This action also performs these tasks when configured:

    • 서명을 확인합니다.Verifies the signature.
    • 메시지의 암호를 해독 합니다.Decrypts the messages.
    • 메시지의 압축을 풉니다.Decompresses the message.
    • 메시지 ID 중복을 확인 하 고 허용 하지 않습니다.Check and disallow message ID duplicates.

이 문서에서는 기존 논리 앱에 AS2 인코딩 및 디코딩 작업을 추가 하는 방법을 보여 줍니다.This article shows how to add the AS2 encoding and decoding actions to an existing logic app.

필수 구성 요소Prerequisites

  • Azure 구독An Azure subscription. 아직 Azure 구독이 없는 경우 체험 Azure 계정에 등록합니다.If you don't have an Azure subscription yet, sign up for a free Azure account.

  • AS2 커넥터를 사용 하려는 논리 앱 및 논리 앱의 워크플로를 시작 하는 트리거The logic app from where you want to use the AS2 connector and a trigger that starts your logic app's workflow. AS2 커넥터는 트리거가 아니라 동작만 제공 합니다.The AS2 connector provides only actions, not triggers. 논리 앱을 처음 접하는 경우 Azure Logic Apps란?빠른 시작: 첫 번째 논리 앱 만들기를 검토하세요.If you're new to logic apps, review What is Azure Logic Apps and Quickstart: Create your first logic app.

  • Azure 구독과 연결 되 고 AS2 커넥터를 사용 하려는 논리 앱에 연결 된 통합 계정 입니다.An integration account that's associated with your Azure subscription and linked to the logic app where you plan to use the AS2 connector. 논리 앱과 통합 계정이 동일한 위치 또는 Azure 지역에 있어야 합니다.Both your logic app and integration account must exist in the same location or Azure region.

  • AS2 id 한정자를 사용 하 여 통합 계정에 이미 정의 된 두 개 이상의 거래 업체At least two trading partners that you've already defined in your integration account by using the AS2 identity qualifier.

  • AS2 커넥터를 사용 하려면 먼저 거래 업체 간에 AS2 규약 을 만들고 통합 계정에 해당 규약을 저장 해야 합니다.Before you can use the AS2 connector, you must create an AS2 agreement between your trading partners and store that agreement in your integration account.

  • 인증서 관리에 Azure Key Vault 를 사용 하는 경우 자격 증명 모음 키에서 암호화암호 해독 작업을 허용 하는지 확인 합니다.If you use Azure Key Vault for certificate management, check that your vault keys permit the Encrypt and Decrypt operations. 그렇지 않으면 인코딩 및 디코딩 작업이 실패 합니다.Otherwise, the encoding and decoding actions fail.

    Azure Portal에서 키 자격 증명 모음의 키로 이동 하 고, 키의 허용 된 작업 을 검토 하 고, 암호화암호 해독 작업이 선택 되었는지 확인 합니다. 예를 들면 다음과 같습니다.In the Azure portal, go to the key in your key vault, review your key's Permitted operations, and confirm that the Encrypt and Decrypt operations are selected, for example:

    자격 증명 모음 키 작업 확인

AS2 메시지 인코딩Encode AS2 messages

  1. 아직 Azure Portal하지 않은 경우 논리 앱 디자이너에서 논리 앱을 엽니다.If you haven't already, in the Azure portal, open your logic app in the Logic App Designer.

  2. 디자이너에서 논리 앱에 새 작업을 추가 합니다.In the designer, add a new action to your logic app.

  3. 작업 선택 및 검색 상자 아래에서 모두 를 선택합니다.Under Choose an action and the search box, select All. 검색 상자에 "as2 인코드"를 입력 하 고 AS2 (v2) 작업을 선택 했는지 확인 합니다. As2 인코드In the search box, enter "as2 encode", and make sure that you select the AS2 (v2) action: AS2 Encode

    "AS2 인코드"를 선택 합니다.

  4. 이제 이러한 속성에 대 한 정보를 제공 합니다.Now provide information for these properties:

    속성Property 설명Description
    인코딩할 메시지Message to encode 메시지 페이로드The message payload
    AS2 원본AS2 from AS2 규약에서 지정한 메시지 보낸 사람의 식별자입니다.The identifier for the message sender as specified by your AS2 agreement
    AS2 toAS2 to AS2 규약에서 지정한 메시지 수신기의 식별자입니다.The identifier for the message receiver as specified by your AS2 agreement

    예를 들면 다음과 같습니다.For example:

    메시지 인코딩 속성

서명 되거나 암호화 된 메시지를 보낼 때 문제가 발생 하면 다른 SHA256 알고리즘 형식을 사용해 보세요.If you experience problems when sending signed or encrypted messages, consider trying different SHA256 algorithm formats. AS2 사양은 SHA256 형식에 대 한 정보를 제공 하지 않으므로 각 공급자는 고유한 구현 또는 형식을 사용 합니다.The AS2 specification doesn't provide any information about SHA256 formats, so each provider uses their own implementation or format.

AS2 메시지 디코딩Decode AS2 messages

  1. 아직 Azure Portal하지 않은 경우 논리 앱 디자이너에서 논리 앱을 엽니다.If you haven't already, in the Azure portal, open your logic app in the Logic App Designer.

  2. 디자이너에서 논리 앱에 새 작업을 추가 합니다.In the designer, add a new action to your logic app.

  3. 작업 선택 및 검색 상자 아래에서 모두 를 선택합니다.Under Choose an action and the search box, select All. 검색 상자에 "as2 디코드"를 입력 하 고 AS2 (v2) 작업: As2 디코딩 을 선택 했는지 확인 합니다.In the search box, enter "as2 decode", and make sure that you select the AS2 (v2) action: AS2 Decode

    "AS2 디코드"를 선택 합니다.

  4. 인코딩할 메시지메시지 헤더 속성에 대해 이전 트리거 또는 작업 출력에서 이러한 값을 선택 합니다.For the Message to encode and the Message headers properties, select these values from previous trigger or action outputs.

    예를 들어 논리 앱에서 요청 트리거를 통해 메시지를 수신 한다고 가정 합니다.For example, suppose your logic app receives messages through a Request trigger. 해당 트리거에서 출력을 선택할 수 있습니다.You can select the outputs from that trigger.

    요청 출력에서 본문 및 헤더를 선택합니다.

샘플Sample

완벽하게 작동하는 논리 앱 및 샘플 AS2 시나리오를 배포하려면 AS2 논리 앱 템플릿 및 시나리오를 참조하세요.To try deploying a fully operational logic app and sample AS2 scenario, see the AS2 logic app template and scenario.

커넥터 참조Connector reference

커넥터의 Swagger 파일에 설명 된 작업 및 제한과 같이이 커넥터에 대 한 자세한 기술 정보는 커넥터의 참조 페이지를 참조 하세요.For more technical details about this connector, such as actions and limits as described by the connector's Swagger file, see the connector's reference page.

참고

이 커넥터의 ISE 레이블이 지정된 버전은 ISE(통합 서비스 환경)의 논리 앱에는 ISE에 대한 B2B 메시지 제한을 사용합니다.For logic apps in an integration service environment (ISE), this connector's ISE-labeled version uses the B2B message limits for ISE.

다음 단계Next steps