WCF 어댑터를 통해 WCF 확장성 지점을 설정하는 방법

아티클
07/21/2023

WCF-Custom 및 WCF-CustomIsolated 어댑터를 사용하여 동작 확장, 바인딩 요소 확장 및 바인딩 확장의 세 가지 WCF 확장성을 사용하도록 설정합니다. 이렇게 하려면 먼저 GAC(전역 어셈블리 캐시)에 WCF 확장성 지점을 구현하는 어셈블리를 설치한 다음, 컴퓨터에서 machine.config 파일을 수정한 다음, BizTalk Server 관리 콘솔을 사용하여 WCF-Custom 또는 WCF-CustomIsolated 어댑터를 구성합니다.

WCF 확장성에 대한 자세한 내용은 WCF 확장을 참조하세요.

필수 구성 요소

BizTalk Server Administrators 그룹의 구성원인 계정으로 로그인합니다. BizTalk 애플리케이션 배포 및 관리에 필요한 권한 은 자세한 정보를 제공합니다.

GAC에서 WCF 확장성 지점을 구현하는 어셈블리 설치

WCF 확장성 지점을 구현하는 어셈블리를 로컬 컴퓨터의 폴더에 복사합니다.
WCF 확장성 지점에서 사용하는 어셈블리(있을 경우)를 로컬 컴퓨터의 폴더에 복사합니다.
Visual Studio 명령 프롬프트를 시작합니다.
다음 명령을 입력합니다.

gacutil.exe /if "<어셈블리 .dll 파일>의 경로"
어셈블리가 GAC에 설치되고 이름이 같은 기존 어셈블리가 덮어쓰여집니다.
Visual Studio 명령 프롬프트에서 이 절차의 1단계와 2단계에서 복사한 모든 어셈블리에 대해 4단계와 5단계를 반복합니다.
여러 BizTalk Server 런타임 컴퓨터 및 관리 컴퓨터가 있는 경우 모든 컴퓨터에서 이 절차의 1~6단계를 반복합니다.

참고

WCF 어댑터에 WCF 확장성 지점을 사용하려면 해당 어댑터를 실행하는 BizTalk 호스트 인스턴스에서 WCF 확장성 지점이 구현된 어셈블리를 런타임에 로드할 수 있어야 합니다.

WCF 바인딩 확장 프로그램에 대한 machine.config 파일 구성

명령 프롬프트에서 %FrameworkDir%\v4로 이동합니다. X.XXXXX\CONFIG 폴더를 열고 메모장을 사용하여 machine.config 파일을 엽니다.
메모장에서 machine.config 파일에 system.serverModel>\<extensions> 요소가 없는< 경우 해당 요소를 machine.config 파일의 구성> 요소 내에< 추가한 다음 system.serverModel>\<extensions 요소 내<의 WCF 바인딩 확장에 대한 bindingExtensions 요소를 추가합니다><.> 예를 들어 사용자 지정 바인딩 확장인 netHttpBinding을 사용하도록 설정하려면 machine.config 파일의 구성> 요소 내에< 다음 코드를 추가합니다.
```
<system.serviceModel>  
  <extensions>  
    <bindingExtensions>  
      <add name="netHttpBinding" type="Microsoft.Samples.Channels.NetHttpBindingCollectionElement, NetHttpBinding, Version=3.0.0.0, Culture=neutral, PublicKeyToken=5b637b51c4aaa2a8" />  
    </bindingExtensions>        
  </extensions>  
</system.serviceModel>  
```
참고
- gacutil /lr<> assembly_name 명령을 사용하여 등록할 어셈블리에 대한 정보를 찾을 수 있습니다.
- 이 요소에 대한 bindingExtensions 를 참조하세요.
메모장에서 machine.config 파일을 저장합니다.
여러 BizTalk Server 런타임 컴퓨터 및 관리 컴퓨터가 있는 경우 모든 컴퓨터에서 이 절차의 1~3단계를 반복합니다.

참고

BizTalk 호스트 instance 및 BizTalk Server 관리 콘솔에 대한 WCF 확장성 지점을 처리하려면 WCF 인프라의 모든 컴퓨터에서 이러한 단계를 반복해야 합니다.

