WCF-WebHttp 어댑터

아티클
07/21/2023

Microsoft BizTalk Server WCF-WebHttp 어댑터를 사용하여 RESTful 서비스에 메시지를 보냅니다. WCF-WebHttp 송신 어댑터는 BizTalk 메시지에서 서비스로 HTTP 메시지를 보냅니다. 수신 위치에서는 RESTful 서비스의 메시지를 받습니다. GET 및 DELETE 요청의 경우 어댑터는 아무런 페이로드를 사용하지 않습니다. POST 및 PUT 요청의 경우에는 HTTP 콘텐츠/페이로드에 대한 BizTalk 메시지 본문 부분이 어댑터에서 사용됩니다.

이 항목에서는 BizTalk 관리를 사용하여 수신 위치를 만들고 포트를 보내는 방법을 보여줍니다.

수신 위치 만들기

참고

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

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

일반 탭에서 메시지가 수신되는 REST 인터페이스의 엔드포인트 주소를 구성합니다.

사용 항목	원하는 작업
주소(URI)	필수 사항입니다. BizTalk Server HTTP 기반 RESTful 메시지를 받을 수 있는 URI를 지정합니다.
엔드포인트 ID	선택 사항입니다. 엔드포인트 ID를 지정합니다. 이러한 설정을 통해 엔드포인트가 이 수신 위치를 인증할 수 있습니다. 엔드포인트와 수신 위치 간의 핸드셰이크 프로세스에서 WCF(Windows Communication Foundation) 인프라는 예상되는 서비스의 ID가 이 요소의 값과 일치하는지 확인합니다. 기본값은 빈 문자열입니다.
HTTP 메서드 및 URL 매핑	BTS 작업 매핑을 통해 사용자는 들어오는 HTTP 메서드와 URL 하위 경로를 바탕으로, 들어오는 HTTP 요청을 메시지 컨텍스트의 BTS 작업에 매핑할 수 있습니다. 들어오는 HTTP 메서드와 URL 하위 경로는 일련의 HTTP 메서드와 URI 템플릿 중 일치하는 것이 있는지 비교됩니다. 일치하는 것이 있으면 어댑터는 BTS.Operation 속성을 메시지에 지정된 값과 함께 BizTalk 메시지 컨텍스트로 승격시킵니다. URL 매핑에 대한 HTTP 메서드는 단일 형식이나 다중 매핑 형식으로 지정할 수 있습니다. 다음은 다중 매핑 형식이 사용된 예입니다. `<BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/12345</BtsHttpUrlMapping>` 위의 조각에서 고객 ID는 상수값, 즉 12345로 제공되었습니다. 하지만 고객 ID 또는 기타 쿼리 변수가 런타임에 확인되어야 하는 시나리오가 있을 수 있습니다. 그러한 시나리오가 가능하려면 URL의 변수 구성 요소를 중괄호({ })로 묶어 제공해야 합니다. 예를 들어 위의 조각에서는 고객 ID를 변수로 지정할 때 다음과 같이 지정합니다. `<BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/{ID}</BtsHttpUrlMapping>` 이 경우, 런타임에 변수 ID 의 값을 제공할 속성도 지정해야 합니다. 변수 매핑을 사용하여 지정할 수 있습니다. 참고 URL 필드 내에서 특수 XML 문자는 "이스케이프"되어야 합니다. 이렇게 하면 특수 XML 문자가 처리되고 포트에서 유지됩니다. 예를 들어 특수 문자는 로 `&`이 `&` 스케이프되어야 합니다. 원본: `Url=”/Customer?{ID}& group=Location”` 대상: `Url=”/Customer?{ID}&group=Location”`
변수 매핑	HTTP 메서드 URL 매핑에 변수를 지정한 경우 해당 변수가 런타임에 매핑될 대상을 지정해야 합니다. 편집 단추를 클릭하면 변수 매핑 대화 상자가 실행됩니다. 이 대화 상자의 변수 열에는 HTTP 메서드 및 URL 매핑에 정의된 변수가 나열됩니다. 속성 이름 필드에는 변수와 연관될 값을 제공하는 속성의 이름을 지정해야 합니다. 이 속성은 솔루션의 일부로 이미 정의/승격되어 있어야 합니다. 속성의 네임스페이스도 속성 네임스페이스 필드에 제공해야 합니다.

