다음을 통해 공유

FTP 어댑터 구성

  • 아티클

시작하기 전에

  • FTP 어댑터는 보안 FTP 서버에서 데이터 읽기와 쓰기를 지원합니다. 어댑터는 FTP 서버에서 SSL(Secure Sockets Layer)/TLS(Transport Level Security)를 통한 파일 전송을 지원합니다.
  • FTP 어댑터는 읽기 전용 파일 위치에서 파일 다운로드를 지원합니다.
  • FTP 어댑터는 ASCII 모드에도 원자성 파일 전송을 지원합니다.

FTP 어댑터에 대한 모범 사례 및 권장 사항을 참조하세요.

수신 위치 구성

BizTalk Server 관리 콘솔에서 FTP 수신 위치 어댑터 속성을 설정할 수 있습니다. 속성이 수신 위치에 설정되지 않은 경우 BizTalk Server 관리 콘솔의 기본 수신 처리기 값이 사용됩니다.

참고

다음 절차를 완료하기 전에 수신 포트를 이미 추가해야 합니다. 수신 포트를 만드는 방법을 참조하세요.

  1. BizTalk Server 관리 콘솔에서 BizTalk Server 관리, BizTalk 그룹, 애플리케이션, 수신 위치를 만들 애플리케이션을 차례로 확장합니다.

  1. 왼쪽 창에서 수신 포트 노드를 클릭합니다. 오른쪽 창에서 기존 수신 위치와 연결되거나 새 수신 위치와 연결하려는 수신 포트를 마우스 오른쪽 단추로 클릭한 다음 속성을 클릭합니다.

  2. 수신 포트 속성 대화 상자의 왼쪽 창에서 수신 위치를 선택합니다. 오른쪽 창에서 기존 수신 위치를 두 번 클릭하거나 새로 만들기를 클릭하여 새 수신 위치를 만듭니다.

  3. 수신 위치 속성 대화 상자의 형식 옆의 전송 섹션에서 드롭다운 목록에서 FTP를 선택한 다음 구성을 클릭합니다.

  4. FTP 전송 속성에서 다음을 수행합니다.

    Batch

    사용 항목 원하는 작업
    최대 파일 BizTalk Server 일괄 처리당 최대 파일 수를 지정합니다.

    0은 제한 없음을 나타냅니다.

    기본값: 0
    최대 크기 BizTalk Server 일괄 처리당 최대 바이트 수를 지정합니다.

    0은 제한 없음을 나타냅니다.

    기본값: 0

    방화벽

    사용 항목 원하는 작업
    주소 방화벽 주소(DNS 이름 또는 IP 주소)를 지정합니다.
    모드 어댑터를 FTP 서버에 연결할 때의 모드를 지정합니다.

    유효한 값: 수동 및 활성

    활성 모드에서는 FTP 서버가 FTP 어댑터에서 연 포트에 연결합니다. 수동 모드에서는 FTP 어댑터가 FTP 서버에서 연 포트에 연결합니다. 내부 IP를 사용하고 외부 IP에 연결하는 경우 활성 모드가 작동하지 않을 수 있습니다. 이 경우 FTP를 지원하는 ALG(애플리케이션 계층 게이트웨이)에서 수동 모드 또는 활성 모드를 사용해야 합니다.

    기본값: 활성
    암호 방화벽 암호를 지정합니다.
    포트 방화벽 포트를 지정합니다.

    유효한 값: 1~65535 포함

    기본값: 21
    형식 배포된 방화벽 유형을 지정합니다.

    유효한 값: 없음, 양말 4, 양말 5

    기본값: 없음
    사용자 방화벽의 사용자 이름을 지정합니다.

    FTP

    사용 항목 원하는 작업
    계정 FTP 서버의 계정 이름을 지정합니다. 이 옵션은 더 이상 사용되지 않으며 이 속성을 사용하지 않는 것이 좋습니다.
    가져오기 후 파일을 가져온 후에 실행할 FTP 명령을 지정합니다. 세미콜론(;)으로 명령을 구분합니다.
    가져오기 전 파일을 가져오기 전에 실행할 FTP 명령을 지정합니다. 세미콜론(;)으로 명령을 구분합니다. 참고: QUIT 명령은 GET 파일 전에 지원되지 않습니다.
    오류 임계값 위치 설정을 해제하기 전 BizTalk Server에서 발생할 수 있는 오류 수를 지정합니다.

    기본값: 10
    파일 마스크 파일을 전송할 때 사용할 파일 마스크 필터를 지정합니다.
    폴더 FTP 서버의 폴링 위치를 지정합니다.
    FTP 서버 유형 BizTalk Server 2016부터 새로 시작합니다.

    이 속성을 사용하여 SYST 명령이 필요하지 않은 FTP 서버를 선택합니다. 옵션은 None, AIX, Detect, GXS, MVS, OS400 및 기타입니다.

    None으로 설정하면 SYST 명령이 사용됩니다. OS 유형이 지정된 범주에 맞지 않는 경우 다른 항목이 사용됩니다.

    기본값: 없음
    Log 출력할 로그 파일의 파일 이름을 포함하여 전체 경로를 지정합니다. FTP를 통해 파일을 보내거나 받을 때 오류 상태를 진단하는 데 이 파일을 사용합니다.
    최대 파일 크기 다운로드할 수 있는 최대 파일 크기(MB)를 지정합니다.

    0은 파일 크기에 제한이 없음을 나타냅니다.

    기본값: 100
    암호 FTP 서버에 로그온할 때 사용할 사용자 암호를 지정합니다.
    포트 이 FTP 서버의 포트 주소를 지정합니다.

    기본값: 21
    표현 FTP에서 데이터를 수신하는 방법을 선택합니다.

    유효한 값: 이진 또는 ASCII

    기본값: 이진
    서버 FTP 서버의 이름이나 IP 주소를 지정합니다. 참고: 송신 포트 또는 수신 위치에 대한 URI는 256자를 초과할 수 없습니다.
    SSO 관련 Enterprise Single Sign-On 관련 응용 프로그램을 지정합니다.
    사용자 이름 목록(NLST) 어댑터가 파일을 나열하는 방법을 지정합니다. 시스템 정의 파일 목록 대신 파일 이름을 보려면 이 값을 Yes로 설정합니다.

    기본값: 아니요
    사용자 이름 FTP 서버에 로그온할 때 사용할 사용자 이름을 지정합니다.

    폴링

    사용 항목 원하는 작업
    Delete After Download 어댑터가 파일을 다운로드한 후 FTP 서버에서 파일을 삭제할지 여부를 지정합니다.

    기본값: 예 참고:
    Enable Timestamp Comparison 수정된 타임스탬프를 기반으로 어댑터가 파일을 다시 다운로드할지 여부를 지정합니다. 어댑터가 FTP 서버에 대한 권한을 삭제하지 않은 경우 MDTM(Modification Time) 명령을 통해 파일이 마지막으로 다운로드된 후에 수정되었는지 여부를 확인할 수 있습니다. 이 속성 값에 따라 파일이 다시 다운로드됩니다.

    기본값:참고 없음: FTP 서버가 MDTM을 지원하지 않는 경우 다시 다운로드 간격 속성을 설정합니다. 참고: 이 속성은 다운로드 후 삭제 가 아니요로 설정된 경우에만 적용됩니다.
    간격 이 위치를 폴링하는 간격을 지정합니다. 폴링을 계속하려면 이 값을 0으로 설정합니다.

    기본값: 60
    Redownload Interval 어댑터가 파일을 다시 다운로드하는 간격을 지정합니다. 이 속성은 다운로드 후 삭제 및 타임스탬프 비교 사용 이 모두 아니요로 설정된 경우에만 적용됩니다.

    기본값: -1

    -1은 어댑터가 파일을 다시 다운로드하지 않음을 나타냅니다.

    0은 어댑터가 각 폴링 주기에 파일을 다운로드함을 나타냅니다.
    단위 Interval 및 Redownload Interval 속성에 대한 단위 유형을 지정합니다.

    유효한 값: 초, 분, 시간 및 일

    기본값: 초

    SSL

    사용 항목 원하는 작업
    Client Certificate Hash SSL(Secure Sockets Layer) 협상에 사용해야 할 클라이언트 인증서의 SHA1 해시를 지정합니다.

    이 해시를 기반으로 BizTalk 호스트 인스턴스를 실행하는 사용자 계정의 개인 저장소에서 클라이언트 인증서가 선택됩니다.
    FTPS Connection Mode FTPS 서버에 대한 SSL 연결의 모드를 지정합니다.

    유효한 값: 암시적 또는 명시적

    기본값: 명시적
    데이터 보호 사용 어댑터가 FTPS 서버와 데이터 파일을 주고받을 때 SSL 암호화를 사용해야 할 경우 이 값을 Yes로 지정합니다. 어댑터가 파일을 일반 텍스트로 보내고 받게 하려면 이 값을 No로 지정합니다. 참고: 이 속성은 SSL 사용 속성이 예로 설정된 경우에만 적용됩니다.

    유효한 값: 예 또는 아니요

    기본값: 예
    SSL 사용 FTP 어댑터가 SSL을 사용하여 FTPS 서버와 통신하게 할지 여부를 지정합니다.

    유효한 값: 예 또는 아니요

    기본값: 아니요

    튜닝 매개 변수

    사용 항목 원하는 작업
    Receive Data Timeout 수신 통화가 중단될 때까지의 시간을 밀리초 단위로 지정합니다. 느린 서버로 인해 수신 위치의 응답이 중지되는 것을 방지하는 데 이 속성을 사용합니다.

    기본값: 90000
    임시 폴더 임시 폴더의 위치를 지정합니다. 전송 오류를 복구하는 데 이 위치를 사용합니다.

  5. 확인을 클릭하여 설정을 저장합니다.

  6. 수신 위치 속성 대화 상자에서 적절한 값을 입력하여 수신 위치의 구성을 완료한 다음 확인을 클릭하여 설정을 저장합니다. 수신 위치 속성 대화 상자에 대한 자세한 내용은 수신 위치를 만드는 방법을 참조하세요.

