파일 어댑터 구성

아티클
05/04/2023

파일 어댑터를 구성하고, 보안 권장 사항을 읽고, 필요한 권한을 보는 방법입니다.

수신 위치를 만들고 BizTalk Server 관리를 사용하거나 프로그래밍 방식으로 포트를 보낼 수 있습니다. 이 항목에서는 BizTalk Server 관리 콘솔에 중점을 둡니다. 프로그래밍 방식 단계를 보려면 수신 위치 만들기 또는 프로그래밍 방식으로 포트 보내기로 이동합니다.

중요

BizTalk Server 2016부터 파일 어댑터를 사용하여 Azure 파일 공유에 연결할 수 있습니다. Azure Storage 계정은 BizTalk Server 탑재해야 합니다. Windows의 Azure File Storage 시작 에는 탑재 단계가 나열됩니다.

보안 권장 사항

파일 어댑터는 디렉터리에서 BizTalk Server로, BizTalk Server에서 디렉터리로 파일을 전송합니다. 사용자 환경에서 파일 어댑터의 보안 및 배포를 위해서는 다음 지침을 따르는 것이 좋습니다.

경계 네트워크의 파일 공유에 연결할 포트를 열지 마세요. 파일 어댑터는 인트라넷과 같은 신뢰 수준이 높은 환경에서 사용해야 합니다.
수신 위치의 드롭 디렉터리에 강력한 DACL(임의 액세스 제어 목록)을 설정합니다. 예를 들어 파일 수신 위치에서 메시지를 선택하는 디렉터리에 대해 파일 읽기/쓰기/삭제 및 하위 폴더/파일 삭제 권한을 설정하여 권한이 있는 사용자만 이 위치에 메시지를 놓을 수 있도록 해야 합니다.
파일 어댑터를 사용하여 중요한 데이터를 선택할 때는 IPSec(인터넷 프로토콜 보안)을 사용하는 것이 좋습니다.

필요한 사용 권한

어댑터 처리기는 어댑터 처리기에 대해 선택된 호스트 instance 보안 컨텍스트에서 실행됩니다. 호스트 instance BizTalk 관리의 호스트 이름 - 호스트 인스턴스 속성의 속성을 사용합니다Logon. 이 Logon 계정에는 파일 어댑터에서 사용하는 폴더 또는 공유에 대한 특정 권한이 있어야 합니다.

처리기에서 사용하는 호스트 instance 사용자 계정에는 다음 권한이 필요합니다. 는 ✔ 권한이 필요하다는 것을 의미합니다. 빈 항목은 권한이 필요하지 않음을 의미합니다.

사용 권한	수신 핸들러	송신 핸들러
모든 권한	✔ 공유 수준에서(파일 공유에 액세스하는 경우)
폴더 트래버스/파일 실행		✔ 파일 수준에서
폴더 나열/데이터 읽기	✔ 파일 수준에서	✔ 파일 수준에서
특성 읽기		✔ 파일 수준에서
확장된 특성 읽기		✔ 파일 수준에서
파일 만들기/데이터 쓰기		✔ 파일 수준에서
폴더 만들기/데이터 추가		✔ 파일 수준에서
하위 폴더 및 파일 삭제	✔ 파일 수준에서	✔ 파일 수준에서
읽기 권한		✔ 파일 수준에서
변경		✔ 공유 수준에서(파일 공유에 액세스하는 경우)

팁

파일 수준에서 파일 또는 폴더에 대한 고급 권한을 열어 이러한 권한을 확인합니다.

참고

각 호스트는 한 개 수신 핸들러에만 연결할 수 있습니다.

수신 위치 구성

참고

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

BizTalk Server 관리 콘솔에서 BizTalk Server 관리, BizTalk 그룹, 애플리케이션, 수신 위치를 만들려는 애플리케이션을 차례로 확장합니다.
왼쪽 창에서 수신 포트 노드를 클릭합니다. 그런 다음 오른쪽 창에서 기존 수신 위치와 연결되어 있거나 새 수신 위치와 연결하려는 수신 포트를 마우스 오른쪽 단추로 클릭하고 속성을 클릭합니다.
수신 포트 속성 대화 상자의 왼쪽 창에서 수신 위치를 선택하고 오른쪽 창에서 기존 수신 위치를 두 번 클릭하거나 새로 만들기를 클릭하여 새 수신 위치를 만듭니다.
수신 위치 속성 대화 상자의 전송 섹션에서 드롭다운 목록에서 FILE 형식을 선택한 다음 구성을 클릭하여 수신 위치에 대한 전송 속성을 구성합니다.

일반 탭에서 다음을 수행합니다.