바인딩 탭에서 시간 제한 및 인코딩 관련 속성을 구성합니다.

사용 항목	원하는 작업
열기 시간 제한(hh:mm:ss)	채널 열기 작업이 완료될 수 있도록 제공되는 시간 간격을 나타내는 시간 범위 값을 지정합니다. 이 값은 System.TimeSpan.Zero보다 크거나 같아야 합니다. 기본값: 00:01:00 최대값: 23:59:59
전송 시간 제한(hh:mm:ss)	송신 작업이 완료될 수 있도록 제공되는 시간 간격을 나타내는 시간 범위 값을 지정합니다. 이 값은 System.TimeSpan.Zero보다 크거나 같아야 합니다. 요청-응답 수신 포트를 사용하는 경우 이 값은 클라이언트가 큰 메시지를 반환하더라도 전체 상호 작용이 완료될 수 있는 시간 범위를 지정합니다. 기본값: 00:01:00 최대값: 23:59:59
닫기 시간 제한(hh:mm:ss)	채널 닫기 작업이 완료될 수 있도록 제공되는 시간 간격을 나타내는 시간 범위 값을 지정합니다. 이 값은 System.TimeSpan.Zero보다 크거나 같아야 합니다. 기본값: 00:01:00 최대값: 23:59:59
최대 수신 메시지 크기(바이트)	유선으로 수신할 수 있는 메시지의 최대 크기(헤더 포함)를 바이트 단위로 지정합니다. 메시지 크기는 각 메시지에 할당된 메모리 용량으로 제한됩니다. 이 속성을 사용하여 Dos(서비스 거부) 공격에 노출될 가능성을 줄일 수 있습니다. WCF-WebHttp 어댑터는 버퍼링된 전송 모드에서 WebHttpBinding 클래스를 이용하여 엔드포인트와 통신합니다. 버퍼링된 전송 모드에서는 WebHttpBinding.MaxBufferSize 속성이 항상 이 속성의 값과 일치합니다. 기본값: 65536 최대값: 2147483647
최대 동시 호출 수	단일 서비스 인스턴스에 대한 동시 호출 수를 지정합니다. 한도를 초과하는 호출은 대기됩니다. 이 값을 0으로 설정하는 것은 Int32.MaxValue로 설정하는 것과 같습니다. 기본값은 200입니다.

보안 탭에서 WCF-WebHttp 수신 위치의 보안 기능을 정의합니다.