참고

여러 FTP 수신 위치에서 같은 FTP URL을 폴링하도록 구성하지 마십시오. 여러 FTP 수신 위치에서 같은 URL을 동시에 폴링하면 각 수신 위치에서 파일 복사본을 받을 수 있으므로 데이터가 복제될 수 있습니다. 이 동작은 FTP 프로토콜에 대상 URL에서 파일을 읽을 때 파일을 잠그는 규정이 없기 때문에 발생합니다.

FTP 수신 어댑터에 고가용성을 제공하려면 클러스터형 BizTalk 호스트 instance 실행되도록 FTP 수신 어댑터를 구성해야 합니다. 클러스터형 호스트 내에서 어댑터 처리기를 실행하기 위한 고려 사항을 참조하세요.

송신 포트 구성

BizTalk Server 관리 콘솔에서 FTP 송신 포트 어댑터 속성을 설정할 수 있습니다. 송신 포트에 대한 속성이 설정되지 않은 경우 BizTalk Server 관리 콘솔의 기본 송신 처리기 값이 사용됩니다.

  1. BizTalk Server 관리 콘솔에서 새 송신 포트를 만들거나 기존 송신 포트를 두 번 클릭하여 수정합니다. 송신 포트를 만드는 방법을 참조하세요. 모든 송신 포트 옵션을 구성하고 일반 페이지의 전송 섹션에서 형식 옵션에 FTP를 지정합니다.

  2. 일반 페이지의 전송 섹션에서 형식 옆에 있는 구성 단추를 클릭합니다.

  3. FTP 전송 속성에서 다음을 수행합니다.

    방화벽

    사용 항목 원하는 작업
    주소 방화벽 주소(DNS 이름 또는 IP 주소)를 지정합니다.
    모드 어댑터를 FTP 서버에 연결할 모드를 선택합니다.

    유효한 값: 수동 및 활성

    활성 모드에서는 FTP 서버가 FTP 어댑터에서 연 포트에 연결합니다. 수동 모드에서는 FTP 어댑터가 FTP 서버에서 연 포트에 연결합니다. 내부 IP를 사용하고 외부 IP에 연결하는 경우 활성 모드가 작동하지 않을 수 있습니다. 이 경우 FTP를 지원하는 ALG(애플리케이션 계층 게이트웨이)에서 수동 모드 또는 활성 모드를 사용해야 합니다.

    기본값: 활성
    암호 방화벽 암호를 지정합니다.
    포트 방화벽 포트를 지정합니다.

    유효한 값: 1에서 65535까지 포함

    기본값: 21
    형식 배포된 방화벽의 유형을 선택합니다.

    유효한 값: 양말 4, 양말 5, 없음

    기본값: 없음
    사용자 방화벽의 사용자 이름을 지정합니다.

    FTP

    사용 항목 원하는 작업
    계정 선택 사항입니다. FTP 서버의 계정 이름을 지정합니다. 이 옵션과 이 속성을 사용하지 않는 것이 좋습니다.
    넣은 후 파일을 넣은 후에 실행할 FTP 명령을 지정합니다. 세미콜론(;)으로 명령을 구분합니다.
    스토리지 할당 레거시 호스트 시스템에 저장 공간을 할당할지 여부를 지정합니다. 이 옵션은 이전 버전과의 호환을 위해 제공됩니다.

    유효한 값: 아니요 및 예

    기본값: 아니요
    넣기 전 FTP 서버에서 기본값을 변경하는 명령 등과 같이 파일을 넣기 전에 실행할 FTP 명령을 지정합니다. 세미콜론(;)으로 명령을 구분합니다. 열기 명령은 필요하지 않습니다. 참고: QUIT 명령은 PUT 파일 전에 지원되지 않습니다.
    폴더 FTP 서버에서 파일을 이동할 위치를 지정합니다.
    FTP 서버 유형 BizTalk Server 2016부터 새로 시작합니다.

    이 속성을 사용하여 SYST 명령이 필요하지 않은 FTP 서버를 선택합니다. 옵션은 None, AIX, Detect, GXS, MVS, OS400 및 기타입니다.

    None으로 설정하면 SYST 명령이 사용됩니다. OS 유형이 지정된 범주에 맞지 않는 경우 다른 항목이 사용됩니다.

    기본값: 없음
    Log 출력할 로그 파일의 파일 이름을 포함하여 전체 경로를 지정합니다. FTP 어댑터를 통해 파일을 송수신할 때 이 파일을 사용하여 오류 조건을 진단할 수 있습니다.
    암호 FTP 서버에 로그온할 때 사용할 암호를 지정합니다.
    포트 FTP 서버의 포트 주소를 지정합니다.

    기본값: 21
    표현 FTP 어댑터의 데이터 송신 방법(이진 또는 ASCII)을 선택합니다.

    유효한 값: 이진 또는 ASCII

    기본값: binary
    서버 FTP 서버의 이름이나 IP 주소를 지정합니다.
    SSO 관련 Enterprise Single Sign-On 관련 응용 프로그램을 지정합니다.
    대상 파일 이름 파일의 대체 이름을 지정합니다. 기본 이름을 유지하면 전송되는 각 메시지에 고유한 메시지 이름이 지정됩니다.

    기본값: %MessageID%.xml
    사용자 이름 FTP 서버에 로그온할 때 사용할 사용자 이름을 지정합니다.

    SSL

    사용 항목 원하는 작업
    Client Certificate Hash SSL(Secure Sockets Layer) 협상에 사용해야 할 클라이언트 인증서의 SHA1 해시를 지정합니다.

    이 해시를 기반으로 BizTalk 호스트 인스턴스를 실행하는 사용자 계정의 개인 저장소에서 클라이언트 인증서가 선택됩니다.
    FTPS Connection Mode FTPS 서버에 대한 SSL 연결의 모드를 지정합니다.

    유효한 값: 암시적 또는 명시적

    기본값: 명시적
    데이터 보호 사용 어댑터가 FTPS 서버와 데이터 파일을 주고받을 때 SSL 암호화를 사용해야 할 경우 이 값을 Yes로 지정합니다. 어댑터가 파일을 일반 텍스트로 보내고 받게 하려면 이 값을 No로 지정합니다. 참고: 이 속성은 SSL 사용 속성이 예로 설정된 경우에만 적용할 수 있습니다.

    유효한 값: 예 또는 아니요

    기본값: 예
    SSL 사용 FTP 어댑터가 SSL을 사용하여 FTPS 서버와 통신하게 할지 여부를 지정합니다.

    유효한 값: 예 또는 아니요

    기본값: 아니요

    튜닝 매개 변수

    사용 항목 원하는 작업
    연결 제한 서버에서 열 수 있는 최대 동시 FTP 연결 수를 지정합니다. 값 0은 제한이 없음을 의미합니다.

    기본값: 0 참고: 이 속성은 이전 버전의 BizTalk Server 연결 제한을 제어하는 데 사용된 레지스트리 항목을 대체합니다. BizTalk Server 연결 제한을 제어하는 데 사용되는 레지스트리 항목을 무시합니다.
    임시 폴더 FTP 서버의 임시 폴더 위치를 지정합니다. 파일은 먼저 여기로 업로드된 후 대상 FTP 폴더로 이동합니다. 전송 오류가 발생하면 어댑터는 ASCII 전송 모드에서 파일 업로드를 다시 시작하고, 이진 전송 모드가 다시 시작됩니다. 참고: 임시 위치와 FTP 서버의 관련 위치 간에 파일 전송이 원자성인 경우 파일 업로드도 원자성입니다.

  4. 확인을 클릭하고 확인을 다시 클릭하여 설정을 저장합니다.

