Share via

WCF 어댑터란?

  • 아티클

WCF(Windows Communication Foundation) 어댑터에는 수신 어댑터와 송신 어댑터의 두 가지가 있습니다. WCF 수신 어댑터를 사용하여 WCF 서비스 요청을 받을 수 있습니다. WCF 수신 어댑터는 요청을 받고, BizTalk 메시지 개체를 만들고, 연결된 속성을 메시지 컨텍스트로 승격합니다. WCF 송신 어댑터를 사용하여 WCF 서비스를 호출할 수 있습니다. WCF 송신 어댑터는 형식이 없는 계약을 통해 WCF 서비스를 호출합니다.

참고

WCF 어댑터는 RPC(원격 프로시저 호출) 유형 웹 서비스의 사용을 지원하지 않습니다. RPC 유형 웹 서비스의 메시지 파트는 WCF 어댑터에서 해당 메시지 파트에 대한 요소를 사용하는 경우 메시지 요소 대신 메시지 유형을 참조하기 때문입니다. BizTalk 프로젝트에서 웹 서비스를 사용하려면 웹 참조 추가 마법사를 통해 RPC 유형 웹 서비스를 추가하는 것이 좋습니다.

웹 서비스 표준 지원

WCF 어댑터는 WS-Addressing, WS-Security 및 WS-AtomicTransaction과 같은 WS-* 표준에 대한 지원을 제공합니다. WS-ReliableMessaging은 이 릴리스의 WCF 어댑터에서 지원되지 않습니다. WCF에서 지원하는 사양 목록은 을 참조하세요 https://go.microsoft.com/fwlink/?LinkId=88314.

WS-Addressing

WCF 어댑터는 WCF에서 제공하는 WS-Addressing 표준 지원을 사용합니다. WCF 어댑터에서 사용할 수 있는 기능은 다음과 같습니다.

  • 메타데이터 교환 요청 중에 가져온 송신 포트 엔드포인트 주소 구성

  • 송신 포트 엔드포인트 주소에 대한 주소 지정 헤더 구성

  • BizTalk 수신 위치에서 노출된 엔드포인트에 대한 주소 지정 헤더 구성

WS-Security

WCF 어댑터는 WCF에서 제공하는 보안 표준 지원을 사용합니다. WCF 어댑터에서 지원되는 표준은 다음과 같습니다.

  • 웹 서비스 보안: SOAP 메시지 보안(WS-Security) 1.0 및 1.1

  • Web Services Secure Conversation Language(WS-SecureConversation)

  • Web Services Trust Language(WS-Trust)

  • Web Services Security X.509 Certificate Token Profile

  • Web Services Security Username Token Profile 1.0

  • Web Services Security Kerberos Token Profile 1.0

서비스 인증 유형

지원되는 WCF 서비스 인증 유형은 다음과 같습니다.

  • 없음

  • Windows

  • 인증서

클라이언트 인증 유형

지원되는 WCF 클라이언트 인증 유형은 다음과 같습니다.

  • 익명

  • UserName

  • Windows

  • 인증서

보안 모드

지원되는 보안 모드는 다음과 같습니다.

  • 전송

  • 메시지

  • 혼합(전송 수준 보안과 메시지 수준 인증)

WS-AtomicTransaction

WCF-WsHttp, WCF-NetTcp 및 WCF-NetMsmq 어댑터는 WS-AtomicTransaction 프로토콜을 지원합니다. 이 지원은 다음 시나리오에서 허용됩니다.

  • 메시지를 MessageBox 데이터베이스로 트랜잭션 전송

  • 메시지를 MessageBox에서 트랜잭션 대상으로 트랜잭션 전송

참고

트랜잭션 범위는 MessageBox에 따라 제한됩니다. 예를 들어 BizTalk 오케스트레이션은 클라이언트의 트랜잭션에 참여할 수 없습니다. 마찬가지로 대상 엔드포인트는 BizTalk 오케스트레이션에서 시작되는 트랜잭션에 참여할 수 없습니다.

트랜잭션 전송

WCF-WsHttp 및 WCF-NetTcp 어댑터의 경우 수신 위치 전송 속성 대화 상자에서 트랜잭션 검사 사용 상자를 선택하여 BizTalk Server 트랜잭션 제출을 사용할 수 있습니다. WCF-NetMsmq 어댑터의 경우 트랜잭션 검사 상자가 기본적으로 선택되어 있습니다. 메시지를 끌어오는 메시지 큐가 트랜잭션으로 표시되지 않은 경우에는 이 확인란의 선택을 취소해야 합니다. 그러지 않으면 오류 메시지가 나타납니다.