사용 항목	원하는 작업
보안 모드	사용할 보안 유형을 지정합니다. 유효한 값은 다음과 같습니다. - 없음: 전송하는 동안 메시지는 보호되지 않습니다. - 전송: HTTPS 전송을 사용하여 보안이 제공됩니다. SOAP 메시지는 HTTPS를 통해 보안이 유지됩니다. 이 모드를 사용하려면 Microsoft IIS(인터넷 정보 서비스)에서 SSL(Secure Sockets Layer)을 설정해야 합니다. - TransportWithMessageCredential: HTTPS 전송에서 무결성, 기밀성 및 서비스 인증을 제공합니다. 이 모드를 사용하려면 Microsoft IIS(인터넷 정보 서비스)에서 SSL(Secure Sockets Layer)을 설정해야 합니다. 기본값은 전송입니다.
전송 클라이언트 자격 증명 유형	클라이언트 인증 수행에 사용할 자격 증명 유형을 지정합니다. 유효한 값은 다음과 같습니다. - 없음: 전송 수준에서 인증이 발생하지 않습니다. - 기본: 기본 인증. 이 인증에서는 사용자 이름과 암호가 네트워크에서 일반 텍스트로 전송됩니다. 자격 증명에 해당하는 도메인 사용자 계정이나 로컬 사용자 계정을 만들어야 합니다. - 다이제스트: 다이제스트 인증. 이 인증 방법은 보안을 강화하기 위해 암호가 해시 값으로 네트워크로 전송된다는 점을 제외하고는 기본 인증과 같습니다. 다이제스트 인증은 Windows Server 운영 체제 인증을 실행하는 도메인 컨트롤러가 있는 도메인에서만 사용할 수 있습니다. 클라이언트 자격 증명에 해당하는 도메인 사용자 계정이나 로컬 사용자 계정을 만들어야 합니다. - Ntlm: NTLM 인증. 클라이언트는 이 수신 위치로 암호를 보내지 않고 자격 증명을 보낼 수 있습니다. 클라이언트 자격 증명에 해당하는 도메인 사용자 계정이나 로컬 사용자 계정을 만들어야 합니다. - Windows: Windows 통합 인증. Windows Communication Foundation은 Kerberos 또는 NTLM 사이에서 협상하며 도메인이 있을 경우 Kerberos를 사용합니다. Kerberos를 사용하려면 클라이언트가 SPN(서비스 사용자 이름)으로 서비스를 식별하도록 해야 합니다. 클라이언트 자격 증명에 해당하는 도메인 사용자 계정이나 로컬 사용자 계정을 만들어야 합니다. - 인증서: 클라이언트 인증서를 사용한 클라이언트 인증입니다. 클라이언트가 이 수신 위치에 대해 인증될 수 있도록 이 컴퓨터의 신뢰할 수 있는 루트 인증 기관 인증서 저장소에 클라이언트 X.509 인증서에 대한 CA 인증서 체인을 설치해야 합니다. 참고전송 클라이언트 자격 증명 형식 속성은 이 수신 위치를 호스팅하는 IIS 가상 디렉터리의 인증 체계와 일치해야 합니다. 예를 들어 이 속성을 Windows로 설정하면 Windows를 호스팅하는 가상 디렉터리에 대해서도 Windows 통합 인증 을 설정해야 합니다. 마찬가지로 이 속성을 없음으로 설정하면 이 수신 위치를 호스트하는 가상 디렉터리에 대한 익명 액세스를 허용해야 합니다. 기본값은 Windows입니다.
서비스 인증서 - 손 도장(Thumbprint)	클라이언트가 서비스 인증에 사용하는 이 수신 위치에 대한 X.509 인증서의 손 도장(Thumbprint)을 지정합니다. 손 도장은 찾아보기 단추로 현재 사용자 위치의 내 저장소 를 탐색하여 선택할 수 있습니다. 참고 이 수신 위치를 호스팅하는 수신 처리기에 대한 사용자 계정의 현재 사용자 위치에 서비스 인증서를 설치해야 합니다. 최소 길이: 0 최대 길이: 40 기본값은 빈 문자열입니다.

동작 탭에서 서비스 수준 및 엔드포인트 수준에서 다른 동작을 지정합니다. 이러한 동작은 .NET Framework 클래스를 기반으로 합니다.

사용 항목	원하는 작업
ServiceBehavior	서비스 수준에서 WCF 서비스의 기능을 확장합니다. 보안 설정 정의, 디버깅 사용, 제한 구현 및 기타 .NET 클래스 사용 등 다양한 작업을 수행하는 확장을 추가할 수 있습니다. ServiceBehavior 및 확장 추가를 마우스 오른쪽에 선택합니다. 목록에는 사용할 수 있는 .NET 클래스가 표시됩니다.
EndpointBehavior	엔드포인트 수준에서 요청을 받는 방법의 진지도를 확장합니다. 브라우저 기반 ASP.NET AJAX 클라이언트에서 HTTP 요청을 수신하고, 트랜잭션에 대한 시간 간격을 지정하고, 메시지를 동기적으로 또는 비동기적으로 수신하도록 선택하고, 다른 .NET 클래스를 사용하는 등 다양한 작업을 수행하는 확장을 추가할 수 있습니다. EndpointBehavior 및 확장 추가를 마우스 오른쪽에서 선택합니다. 목록에는 사용할 수 있는 .NET 클래스가 표시됩니다.

사용 항목

원하는 작업

ServiceBehavior

서비스 수준에서 WCF 서비스의 기능을 확장합니다. 보안 설정 정의, 디버깅 사용, 제한 구현 및 기타 .NET 클래스 사용 등 다양한 작업을 수행하는 확장을 추가할 수 있습니다.

ServiceBehavior 및 확장 추가를 마우스 오른쪽에 선택합니다. 목록에는 사용할 수 있는 .NET 클래스가 표시됩니다.

EndpointBehavior

엔드포인트 수준에서 요청을 받는 방법의 진지도를 확장합니다. 브라우저 기반 ASP.NET AJAX 클라이언트에서 HTTP 요청을 수신하고, 트랜잭션에 대한 시간 간격을 지정하고, 메시지를 동기적으로 또는 비동기적으로 수신하도록 선택하고, 다른 .NET 클래스를 사용하는 등 다양한 작업을 수행하는 확장을 추가할 수 있습니다.