BizTalk 관리 콘솔을 사용하여 WCF 바인딩 확장 구성

BizTalk Server 관리를 엽니다.

참고

BizTalk Server 관리 콘솔이 이미 열려 있는 경우 BizTalk Server 관리 콘솔을 다시 시작합니다.
WCF-Custom 어댑터를 사용하는 경우 BizTalk Server 관리 콘솔에서 플랫폼 설정을 확장하고 호스트 인스턴스를 확장한 다음, 어댑터를 실행하는 instance BizTalk Host를 다시 시작합니다.
WCF-CustomIsolated 어댑터를 사용하는 경우 IIS 관리 콘솔에서 WCF 수신 위치와 연결된 응용 프로그램 풀을 다시 시작합니다.
WCF 확장성을 사용하도록 수신 위치를 구성하려면 BizTalk Server 관리 콘솔에서 BizTalk 그룹을 확장하고 BizTalk 애플리케이션>을 확장하고<수신 위치를 확장한 다음 오른쪽 창에서 수신 위치를> 두 번 클릭합니다<.
- 수신 위치 속성 대화 상자의 유형 드롭다운 목록에서 사용하려는 WCF 어댑터에 따라 WCF-Custom 또는 WCF-CustomIsolated를 선택한 다음 구성을 클릭합니다.
WCF 확장성을 사용하도록 송신 포트를 구성하려면 BizTalk Server 관리 콘솔에서 BizTalk 그룹, BizTalk 애플리케이션>, 송신 포트를 차례로< 확장한 다음 오른쪽 창에서 송신 포트>를 두 번 클릭합니다<.
- 송신 포트 속성 대화 상자의 형식 드롭다운 목록에서 WCF-Custom을 선택한 다음 구성을 클릭합니다.
전송 속성 대화 상자의 바인딩 탭에서 바인딩 확장을 선택한 다음 전송에 대한 나머지 설정을 구성합니다.
BizTalk Server 관리 콘솔에서 확인 단추를 클릭하여 열려 있는 모든 대화 상자를 닫은 다음 오류 메시지 및 잘못된 이벤트 로그가 표시되지 않도록 합니다.

WCF 바인딩 요소 확장에 대한 machine.config 파일 구성

명령 프롬프트에서 %FrameworkDir%\v4로 이동합니다. X.XXXXX\CONFIG 폴더를 열고 메모장을 사용하여 machine.config 파일을 엽니다.
메모장에서 machine.config 파일에 system.serverModel>\<extensions> 요소가 없는< 경우 해당 요소를 machine.config 파일의 구성> 요소 내에< 추가한 다음 system.serverModel>\<extensions 요소 내<의 WCF 바인딩 요소 확장에 대한 bindingElementExtensions 요소를 추가합니다><.> 예를 들어 사용자 지정 바인딩 요소 확장을 사용하도록 설정하려면 삭제Interceptor를 사용하여 machine.config 파일의 구성> 요소 내에< 다음 코드를 추가합니다.
```
<system.serviceModel>  
  <extensions>  
    <bindingElementExtensions>  
      <add name="droppingInterceptor" type="Microsoft.ServiceModel.Samples.DroppingServerElement, MessageInterceptor, Version=0.0.0.0, Culture=neutral, PublicKeyToken=098514eef14aa34a"/>  
    </bindingElementExtensions>  
  </extensions>  
</system.serviceModel>  
```
참고
- gacutil /lr<> assembly_name 명령을 사용하여 등록할 어셈블리에 대한 정보를 찾을 수 있습니다.
- 이 요소에 대한 bindingElementExtensions 를 참조하세요.
메모장에서 machine.config 파일을 저장합니다.
여러 BizTalk Server 런타임 컴퓨터 및 관리 컴퓨터가 있는 경우 모든 컴퓨터에서 이 절차의 1~3단계를 반복합니다.

참고

BizTalk 호스트 instance 및 BizTalk Server 관리 콘솔에 대한 WCF 확장성 지점을 처리하려면 WCF 인프라의 모든 컴퓨터에서 이러한 단계를 반복해야 합니다.

BizTalk 관리 콘솔을 사용하여 WCF 바인딩 요소 확장 구성