사용 항목	원하는 작업
수신 폴더	필수 사항입니다. 파일 수신 처리기가 파일을 읽는 파일 시스템, 네트워크 공유 또는 Azure 파일 공유의 폴더 경로를 입력합니다. 수신 폴더 텍스트 상자에 직접 경로를 입력하거나 찾아보기 단추를 사용하여 파일 시스템에서 해당 경로를 선택할 수 있습니다. 폴더를 검색할 때 새 폴더 만들기를 사용하여 새 폴더를 만들 수도 있습니다. Azure File Storage 공유를 사용하는 경우 를 입력합니다 `\\yourfilestoragename.file.core.windows.net\yourfilesharename`. 형식: 문자열 참고:Receive 폴더 속성을 기호 링크가 있는 NT 분산 파일 시스템을 사용하는 폴더로 설정하지 마세요. NT 분산 파일 시스템을 사용하는 경우 파일 어댑터 수신 위치에서 직선 네트워크 경로가 있는 폴더만 사용할 수 있습니다. 이 속성에 대한 제한 사항은 파일 어댑터를 구성할 때의 제한을 참조하세요. 참고: 송신 포트 또는 수신 위치의 URI는 256자를 초과할 수 없습니다.
파일 마스크	필수 사항입니다. 파일에 대한 마스크를 지정합니다. 이 마스크는 표준 와일드카드 값 ""를 포함할 수 있습니다. 기본값:* .xml 형식:* 문자열 이 속성에 대한 제한 사항은 파일 어댑터를 구성할 때의 제한을 참조하세요.
공용 주소	이 위치의 공용 주소를 지정합니다. BizTalk Server는 이 주소를 외부 파트너에게 노출합니다. 이 속성을 지정하지 않으면 런타임 엔진은 이 주소를 다음 주소로 바꿉니다. < file:// Receive 폴더>/<파일 마스크> 이 속성 값에는 어댑터 전위가 필요합니다. 형식: 문자열 최소 길이: 0 최대 길이: 256
재시도 횟수	네트워크 공유에 있는 수신 위치를 일시적으로 액세스할 수 없는 경우 수신 위치에 대한 액세스 시도 횟수를 지정합니다. 기본값: 5 형식: 긴 최소값: 0 최대값: MAX_LONG
재시도 간격(분)	네트워크 공유에 있는 수신 위치를 일시적으로 액세스할 수 없는 경우 수신 위치에 대한 액세스 재시도 간격(분)을 지정합니다. 기본값: 5분 형식: 긴 최소값: 0 최대값: MAX_LONG

인증 탭에서 다음을 수행합니다.

사용 항목	원하는 작업
호스트에서 네트워크 공유에 액세스할 수 없을 때 이 자격 증명 사용	네트워크 공유 또는 Azure 파일 공유를 사용하는 경우에만 필요합니다. 기본값: False 형식: 부울
사용자 이름	네트워크 공유를 사용하는 경우 공유에 액세스할 수 있는 사용자 이름을 입력합니다. Azure 파일 스토리지 공유를 사용하는 경우 스토리지 계정의 이름을 입력합니다. 형식: 문자열 참고: 동일한 네트워크 공유에 매핑된 여러 수신 위치가 대체 자격 증명으로 구성된 경우 모든 수신 위치에 동일한 자격 증명을 사용해야 합니다. Windows에서 자격 증명 집합을 여러 개 사용하는 경우 동일한 컴퓨터에서 공유 네트워크 서버에 대한 연결을 여러 개 만들 수 없습니다.
암호	네트워크 공유를 사용하는 경우 네트워크 공유에 액세스할 수 있는 계정의 암호를 입력합니다. Azure 파일 스토리지 공유를 사용하는 경우 스토리지 계정 액세스 키를 입력합니다. Azure Portal 나열됩니다. 형식: 문자열

일괄 처리 탭에서 다음을 수행합니다.

사용 항목	원하는 작업
일괄 처리의 메시지 개수	일괄로 전송될 최대 메시지 수를 지정합니다. 기본값: 5 형식: Int 최소값: 1 최대값: 256
최대 일괄 처리 크기(바이트)	일괄 처리당 최대 총 바이트 수를 지정합니다. 기본값: 102400 형식: Int 최소값: 1024 최대값: MAX_LONG

파일 어댑터는 최대 메시지 수 또는 허용되는 최대 바이트 수 중에서 먼저 도달하는 값으로 일괄 처리를 제한합니다.

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

송신 포트 구성

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

일반 탭에서 다음을 수행합니다.