EndpointBehavior 및 확장 추가를 마우스 오른쪽에서 선택합니다. 목록에는 사용할 수 있는 .NET 클래스가 표시됩니다.

이는 WCF-Custom 수신 위치에 대한 동작 구성과 유사합니다. UI 지침 및 개발자 API 네임스페이스 참조에서 WCF-사용자 지정 전송 속성 대화 상자, 수신, 동작 탭을 참조하세요.

메시지 탭에서 SOAP 본문 요소에 대한 데이터 선택을 지정합니다.

사용 항목	원하는 작업
아웃바운드 HTTP 헤더	응답 메시지에 자동 삽입된 HTTP 헤더를 지정합니다(해당하는 경우).
실패 시 위치 사용 안 함	수신 파이프라인 오류 또는 라우팅 오류로 인해 인바운드 처리가 실패하는 수신 위치를 해제할지 여부에 대해서 지정합니다. 기본값은 선택 취소되어 있습니다.
실패 시 요청 메시지 일시 중단	수신 파이프라인 오류 또는 라우팅 오류로 인해 인바운드 처리되지 못한 요청 메시지를 일시 중단할지 여부를 지정합니다. 기본적으로 선택 취소되어 있습니다.
오류에 예외 정보 포함	오류가 발생했을 때 디버깅하기 쉽도록 SOAP 오류를 반환할지 여부를 지정합니다. 기본적으로 선택 취소되어 있습니다.

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

송신 포트 만들기

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

일반 탭에서 메시지가 전송되는 REST 인터페이스에 대한 엔드포인트 주소를 구성합니다.

사용 항목	원하는 작업
주소(URI)	필수 사항입니다. 메시지가 송신되는 REST 인터페이스의 URI를 지정합니다.
엔드포인트 ID	선택 사항입니다. 엔드포인트 ID를 지정합니다. 이러한 설정을 통해 엔드포인트가 이 송신 포트를 인증할 수 있습니다. 엔드포인트와 수신 위치 간의 핸드셰이크 프로세스에서 WCF(Windows Communication Foundation) 인프라는 예상되는 서비스의 ID가 이 요소의 값과 일치하는지 확인합니다. 기본값은 빈 문자열입니다.
HTTP 메서드 및 URL 매핑	BTS 작업 매핑을 통해 사용자는 들어오는 HTTP 메서드와 URL 하위 경로를 바탕으로, 들어오는 HTTP 요청을 메시지 컨텍스트의 BTS 작업에 매핑할 수 있습니다. 들어오는 HTTP 메서드와 URL 하위 경로는 일련의 HTTP 메서드와 URI 템플릿 중 일치하는 것이 있는지 비교됩니다. 일치하는 것이 있으면 어댑터는 BTS.Operation 속성을 메시지에 지정된 값과 함께 BizTalk 메시지 컨텍스트로 승격시킵니다. URL 매핑에 대한 HTTP 메서드는 단일 형식이나 다중 매핑 형식으로 지정할 수 있습니다. 다음은 다중 매핑 형식이 사용된 예입니다. `BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/12345" /> </BtsHttpUrlMapping>` 위의 조각에서 고객 ID는 상수값, 즉 12345로 제공되었습니다. 하지만 고객 ID 또는 기타 쿼리 변수가 런타임에 확인되어야 하는 시나리오가 있을 수 있습니다. 그러한 시나리오가 가능하려면 URL의 변수 구성 요소를 중괄호({ })로 묶어 제공해야 합니다. 예를 들어 위의 조각에서는 고객 ID를 변수로 지정할 때 다음과 같이 지정합니다. `<BtsHttpUrlMapping> <Operation Name = "DelCust" Method="DELETE" Url="/Customer/{ID}" /> </BtsHttpUrlMapping>` 이 경우, 런타임에 변수 ID 의 값을 제공할 속성도 지정해야 합니다. 변수 매핑을 사용하여 지정할 수 있습니다. 참고 URL 필드 내에서 특수 XML 문자는 "이스케이프"되어야 합니다. 이렇게 하면 특수 XML 문자가 처리되고 포트에서 유지됩니다. 예를 들어 특수 문자는 로 `&`이 `&` 스케이프되어야 합니다. 원본: `Url=”/Customer?{ID}& group=Location”` 대상: `Url=”/Customer?{ID}&group=Location”`
변수 매핑	HTTP 메서드 URL 매핑에 변수를 지정한 경우 해당 변수가 런타임에 매핑될 대상을 지정해야 합니다. 편집 단추를 클릭하면 변수 매핑 대화 상자가 실행됩니다. 이 대화 상자의 변수 열에는 HTTP 메서드 및 URL 매핑에 정의된 변수가 나열됩니다. 속성 이름 필드에는 변수와 연관될 값을 제공하는 속성의 이름을 지정해야 합니다. 이 속성은 솔루션의 일부로 이미 정의/승격되어 있어야 합니다. 속성의 네임스페이스도 속성 네임스페이스 필드에 제공해야 합니다.