BizTalk Server 관리를 엽니다.

참고

BizTalk Server 관리 콘솔이 이미 열려 있는 경우 BizTalk Server 관리 콘솔을 다시 시작합니다.
WCF-Custom 어댑터를 사용하는 경우 BizTalk Server 관리 콘솔에서 플랫폼 설정을 확장하고 호스트 인스턴스를 확장한 다음, 어댑터를 실행하는 instance BizTalk Host를 다시 시작합니다.
WCF-CustomIsolated 어댑터를 사용하는 경우 IIS 관리 콘솔에서 WCF 수신 위치와 연결된 응용 프로그램 풀을 다시 시작합니다.
WCF 확장성을 사용하도록 수신 위치를 구성하려면 BizTalk Server 관리 콘솔에서 BizTalk 그룹을 확장하고 BizTalk 애플리케이션>을 확장하고<수신 위치를 확장한 다음 오른쪽 창에서 수신 위치를> 두 번 클릭합니다<.
- 수신 위치 속성 대화 상자의 유형 드롭다운 목록에서 사용하려는 WCF 어댑터에 따라 WCF-Custom 또는 WCF-CustomIsolated를 선택한 다음 구성을 클릭합니다.
WCF 확장성을 사용하도록 송신 포트를 구성하려면 BizTalk Server 관리 콘솔에서 BizTalk 그룹, BizTalk 애플리케이션>, 송신 포트를 차례로< 확장한 다음 오른쪽 창에서 송신 포트>를 두 번 클릭합니다<.
- 송신 포트 속성 대화 상자의 형식 드롭다운 목록에서 WCF-Custom을 선택한 다음 구성을 클릭합니다.
전송 속성 대화 상자의 바인딩 탭에 있는 바인딩 형식 드롭다운 목록에서 customBinding을 선택합니다.
전송 속성 대화 상자의 바인딩 탭에서 바인딩 목록의 클라이언트 영역을 마우스 오른쪽 단추로 클릭한 다음 확장 추가를 클릭합니다.
바인딩 요소 확장 선택 대화 상자에서 바인딩 요소 확장을 선택한 다음 확인을 클릭합니다.
전송 속성 대화 상자의 바인딩 탭에서 이전 단계에서 추가한 바인딩 요소 확장의 형식에 따라 바인딩 목록에 추가된 바인딩 요소의 순서를 다음과 같이 조정합니다.
- 바인딩 목록에서 바인딩 요소 확장을 마우스 오른쪽 단추로 클릭한 다음 확장 이동 또는 확장 아래로 이동을 클릭합니다. 바인딩 목록의 가장 낮은 바인딩 요소 확장은 채널 스택의 아래쪽 구성 요소에 해당합니다. 바인딩 목록에서 가장 높은 바인딩 요소는 통신 스택의 최상위 구성 요소에 해당합니다.
  
  참고
  
  사용자 지정 바인딩에 대한 바인딩 요소의 특정 순서에 대한 자세한 내용은 사용자 지정 바인딩을 참조하세요.
전송 속성 대화 상자에서 나머지 전송 설정을 구성합니다.
BizTalk Server 관리 콘솔에서 확인 단추를 클릭하여 열려 있는 모든 대화 상자를 닫은 다음 오류 메시지 및 잘못된 이벤트 로그가 표시되지 않도록 합니다.

WCF 동작 확장 프로그램에 대한 machine.config 파일 구성