사용 항목	원하는 작업
대상 위치	필수 사항입니다. 파일 시스템, 공용 공유 또는 Azure 파일 공유의 위치 경로를 입력하여 출력 메시지를 작성합니다. 경로는 대상 위치에 직접 입력하거나 찾아보기 단추를 사용하여 파일 시스템에서 선택할 수 있습니다. 폴더 찾아보기 대화 상자에서 폴더를 검색할 때 새 폴더 만들기를 클릭하여 새 폴더를 만들 수도 있습니다. Azure 파일 스토리지 공유를 사용하는 경우 를 입력합니다 `\\yourfilestoragename.file.core.windows.net\yourfilesharename`. 형식: 문자열 참고: 송신 포트 또는 수신 위치의 URI는 256자를 초과할 수 없습니다.
파일 이름	파일 송신 핸들러가 메시지를 쓸 파일의 이름을 지정합니다. 파일 이름에 매크로 사용을 포함하여 이 속성에 대한 제한 사항은 파일 어댑터를 구성할 때의 제한을 참조하세요.
복사 모드	파일에 메시지를 쓸 때 사용할 복사 모드를 정의합니다. 유효한 값은 다음과 같습니다. Append. 파일이 있으면 파일 송신 핸들러가 파일을 연 다음 파일 끝에 메시지를 추가합니다. 파일이 없으면 파일 송신 핸들러가 파일을 새로 만듭니다. 덮어쓰기. 파일이 있으면 파일 송신 핸들러가 파일을 연 다음 내용을 덮어씁니다. 파일이 없으면 파일 송신 핸들러가 파일을 새로 만듭니다. 새로 만듭니다. 파일이 없으면 파일 송신 핸들러가 파일을 새로 만든 다음 새 파일에 씁니다. 파일이 이미 있으면 파일 송신 핸들러가 오류를 보고한 다음 송신 포트에 대한 일반적인 어댑터 재전송 작업을 수행합니다. 이 값은 파일 송신 핸들러의 기본 복사 모드입니다.
쓰기 중 캐시 허용	파일에 메시지를 쓸 때 파일 시스템 캐싱 사용 여부를 정의합니다. 유효한 옵션은 다음과 같습니다. False 파일 시스템 캐시를 사용하지 마세요. 사실 파일 시스템 캐시를 사용합니다. 기본값: False 중요: 이 속성을 True 로 설정하면 전원이 손실되고 모든 데이터가 디스크에 기록되지 않을 때 데이터가 손실될 위험이 있는 파일 어댑터의 성능이 향상될 수 있습니다.
쓰는 동안 임시 파일 사용	먼저 출력 파일을 임시 파일로 작성한 다음 쓰기 작업이 완료되면 파일 이름을 바꿀지 여부를 정의합니다. 이 옵션을 사용하도록 설정하면 BTS-WIP 확장자를 사용하여 임시 파일이 만들어집니다. 유효한 옵션은 다음과 같습니다. 사실 파일 어댑터는 대상 폴더에 쓸 때 임시 파일을 만듭니다. False 파일 어댑터는 대상 폴더에 쓸 때 임시 파일을 만들지 않습니다. 기본값: False Note: 이 옵션은 CopyMode 속성이 새로 만들기 값으로 설정된 경우에만 사용할 수 있습니다.

인증 탭에서 다음을 수행합니다.

사용 항목	원하는 작업
호스트에서 네트워크 공유에 액세스할 수 없을 때 이 자격 증명 사용	네트워크 공유 또는 Azure 파일 공유를 사용하는 경우에만 필요합니다. 기본값: False 형식: 부울
사용자 이름	네트워크 공유를 사용하는 경우 공유에 액세스할 수 있는 사용자 이름을 입력합니다. Azure 파일 스토리지 공유를 사용하는 경우 스토리지 계정의 이름을 입력합니다. 형식: 문자열
암호	네트워크 공유를 사용하는 경우 네트워크 공유에 액세스할 수 있는 계정의 암호를 입력합니다. Azure 파일 스토리지 공유를 사용하는 경우 스토리지 계정 액세스 키를 입력합니다. Azure Portal 나열됩니다. 형식: 문자열

확인을 선택하여 설정을 저장합니다.

동적 송신 포트에 대한 속성 설정

동적 송신 포트는 BizTalk Server 관리 콘솔에서 전송 구성 옵션을 제공하지 않습니다. 이러한 속성은 메시지와 연결된 컨텍스트 속성을 통해 제공되어야 하기 때문입니다. 사용자 지정 파이프라인 또는 오케스트레이션에서 이러한 속성을 설정할 수 있습니다. 오케스트레이션에서 메시지 구성 속성을 설정하려면 다음을 수행할 수 있습니다.

오케스트레이션에 생성 메시지 셰이프를 추가합니다.
새 메시지를 생성하도록 메시지 생성 셰이프를 구성합니다. 새 메시지를 생성합니다.
메시지 생성 셰이프에 메시지 할당 셰이프를 추가합니다.
메시지 할당 셰이프에 코드를 추가하여 생성한 메시지를 초기화하고 메시지에 대한 적절한 구성 속성을 설정합니다. 다음 코드는 생성 메시지 셰이프를 사용하여 생성된 Message_2 라는 메시지를 초기화한 다음 메시지에 대한 두 가지 구성 속성을 설정합니다. 이 시나리오에서 Message_1은 원래 오케스트레이션에서 받은 메시지입니다.
```
Message_2=Message_1;  
Message_2(FILE.CopyMode)= 0; //0=Append  
Message_2(FILE.AllowCacheOnWrite)= true;  
Message_2(FILE.UseTempFileOnWrite)= true;  
```

수신 또는 송신 처리기 구성

BizTalk Server 관리 콘솔에서 BizTalk Server 관리, BizTalk 그룹, 플랫폼 설정을 차례로 확장한 다음 어댑터를 클릭합니다.
확장된 어댑터 목록에서 파일을 클릭하고 오른쪽 창에서 구성하려는 수신 또는 송신 처리기를 마우스 오른쪽 단추로 클릭합니다. 속성을 선택합니다.
호스트 이름 목록에서 처리기를 실행할 호스트를 선택합니다.
확인을 클릭합니다.