바인딩 탭에서 시간 제한 및 인코딩 관련 속성을 구성합니다.

사용 항목	원하는 작업
열기 시간 제한(hh:mm:ss)	채널 열기 작업이 완료될 수 있도록 제공되는 시간 간격을 나타내는 시간 범위 값을 지정합니다. 이 값은 System.TimeSpan.Zero보다 크거나 같아야 합니다. 기본값: 00:01:00 최대값: 23:59:59
전송 시간 제한(hh:mm:ss)	송신 작업이 완료될 수 있도록 제공되는 시간 간격을 나타내는 시간 범위 값을 지정합니다. 이 값은 System.TimeSpan.Zero보다 크거나 같아야 합니다. 요청-응답 수신 포트를 사용하는 경우 이 값은 클라이언트가 큰 메시지를 반환하더라도 전체 상호 작용이 완료될 수 있는 시간 범위를 지정합니다. 기본값: 00:01:00 최대값: 23:59:59
닫기 시간 제한(hh:mm:ss)	채널 닫기 작업이 완료될 수 있도록 제공되는 시간 간격을 나타내는 시간 범위 값을 지정합니다. 이 값은 System.TimeSpan.Zero보다 크거나 같아야 합니다. 기본값: 00:01:00 최대값: 23:59:59
최대 수신 메시지 크기(바이트)	유선으로 수신할 수 있는 메시지의 최대 크기(헤더 포함)를 바이트 단위로 지정합니다. 메시지 크기는 각 메시지에 할당된 메모리 용량으로 제한됩니다. 이 속성을 사용하여 Dos(서비스 거부) 공격에 노출될 가능성을 줄일 수 있습니다. WCF-WebHttp 어댑터는 버퍼링된 전송 모드에서 WebHttpBinding 클래스를 이용하여 엔드포인트와 통신합니다. 버퍼링된 전송 모드에서는 WebHttpBinding.MaxBufferSize 속성이 항상 이 속성의 값과 일치합니다. 기본값: 65536 최대값: 2147483647

보안 탭에서 WCF-WebHttp 송신 포트의 보안 기능을 정의합니다.

