AS2 메시지에 대한 HTTP 헤더 사용자 지정 - AWS Transfer Family
템플릿 개요작동 방식주요 기능구현 세부 정보배포 및 사용

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AS2 메시지에 대한 HTTP 헤더 사용자 지정

거래 파트너에게 AS2 메시지를 보낼 때 특정 요구 사항을 충족하거나 파트너의 AS2 서버 구성과의 호환성을 향상하도록 HTTP 헤더를 사용자 지정해야 할 수 있습니다. 이 AWS CloudFormation 템플릿은 전송되는 AS2 메시지에 대해 사용자 지정 HTTP 헤더를 활성화하는 인프라를 생성합니다 AWS Transfer Family. Amazon API Gateway 및 Lambda 함수가 프록시 역할을 하도록 설정하여 거래 파트너의 AS2 서버에 필요한 헤더를 동적으로 수정할 수 있습니다.

이 템플릿을 사용하여 다음을 수행합니다.

  • 아웃바운드 AS2 메시지에 사용자 지정 HTTP 헤더 추가

  • 기본 헤더 값을 사용자 지정 값으로 재정의

    중요

    기본 헤더 값을 재정의할 때는 전송 실패를 일으킬 수 있으므로 주의해야 합니다. 일부 AS2 헤더가 필요합니다.

  • 특정 헤더 요구 사항이 있는 거래 파트너와의 호환성 보장

템플릿 개요

템플릿은 다음과 같은 주요 구성 요소를 생성합니다.

  • AS2 메시지를 처리하고 전달하는 Lambda 함수

  • Lambda 함수를 노출하는 Amazon API Gateway

  • Lambda 함수에 대한 IAM 역할 및 권한

  • HTTPS 지원을 위한 조건부 리소스

템플릿 파일은 동적 HTTP 헤더 템플릿에서 사용할 수 있습니다.

작동 방식

  1. Amazon API Gateway는 수신 AS2 메시지를 수신합니다 AWS Transfer Family.

  2. 요청은 Lambda 함수로 전달됩니다.

  3. Lambda 함수는 요청을 처리하여 필요에 따라 헤더를 추가하거나 수정합니다.

  4. 그런 다음 수정된 요청이 파트너의 AS2 서버로 전달됩니다.

  5. 파트너 서버의 응답은 Lambda 및 Amazon API Gateway를 통해 반환됩니다 AWS Transfer Family.

주요 기능

  • 동적 헤더 수정: 제목 헤더를 사용자 지정하고 기타 필수 헤더를 추가할 수 있습니다.

  • 프로토콜 지원: HTTP 및 HTTPS 프로토콜 모두에서 작동합니다.

  • 유연한 구성: 파트너 호스트, 포트 및 경로의 사양을 허용합니다.

구현 세부 정보

템플릿은 다음과 같은 주요 구성 요소를 구현합니다.

Lambda 함수

솔루션의 핵심은 다음과 같은 Node.js Lambda 함수입니다.

  • Amazon API Gateway에서 요청을 수신합니다.

  • 구성 및 수신 요청 데이터를 기반으로 헤더를 수정합니다.

  • 수정된 요청을 파트너의 AS2 서버로 전달합니다.

  • HTTP 및 HTTPS 프로토콜 모두 처리

  • 오류 처리 및 로깅 포함

Amazon API Gateway

HTTP API는 다음과 같이 설정됩니다.

  • 수신 AS2 메시지 수신

  • Lambda 함수로 요청 라우팅

  • 에 응답 반환 AWS Transfer Family

템플릿 파라미터

다음과 같이 템플릿 파라미터에 대한 정보를 입력합니다. 이러한 모든 파라미터는 문자열입니다.

  • Environment:이 파라미터는 템플릿이 생성하는 리소스의 이름을 지정하는 데 사용됩니다. 개발 또는 프로덕션 환경을 위한 것인지 여부입니다. 유효한 값은 dev 및 prod입니다.

  • PartnerHost: AS2 파트너 서버의 IP 주소 또는 호스트 이름입니다.

  • PartnerPort: AS2 파트너 서버의 포트 번호입니다. 지정하지 않으면 기본값은 HTTP의 경우 80, HTTPS의 경우 443입니다.

  • PartnerPath: 파트너 서버의 AS2 엔드포인트 경로

  • ProtocolType: AS2 통신에 사용할 프로토콜: 유효한 값은 HTTP 및 HTTPS입니다.

조건부 리소스

HTTPS 지원을 위해 템플릿은 조건부로 다음을 생성합니다.

  • CA 인증서용 Lambda 계층

  • Lambda 함수의 HTTPS별 구성

배포 및 사용

CloudFormation 템플릿을 사용하여 AS2 HTTP 헤더를 사용자 지정하려면

  1. https://console.aws.amazon.com/cloudformation AWS CloudFormation 콘솔을 엽니다.

  2. 왼쪽 탐색 창에서 스택을 선택합니다.

  3. 스택 생성을 선택한 다음 새 리소스 사용(표준)을 선택합니다.

  4. 사전 조건 - 템플릿 준비 섹션에서 기존 템플릿 선택을 선택합니다.

  5. 이 링크인 동적 HTTP 헤더 템플릿을 복사하여 Amazon S3 URL 필드에 붙여 넣습니다.

  6. 다음을 선택합니다.

  7. 파라미터 세부 정보를 정보로 입력합니다. 이는에 자세히 설명되어 있습니다템플릿 파라미터.

  8. 다음을 선택합니다. 스택 옵션 구성페이지에서 다음을 다시 선택합니다.

  9. 생성 중인 스택의 세부 정보를 검토한 다음 스택 생성을 선택합니다.

    참고

    페이지 하단의 기능에서가 AWS Identity and Access Management (IAM) 리소스를 생성할 AWS CloudFormation 수 있음을 확인해야 합니다.

이 AWS CloudFormation 스택을 배포한 후:

  1. 스택 출력에 제공된 Amazon API Gateway 엔드포인트 URL을 기록해 둡니다.

  2. 이 새 Amazon API Gateway 엔드포인트를 사용하도록 기존 AWS Transfer Family 커넥터를 업데이트합니다.

  3. 이제 솔루션은 구성된 대로 헤더를 추가하거나 수정하여 AS2 메시지를 처리합니다.

주의

제목 헤더만 수정하거나 파트너가 명시적으로 예상하는 헤더만 추가합니다. 다른 헤더를 변경하면 전송 실패가 발생할 수 있습니다.