FTP 어댑터에 필요한 FTP 명령

FTP 어댑터에는 FTP 프로토콜의 제한이 적용되며 소스 또는 대상 FTP 서버에서 특정 FTP 명령을 사용할 수 있어야 합니다.

FTP 어댑터는 FTP 클라이언트로 작동하며 FTP 서버에서 다음 명령을 사용하여 올바르게 작동하도록 요구할 수 있습니다.

명령 수신에 필요 보내기에 필요
SYST ✔

BizTalk Server 2016부터 선택 사항		 ✔

BizTalk Server 2016부터 선택 사항
저장 ✔
RETR ✔
USER ✔ ✔
PASS ✔ ✔
CWD ✔ ✔
QUIT ✔ ✔
포트 ✔ ✔
PASV ✔ ✔
ABOR ✔ ✔
TYPE ✔ ✔
RNFR ✔ ✔
RNTO ✔ ✔
DELE ✔ ✔
PWD ✔ ✔
명단 등록 ✔ ✔
NLST ✔ ✔
NOOP ✔ ✔
APPE ✔
ALLO ✔ ✔
MDTM ✔
AUTH TLS ✔ ✔
PBSZ ✔ ✔
PROT ✔ ✔

이러한 FTP 명령에 대한 자세한 내용은 다음을 참조하세요.