명령 프롬프트에서 %FrameworkDir%\v4로 이동합니다. X.XXXXX\CONFIG 폴더를 열고 메모장을 사용하여 machine.config 파일을 엽니다.
메모장에서 machine.config 파일에 system.serverModel>\<extensions> 요소가 없는< 경우 해당 요소를 machine.config 파일의 구성> 요소 내에< 추가한 다음 system.serverModel>\<extensions 요소 내<의 WCF 동작 확장에 대한 behaviorExtensions 요소를 추가합니다><.> 예를 들어 사용자 지정 동작 확장인 schemaValidator를 사용하도록 설정하려면 machine.config 파일의 구성> 요소 내에< 다음 코드를 추가합니다.
```
<system.serviceModel>  
  <extensions>  
    <behaviorExtensions>  
      <add name="schemaValidator" type="Microsoft.ServiceModel.Samples.SchemaValidationBehaviorExtensionElement, MessageInspectors, Version=1.0.0.0, Culture=neutral, PublicKeyToken=ad307e213604f592"/>  
    </behaviorExtensions>  
  </extensions>  
</system.serviceModel>  
```
참고
- gacutil /lr<> assembly_name 명령을 사용하여 등록할 어셈블리에 대한 정보를 찾을 수 있습니다.
- 이 요소에 대한 behaviorExtensions 를 참조하세요.
메모장에서 machine.config 파일을 저장합니다.
여러 BizTalk Server 런타임 컴퓨터 및 관리 컴퓨터가 있는 경우 모든 컴퓨터에서 이 절차의 1~3단계를 반복합니다.

참고

BizTalk 호스트 instance 및 BizTalk Server 관리 콘솔에 대한 WCF 확장성 지점을 처리하려면 WCF 인프라의 모든 컴퓨터에서 이러한 단계를 반복해야 합니다.

BizTalk 관리 콘솔을 사용하여 WCF 동작 확장 구성

BizTalk Server 관리를 엽니다.

참고

BizTalk Server 관리 콘솔이 이미 열려 있는 경우 BizTalk Server 관리 콘솔을 다시 시작합니다.
WCF-Custom 어댑터를 사용하는 경우 BizTalk Server 관리 콘솔에서 플랫폼 설정을 확장하고 호스트 인스턴스를 확장한 다음, 어댑터를 실행하는 instance BizTalk Host를 다시 시작합니다.
WCF-CustomIsolated 어댑터를 사용하는 경우 IIS 관리 콘솔에서 WCF 수신 위치와 연결된 응용 프로그램 풀을 다시 시작합니다.
WCF 확장성 지점을 사용하도록 수신 위치를 구성하려면 BizTalk 관리 콘솔에서 BizTalk 그룹을 확장하고 BizTalk 애플리케이션>을 확장하고<수신 위치를 확장한 다음 오른쪽 창에서 수신 위치를> 두 번 클릭합니다<.
- 수신 위치 속성 대화 상자의 유형 드롭다운 목록에서 사용하려는 WCF 어댑터에 따라 WCF-Custom 또는 WCF-CustomIsolated를 선택한 다음 구성을 클릭합니다.
WCF 확장성 지점을 사용하도록 송신 포트를 구성하려면 BizTalk 관리 콘솔에서 BizTalk 그룹을 확장하고 BizTalk 애플리케이션>을 확장하고<포트 보내기를 확장한 다음 오른쪽 창에서 송신 포트>를 두 번 클릭합니다<.
- 송신 포트 속성 대화 상자의 형식 드롭다운 목록에서 WCF-Custom을 선택한 다음 구성을 클릭합니다.
전송 속성 대화 상자의 동작 탭에서 동작 확장의 유형에 따라 ServiceBehavior 또는 EndpointBehavior 를 마우스 오른쪽 단추로 클릭한 다음 동작 확장 선택 대화 상자에서 동작 확장을 선택한 다음 확인을 클릭합니다.
전송 속성 대화 상자에서 나머지 전송 설정을 구성합니다.
BizTalk Server 관리 콘솔에서 확인 단추를 클릭하여 열려 있는 모든 대화 상자를 닫은 다음 오류 메시지 및 잘못된 이벤트 로그가 표시되지 않도록 합니다.

SSL 인증서를 사용하여 WCF-Custom 수신 위치 구성

WCF-Custom 수신 위치가 httpsTransport 바인딩 요소와 같은 HTTP 커널 모드 드라이버(HTTP.sys)를 사용하는 경우 SSL(Secure Sockets Layer) 통신에 대해 수신 위치에 각 소켓(IP 주소/포트 조합)에 대해 등록된 인증서가 있어야 합니다. HttpCfg.exe 도구를 사용하여 SSL 인증서를 컴퓨터의 포트에 바인딩합니다. 자세한 내용은 방법: SSL 인증서를 사용하여 포트 구성을 참조하세요.

다음을 통해 공유