사용 항목	원하는 작업
보안 모드	사용할 보안 유형을 지정합니다. 유효한 값은 다음과 같습니다. - 없음: 전송하는 동안 메시지는 보호되지 않습니다. - 전송: HTTPS 전송을 사용하여 보안이 제공됩니다. SOAP 메시지는 HTTPS를 통해 보안이 유지됩니다. 서비스 인증서를 통해 송신 포트에 서비스를 인증할 수 있도록 서비스의 X.509 인증서에 대한 CA 인증서 체인을 이 컴퓨터의 신뢰할 수 있는 루트 인증 기관 인증서 저장소에 설치해야 합니다. - TransportWithMessageCredential: HTTPS 전송에서 무결성, 기밀성 및 서비스 인증을 제공합니다. 서비스 인증서를 통해 송신 포트에 서비스를 인증할 수 있도록 서비스의 X.509 인증서에 대한 CA 인증서 체인을 이 컴퓨터의 신뢰할 수 있는 루트 인증 기관 인증서 저장소에 설치해야 합니다. 송신 포트 인증은 SOAP 메시지 보안에서 제공합니다. 기본값은 None(없음)입니다.
전송 클라이언트 자격 증명 유형	클라이언트 인증 수행에 사용할 자격 증명 유형을 지정합니다. 유효한 값은 다음과 같습니다. - 없음: 전송 수준에서 인증이 발생하지 않습니다. - 기본: 기본 인증. 이 인증에서는 사용자 이름과 암호가 네트워크에서 일반 텍스트로 전송됩니다. 자격 증명에 해당하는 도메인 사용자 계정이나 로컬 사용자 계정을 만들어야 합니다. - 다이제스트: 다이제스트 인증. 이 인증 방법은 보안을 강화하기 위해 암호가 해시 값으로 네트워크로 전송된다는 점을 제외하고는 기본 인증과 같습니다. 다이제스트 인증은 Windows Server 운영 체제 인증을 실행하는 도메인 컨트롤러가 있는 도메인에서만 사용할 수 있습니다. 클라이언트 자격 증명에 해당하는 도메인 사용자 계정이나 로컬 사용자 계정을 만들어야 합니다. - Ntlm: NTLM 인증. 클라이언트는 이 수신 위치로 암호를 보내지 않고 자격 증명을 보낼 수 있습니다. 클라이언트 자격 증명에 해당하는 도메인 사용자 계정이나 로컬 사용자 계정을 만들어야 합니다. - Windows: Windows 통합 인증. Windows Communication Foundation은 Kerberos 또는 NTLM 사이에서 협상하며 도메인이 있을 경우 Kerberos를 사용합니다. Kerberos를 사용하려면 클라이언트가 SPN(서비스 사용자 이름)으로 서비스를 식별하도록 해야 합니다. 클라이언트 자격 증명에 해당하는 도메인 사용자 계정이나 로컬 사용자 계정을 만들어야 합니다. - 인증서: 클라이언트 인증서를 사용한 클라이언트 인증입니다. 클라이언트가 이 수신 위치에 대해 인증될 수 있도록 이 컴퓨터의 신뢰할 수 있는 루트 인증 기관 인증서 저장소에 클라이언트 X.509 인증서에 대한 CA 인증서 체인을 설치해야 합니다. 참고:전송 클라이언트 자격 증명 형식 속성은 이 수신 위치를 호스팅하는 IIS 가상 디렉터리의 인증 체계와 일치해야 합니다. 예를 들어 이 속성을 Windows로 설정하면 Windows를 호스팅하는 가상 디렉터리에 대해서도 Windows 통합 인증 을 설정해야 합니다. 마찬가지로 이 속성을 없음으로 설정하면 이 수신 위치를 호스트하는 가상 디렉터리에 대한 익명 액세스를 허용해야 합니다. 기본값은 Windows입니다.
클라이언트 인증서 - 지문	엔드포인트에 대해 이 송신 포트를 인증하는 데 사용할 X.509 인증서의 손 도장(Thumbprint)을 지정합니다. 찾아보기 단추를 사용하여 현재 사용자 위치의 내 저장소로 이동하여 지문을 선택할 수 있습니다. 참고: 이 송신 포트를 호스팅하는 송신 처리기에 대한 사용자 계정의 현재 사용자 위치에 클라이언트 인증서를 설치해야 합니다. 최소 길이: 0 최대 길이: 40 기본값은 빈 문자열입니다.
서비스 인증서 - 손 도장(Thumbprint)	송신 포트에서 메시지를 보낼 엔드포인트를 인증하는 데 사용할 X.509 인증서의 손 도장(Thumbprint)을 지정합니다. 찾아보기 단추를 사용하여 로컬 컴퓨터 위치의 기타 사람 저장소로 이동한 지문을 선택할 수 있습니다. 최소 길이: 0 최대 길이: 40 기본값은 빈 문자열입니다.
사용자 이름 자격 증명	메시지 송신에 사용할 자격 증명을 지정합니다. 편집 단추를 클릭하여 속성을 지정할 수 있습니다. 메시지 클라이언트 자격 증명 유형에 대한 사용자 이름 옵션을 선택한 경우 자격 증명을 설정해야 합니다. 기본값은 Single Sign-On을 사용하지 않음입니다.
ACS 서비스 ID 사용	BizTalk Server 2013 R2 및 BizTalk Server 2013에 적용됩니다. 이 확인란을 선택하고 편집 을 클릭하고 Service Bus로 인증할 다음 값을 제공합니다. 이는 Service Bus 관련 엔터티에 대한 REST 인터페이스를 호출하는 경우에만 필요합니다. - Access Control Service STS Uri – 이를 `https://<Namespace>-sb.accesscontrol.windows.net/`로 설정합니다. 여기서 <네임스페이스는> Service Bus 네임스페이스입니다. - 발급자 이름 – 발급자 이름을 지정합니다. 대개 소유자로 설정합니다. - 발급자 키 – 발급자 키를 지정합니다.
Service Bus 연결 정보	BizTalk Server 2016부터 새로운 기능. Service Bus 네임스페이스의 SAS(공유 액세스 서명) 또는 ACS(Access Control Service)를 사용하도록 선택합니다. 옵션을 선택한 다음 편집 을 선택하여 키 정보를 입력합니다. - 공유 액세스 서명 : 액세스 키 이름 및 액세스 키를 입력합니다. 두 값 모두 Azure Portal 나열됩니다. - Access Control 서비스: STS URI(`https://<yourNamespace>-sb.accesscontrol.windows.net/`), 발급자 이름 및 발급자 키를 입력합니다. SB 메시징 어댑터에 설명된 대로 Windows PowerShell 사용하여 이러한 값을 검색합니다.