레거시 호스트에서 작동하도록 FTP 어댑터 구성

이 섹션에서는 FTP 어댑터와 메인프레임 컴퓨터 간의 통신을 용이하게 하기 위해 알아야 할 사항에 대해 설명합니다.

참고

MVS 또는 AS400 호스트로 파일을 보낼 때는 임시 폴더 기능을 사용할 수 없습니다. 이 필드에는 내용을 입력할 수 없으며 입력하는 경우 오류가 발생합니다.

중요

다음 정보는 참고용으로 제공되며 AS400 또는 IBM 설명서에 나오는 정보 대신 사용해서는 안 됩니다.

MVS

메인프레임에서 FTP 서버로 파일을 보내려면 메인프레임이 IBM GDG(Generation Data Group)를 지원해야 합니다. 이름 필드에서 각 파일 이름은 대상 파일 이름에 1이 더해져서 지정됩니다(전체 경로는 따옴표로 묶임).

AS400

파일을 AS400 시스템으로/시스템에서 전송할 때는 세 가지 방법으로 파일 이름을 지정하고 파일 경로를 정의합니다.

  • 파일 이름 필드: FTP 서버로 파일을 보낼 때 파일 이름 필드에 파일 이름을 입력합니다. 파일은 라이브러리 파일 시스템에 저장되므로 파일 이름은 AS400 시스템의 파일 명명 규칙을 준수해야 합니다.

  • Quote 명령: Quote 명령을 사용하여 원격 컴퓨터에서 스크립트를 실행합니다. 끝점의 BEFORE GET, BEFORE PUT, After GET 및 After PUT 필드에 Quote 명령을 입력합니다. Quote 명령은 다음 형식으로 입력해야 합니다.

    QUOTE RCMD <command to be run on the remote system>.

  • IFS(통합 파일 시스템) : IFS는 PC 기반 파일의 스토리지를 허용하므로 PC와 동일한 명명 규칙을 허용하는 AS400 시스템의 영역입니다. 기본 라이브러리 파일 시스템 대신 IFS를 사용하려면 입력할 첫 번째 명령은 입니다 quote site namefmt 1. 이 명령은 IFS 명명 규칙을 사용하도록 AS400 시스템에 지시합니다.

기타 유용한 자료

FTP 어댑터 속성 스키마 및 속성

FTP 어댑터에 대한 모범 사례 및 권장 사항

FTP 어댑터