트랜잭션 기능이 설정된 경우에는 클라이언트의 트랜잭션을 사용하여 MessageBox 데이터베이스로 메시지가 전송됩니다. 이 경우 클라이언트에서 트랜잭션 범위 외부에 있는 메시지를 전송하려고 하면 어댑터에서 클라이언트로 예외를 다시 반환합니다. 그러나 일시 중단되는 메시지는 없습니다. 트랜잭션 기능이 해제된 경우에는 클라이언트의 트랜잭션을 사용하지 않고 MessageBox 데이터베이스로 메시지가 전송됩니다. 이 경우 클라이언트에서 트랜잭션 범위 내에 있는 메시지를 전송하려고 하면 어댑터에서 클라이언트로 예외를 다시 반환합니다. 마찬가지로 일시 중단되는 메시지는 없습니다.

트랜잭션 및 수신 위치 유형

트랜잭션 전송은 단방향 수신 위치에만 사용할 수 있습니다. 클라이언트에서 양방향 수신 위치에 대해 트랜잭션 범위 내에 있는 메시지를 전송하려고 하면 클라이언트로 예외가 다시 반환됩니다. 이 경우 일시 중단되는 메시지는 없습니다.

트랜잭션 전송

WCF-WsHttp 및 WCF-NetTcp 어댑터의 경우 송신 포트 전송 속성 대화 상자에서 트랜잭션 검사 사용 상자를 선택하여 BizTalk Server 트랜잭션 전송을 사용하도록 설정합니다. WCF-NetMsmq 어댑터의 경우 트랜잭션 검사 상자가 기본적으로 선택되어 있습니다. 메시지를 보내는 대상 메시지 큐가 트랜잭션으로 표시되지 않은 경우에는 이 확인란의 선택을 취소해야 합니다. 그러지 않으면 오류 메시지가 나타납니다.

트랜잭션 기능이 설정된 경우에는 트랜잭션에 따라 MessageBox 데이터베이스에서 메시지가 전송되고 삭제됩니다. 대상 서비스가 메시지를 받은 후 작업을 수행했는데도 MessageBox에서 메시지가 삭제되지 않으면 트랜잭션이 중단되고 해당 서비스의 모든 트랜잭션 작업이 롤백됩니다. 트랜잭션 기능이 해제된 경우에는 트랜잭션을 사용하지 않고 MessageBox 데이터베이스에서 메시지가 전송되고 삭제됩니다.

Single Sign-On 지원

WCF 어댑터에서 SSO를 사용할 수 있는 Enterprise SSO(Single Sign-On) 티켓을 가장하고 획득할 수 있습니다. WCF 어댑터에서 SSO를 사용하는 방법에 대한 자세한 내용은 WCF 어댑터에 대한 단일 Sign-On 지원을 참조하세요.

다음 표에는 WCF 수신 어댑터에서 SSO 지원을 사용할 때 지원되지 않는 시나리오가 요약되어 있습니다.

보안 모드 자격 증명
없음 없음
전송 없음
메시지 없음
TransportWithMessageCredentials 없음
TransportCredentialOnly 없음

WCF 확장성

다음과 같은 확장을 개발하고 WCF-Custom 및 WCF-CustomIsolated 어댑터에서 사용하여 WCF 기능을 확장할 수 있습니다.

  • 사용자 지정 바인딩

  • 사용자 지정 바인딩 요소

사용자 지정 바인딩

사용자 지정 바인딩은 개별 바인딩 요소를 특정 사용 시나리오에 대한 구성 속성 하위 집합을 노출하는 컨테이너로 패키징하는 방식으로 개발합니다. GAC(전역 어셈블리 캐시)에 어셈블리를 설치한 다음 컴퓨터 구성 파일에 확장 요소를 추가하여 바인딩 확장을 등록해야 합니다. 또한 사용자 바인딩을 사용하려면 BizTalk 그룹의 모든 서버에 바인딩을 설치해야 합니다. 설치가 완료되면 WCF-Custom 및 WCF-CustomIsolated 어댑터에 바인딩이 표시됩니다. WCF-Custom 및 WCF-CustomIsolated 어댑터는 바인딩 구성 요소의 리플렉션을 사용하여 바인딩 구성 속성을 가져옵니다.

사용자 지정 바인딩 요소

사용자 지정 바인딩 요소는 특정 전송 채널 구성 요소를 추가하거나 수정하는 방식으로 개발합니다. 예를 들어 사용자 지정 압축 풀기 구성 요소가 바인딩 요소로 패키징되거나 UDP 전송이 바인딩 요소로 표시됩니다. 이러한 바인딩 요소는 WCF 어댑터 내에서 사용할 수 있습니다. 사용자 지정 바인딩 요소를 다른 기본 제공 또는 사용자 지정 바인딩 요소와 함께 사용하는 채널 스택을 정의할 수 있습니다. GAC에 어셈블리를 설치한 다음 컴퓨터 구성 파일에 확장 요소를 추가하여 바인딩 확장을 등록해야 합니다. 또한 사용자 바인딩을 사용하려면 BizTalk 그룹의 모든 서버에 바인딩을 설치해야 합니다. 사용자 지정 바인딩 요소를 사용하려면 CustomBinding 바인딩 형식을 선택한 다음 원하는 순서로 바인딩 요소를 추가, 수정 또는 다시 정렬할 수 있습니다.

섹션 내용

참고 항목