동작 탭에서 이 송신 포트에 대한 엔드포인트 동작을 구성합니다.

사용 항목	원하는 작업
EndpointBehavior	엔드포인트 수준에서 요청을 보내는 방법의 진지성을 확장합니다. SOAP 처리 동작을 정의하고, 트랜잭션에 시간 간격을 지정하고, 검색 기능을 제어하고, 다른 .NET 클래스를 사용하는 등 다양한 작업을 수행하는 확장을 추가할 수 있습니다. EndpointBehavior를 마우스 오른쪽에 선택하고 확장 추가를 선택합니다. 목록에는 사용할 수 있는 .NET 클래스가 표시됩니다.

사용 항목

원하는 작업

EndpointBehavior

엔드포인트 수준에서 요청을 보내는 방법의 진지성을 확장합니다. SOAP 처리 동작을 정의하고, 트랜잭션에 시간 간격을 지정하고, 검색 기능을 제어하고, 다른 .NET 클래스를 사용하는 등 다양한 작업을 수행하는 확장을 추가할 수 있습니다.

EndpointBehavior를 마우스 오른쪽에 선택하고 확장 추가를 선택합니다. 목록에는 사용할 수 있는 .NET 클래스가 표시됩니다.

이 구성은 WCF-Custom 송신 포트의 엔드포인트 동작 구성과 비슷합니다. UI 지침 및 개발자 API 네임스페이스 참조에서 WCF-사용자 지정 전송 속성 대화 상자, 보내기, 동작 탭을 참조하세요.

프록시 탭에서 WCF-WebHttp 송신 포트에 대한 프록시 설정을 구성합니다.

사용 항목	원하는 작업
송신 처리기 프록시 설정 사용	송신 포트에서 이 송신 포트를 호스팅하는 송신 핸들러의 프록시 설정을 사용할지 여부를 지정합니다. 이 값은 기본 설정입니다.
프록시 사용 안 함	이 송신 핸들러가 프록시 서버를 사용하는지 여부를 나타냅니다. 기본적으로 선택 취소되어 있습니다.
프록시 사용	이 송신 포트가 Address 속성에 지정된 프록시 서버를 사용하는지 여부를 나타냅니다. 기본적으로 선택 취소되어 있습니다.
주소	프록시 서버의 주소를 지정합니다. 보안 구성에 따라 https 또는 http 체계를 사용합니다. 이 주소 뒤에는 콜론과 포트 번호가 나올 수 있습니다. 예들 들어 `http://127.0.0.1:8080`입니다. 이 속성은 프록시 사용 이 선택된 경우에만 값이 필요합니다. 유형: String 최대 길이: 256 기본값은 빈 문자열입니다.
사용자 이름	인증에 사용할 사용자 이름을 지정합니다. 통합 인증을 사용하는 경우에는 사용자 이름에 도메인이 포함됩니다(예: domain\username). 기본 인증이나 다이제스트 인증을 사용하는 경우에는 사용자 이름에 domain\이 포함되지 않습니다. 이 속성은 프록시 사용 이 선택된 경우에만 값이 필요합니다. 참고: WCF-WebHttp 송신 어댑터는 프록시에 대한 기본 인증을 사용합니다. 유형: String 최소 길이: 0 최대 길이: 256 기본값은 빈 문자열입니다.
암호	인증에 사용할 암호를 지정합니다. 이 속성은 프록시 사용 이 선택된 경우에만 값이 필요합니다. 유형: String 최소 길이: 0 최대 길이: 256 기본값은 빈 문자열입니다.

메시지 탭에서 메시지를 REST 인터페이스로 보내는 방법을 지정합니다.

사용 항목 원하는 작업

아웃바운드 HTTP 헤더 응답 메시지에 자동 삽입된 HTTP 헤더를 지정합니다(해당하는 경우).

본문이 생략될 동사 REST 엔드포인트 호출에 사용되는 동사에 따라 메시지 페이로드가 필요하거나 필요하지 않을 수도 있습니다. 예를 들어 GET 또는 DELETE 동사를 사용할 때는 메시지 페이로드가 필요하지 않습니다. 하지만 송신 포트를 사용하여 REST 엔드포인트에 대한 호출을 트리거하기 위해, 메시지 페이로드가 포함된 dummy 메시지를 사용할 수도 있습니다. 메시지가 REST 엔드포인트에 전송되기 전에 dummy 메시지에서 메시지 페이로드가 제거되어야 합니다. 동사에 대한 본문 표시 안 함 속성을 사용하여 메시지 페이로드를 제거해야 하는 동사를 지정할 수 있습니다.

예를 들어 GET 동사를 사용하는 동안 메시지 페이로드를 제거하려면 이 속성의 값을 로 GET지정합니다.

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

WCF 확장 가져오기

수신 처리기 또는 송신 처리기에서 WCF 확장을 가져옵니다.

BizTalk Server 관리에서 BizTalk Server 관리, BizTalk 그룹, 플랫폼 설정을 차례로 확장한 다음 어댑터를 확장합니다.
WCF-WebHttp를 선택한 다음 수신 또는 송신 처리기를 두 번 선택합니다.
일반 탭에서 속성을 선택합니다.
WCF 확장에서 가져오기를 선택하고 WCF 확장 구성 파일로 이동합니다.

송신 처리기에 프록시 추가

송신 포트 또는 송신 처리기에 프록시를 추가할 수 있습니다. 송신 포트에서 프록시를 추가하는 경우 이 섹션을 건너뜁니다.

BizTalk Server 관리 콘솔에서 BizTalk Server 관리, BizTalk 그룹, 플랫폼 설정을 차례로 확장한 다음 어댑터를 확장합니다.
WCF-WebHttp를 선택한 다음, 송신 처리기를 선택합니다.
어댑터 처리기 속성의 일반 탭에서 속성을 선택합니다.

프록시 탭에서 다음을 수행합니다.

사용 항목	원하는 작업
프록시 사용	이 송신 처리기가 프록시 서버를 사용하는지 여부를 나타냅니다. 기본적으로 선택 취소되어 있습니다.
주소	프록시 서버의 주소를 지정합니다. 보안 구성에 따라 https 또는 http 체계를 사용합니다. 이 주소 뒤에는 콜론과 포트 번호가 나올 수 있습니다. 예: `http://127.0.0.1:8080`. 이 속성은 프록시 사용 이 선택된 경우에만 값이 필요합니다. 유형: String 최대 길이: 256 기본값은 빈 문자열입니다.
사용자 이름	인증에 사용할 사용자 이름을 지정합니다. 통합 인증이나 기본 인증을 사용하는 경우 사용자 이름에 도메인이 포함됩니다(예: domain\username). 다이제스트 인증을 사용하는 경우에는 사용자 이름에 domain\이 포함되지 않습니다. 이 속성은 프록시 사용 이 선택된 경우에만 값이 필요합니다. 유형: String 최소 길이: 0 최대 길이: 256 기본값은 빈 문자열입니다.
암호	인증에 사용할 암호를 지정합니다. 이 속성에는 프록시 사용 이 선택된 경우에만 값이 필요합니다. 유형: String 최소 길이: 0 최대 길이: 256 기본값은 빈 문자열입니다.

모든 대화 상자를 종료할 때까지 확인을 클릭합니다.

참고 항목

SB-Messaging 어댑터

어댑터 사용

WCF 어댑터란?

다음을 통해 공유