다음을 통해 공유

WCF-BasicHttpRelay 어댑터

  • 아티클

Microsoft BizTalk Server WCF-BasicHttpRelay 어댑터를 사용하여 BasicHttpRelayBinding 클래스를 통해 WCF 서비스 요청을 수신하고 보냅니다. WCF-BasicHttpRelay 어댑터는 BasicHttpRelayBinding을 사용하여 Service Bus 릴레이 엔드포인트를 사용합니다.

시작하기 전에

BizTalk Server 2016부터 이 어댑터는 acS(Access Control Service) 또는 SAS(공유 액세스 서명)를 사용하여 Service Bus를 사용하여 아테네에 연결할 수 있습니다. Service Bus를 사용하여 인증할 때 SAS(공유 액세스 서명)를 사용하는 것이 좋습니다.

Service Bus 네임스페이스를 만들면 ACS(Access Control) 네임스페이스가 자동으로 만들어지지 않습니다. ACS를 사용하여 인증하는 경우 새 ACS 네임스페이스를 만들어야 할 수 있습니다. ACS 키 값을 검색하는 단계를 포함하여 자세한 내용은 SB-Messaging 어댑터를 참조하세요.

수신 위치 만들기

참고

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

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

  2. 왼쪽 창에서 수신 포트 노드를 클릭하고, 오른쪽 창에서 새 수신 위치가 연결될 수신 포트를 마우스 오른쪽 단추로 클릭한 다음 속성을 클릭합니다.

  3. 수신 포트 속성 대화 상자의 왼쪽 창에서 수신 위치를 선택한 다음 오른쪽 창에서 새로 만들기 를 클릭하여 새 수신 위치를 만듭니다.

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

  5. WCF-BasicHttpRelay 전송 속성 대화 상자의 일반 탭에서 Service Bus 릴레이 엔드포인트가 호스트되는 엔드포인트 주소와 WCF-BasicHttpRelay 수신 위치에 대한 서비스 ID를 구성합니다.

    사용 항목 원하는 작업
    주소(URI) 필수 사항입니다. Service Bus 릴레이 엔드포인트가 배포되는 URI를 지정합니다.
    엔드포인트 ID 선택 사항입니다. 엔드포인트 ID를 지정합니다. 이러한 설정을 통해 엔드포인트가 이 수신 위치를 인증할 수 있습니다. 엔드포인트와 수신 위치 간의 핸드셰이크 프로세스에서 WCF(Windows Communication Foundation) 인프라는 예상되는 서비스의 ID가 이 요소의 값과 일치하는지 확인합니다.

    기본값은 빈 문자열입니다.

  6. WCF-BasicHttpRelay 전송 속성 대화 상자의 바인딩 탭에서 제한 시간 및 인코딩 관련 속성을 구성합니다.

    사용 항목 원하는 작업
    열기 시간 제한(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-BasicHttpRelay 어댑터는 버퍼링된 전송 모드의 BasicHttpRelayBinding 클래스를 활용하여 엔드포인트와 통신합니다. 버퍼링된 전송 모드의 경우 BasicHttpRelayBinding.MaxBufferSize 속성은 항상 이 속성의 값과 같습니다.

    기본값: 65536

    최대값: 2147483647
    메시지 인코딩 SOAP 메시지를 인코딩하는 데 사용되는 인코더를 지정합니다. 유효한 값은 다음과 같습니다.

    - 텍스트: 문자 메시지 인코더를 사용합니다.
    - Mtom: 메시지 전송 조직 메커니즘 1.0(MTOM) 인코더를 사용합니다.

    기본값은 Text입니다.
    텍스트 인코딩 메시지 인코딩 속성이 Text로 설정된 경우 바인딩에서 메시지를 내보내는 데 사용할 문자 집합 인코딩을 지정 합니다. 유효한 값은 다음과 같습니다.

    - utf-16BE(unicodeFFFE): 유니코드 BigEndian 인코딩.
    - utf-16: 16비트 인코딩.
    - utf-8: 8비트 인코딩

    기본값은 utf-8입니다.
    최대 동시 호출 수 단일 서비스 인스턴스에 대한 동시 호출 수를 지정합니다. 한도를 초과하는 호출은 대기됩니다. 이 값을 0으로 설정하는 것은 Int32.MaxValue로 설정하는 것과 같습니다.

    기본값은 200입니다.

  7. WCF-BasicHttpRelay 전송 속성 대화 상자의 보안 탭에서 WCF-BasicHttpRelay 수신 위치의 보안 기능을 정의합니다.

    사용 항목 원하는 작업
    보안 모드 사용할 보안 유형을 지정합니다. 유효한 값은 다음과 같습니다.

    - 없음: 전송하는 동안 메시지는 보호되지 않습니다.
    - 전송: HTTPS 전송을 사용하여 보안이 제공됩니다. SOAP 메시지는 HTTPS를 통해 보안이 유지됩니다. 이 모드를 사용하려면 Microsoft IIS(인터넷 정보 서비스)에서 SSL(Secure Sockets Layer)을 설정해야 합니다.
    - 메시지: 보안은 HTTP 전송을 통해 SOAP 메시지 보안을 사용하여 제공됩니다. 기본적으로 SOAP 본문 은 암호화되고 서명됩니다. WCF-Basic 어댑터에 유효한 메시지 클라이언트 자격 증명 유형 은 인증서뿐입니다. 이 모드에는 HTTP 전송이 필요합니다. 이 보안 모드를 사용하는 경우 서비스 인증서 - 지문 속성을 통해 이 수신 위치에 대한 서비스 인증서를 제공해야 합니다.
    - TransportWithMessageCredential: HTTPS 전송에서 무결성, 기밀성 및 서비스 인증을 제공합니다. 이 모드를 사용하려면 Microsoft IIS(인터넷 정보 서비스)에서 SSL(Secure Sockets Layer)을 설정해야 합니다.

    기본값은 전송입니다.
    인증서 위의 보안 모드를 Message 또는 TransportWithMessageCredential로 설정한 경우에만 메시지 수준 보안 옵션을 지정합니다. 유효한 값은 다음과 같습니다.

    - UserName: UserName 자격 증명을 사용하여 클라이언트를 인증하도록 이 수신 위치를 사용하도록 설정합니다. 클라이언트 자격 증명에 해당하는 도메인 사용자 계정이나 로컬 사용자 계정을 만들어야 합니다.
    - 인증서: 클라이언트는 클라이언트 인증서를 사용하여 이 수신 위치에 인증됩니다. 클라이언트가 이 수신 위치에 대해 인증될 수 있도록 이 컴퓨터의 신뢰할 수 있는 루트 인증 기관 인증서 저장소에 클라이언트 X.509 인증서에 대한 CA 인증서 체인을 설치해야 합니다.

    기본값은 UserName입니다.
    알고리즘 집합 위의 보안 모드 모드를 Message 또는 TransportWithMessageCredential로 설정한 경우에만 메시지 암호화 및 키 래핑 알고리즘을 지정합니다. 보안 모드를 없음 또는 전송으로 설정한 경우에는 적용되지 않습니다.

    이러한 알고리즘은 보안 정책 언어(WS-SecurityPolicy) 사양에 지정된 알고리즘에 매핑됩니다. 가능한 값은 다음과 같습니다.

    - Basic128: Aes128 암호화, 메시지 다이제스트에 Sha1, 키 래핑에 Rsa-oaep-mgf1p를 사용합니다.
    - Basic128Rsa15: 메시지 암호화에 Aes128, 메시지 다이제스트에 Sha1, 키 래핑에 Rsa15를 사용합니다.
    - Basic128Sha256: 메시지 암호화에 Aes256, 메시지 다이제스트에 Sha256, 키 래핑에 Rsa-oaep-mgf1p를 사용합니다.
    - Basic128Sha256Rsa15: 메시지 암호화에 Aes128, 메시지 다이제스트에 Sha256, 키 래핑에 Rsa15를 사용합니다.
    - Basic192: Aes192 암호화, 메시지 다이제스트에 Sha1, 키 래핑에 Rsa-oaep-mgf1p를 사용합니다.
    - Basic192Rsa15: 메시지 암호화에는 Aes192, 메시지 다이제스트에는 Sha1, 키 래핑에는 Rsa15를 사용합니다.
    - Basic192Sha256: 메시지 암호화에 Aes192, 메시지 다이제스트에 Sha256, 키 래핑에 Rsa-oaep-mgf1p를 사용합니다.
    - Basic192Sha256Rsa15: 메시지 암호화에 Aes192, 메시지 다이제스트에 Sha256, 키 래핑에 Rsa15를 사용합니다.
    - Basic256: Aes256 암호화, 메시지 다이제스트에 Sha1, 키 래핑에 Rsa-oaep-mgf1p를 사용합니다.
    - Basic256Rsa15: 메시지 암호화에는 Aes256, 메시지 다이제스트에는 Sha1, 키 래핑에는 Rsa15를 사용합니다.
    - Basic256Sha256: 메시지 암호화에 Aes256, 메시지 다이제스트에 Sha256, 키 래핑에 Rsa-oaep-mgf1p를 사용합니다.
    - Basic256Sha256Rsa15: 메시지 암호화에는 Aes256, 메시지 다이제스트에는 Sha256, 키 래핑에는 Rsa15를 사용합니다.
    - TripleDes: TripleDes 암호화, 메시지 다이제스트에 Sha1, 키 래핑에 Rsa-oaep-mgf1p를 사용합니다.
    - TripleDesRsa15: TripleDes 암호화, 메시지 다이제스트에 Sha1 및 키 래핑에 Rsa15를 사용합니다.
    - TripleDesSha256: 메시지 암호화에 TripleDes, 메시지 다이제스트에 Sha256, 키 래핑에 Rsa-oaep-mgf1p를 사용합니다.
    - TripleDesSha256Rsa15: 메시지 암호화에 TripleDes, 메시지 다이제스트에 Sha256, 키 래핑에 Rsa15를 사용합니다.

    기본값은 Basic256입니다.
    서비스 인증서 - 손 도장(Thumbprint) 클라이언트가 서비스 인증에 사용하는 이 수신 위치에 대한 X.509 인증서의 손 도장(Thumbprint)을 지정합니다. 손 도장은 찾아보기 단추로 현재 사용자 위치의 내 저장소 를 탐색하여 선택할 수 있습니다. 참고: 위의 보안 모드 모드를 Message 또는 TransportWithMessageCredential로 설정한 경우에만 이 속성을 설정해야 합니다. 보안 모드를 없음 또는 전송으로 설정한 경우에는 적용되지 않습니다. 참고: 이 수신 위치를 호스팅하는 수신 처리기에 대한 사용자 계정의 현재 사용자 위치에 서비스 인증서를 설치해야 합니다.

    최소 길이: 0

    최대 길이: 40

    기본값은 빈 문자열입니다.
    릴레이 클라이언트 인증 유형 메시지가 수신되는 Service Bus 릴레이 엔드포인트를 인증하기 위한 옵션을 지정합니다. 유효한 값은 다음과 같습니다.

    - 없음: 인증이 필요하지 않습니다.
    - RelayAccessToken: 보안 토큰을 사용하여 Service Bus Relay 엔드포인트에 권한을 부여하도록 지정합니다.

    기본값은 RelayAccessToken입니다.
    서비스 검색 사용 이 확인란을 선택하면 서비스 레지스트리에 게시되는 서비스 동작을 지정할 수 있습니다.

    - 표시 이름 – 서비스가 서비스 레지스트리에 게시되는 이름을 지정합니다.
    - 검색 모드 – 서비스 레지스트리에 게시된 서비스의 검색 모드를 설정합니다. 자세한 내용은 DiscoveryType 열거형을 참조하세요.
    액세스 제어 서비스 BizTalk Server 2013 R2 및 BizTalk Server 2013에 적용됩니다.

    릴레이 클라이언트 인증 유형 을 RelayAccessToken으로 설정한 경우 편집 단추를 클릭하고 다음과 같이 지정합니다.

    - 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-Messaging 어댑터에 설명된 대로 Windows PowerShell 사용하여 이러한 값을 검색합니다.

  8. WCF-BasicHttpRelay 전송 속성 대화 상자의 메시지 탭에서 SOAP 본문 요소에 대한 데이터 선택을 지정합니다.

    사용 항목 원하는 작업
    봉투 -- 전체 <soap:Envelope> 들어오는 메시지의 전체 SOAP 봉투 에서 BizTalk 메시지 본문 부분을 만듭니다.

    기본적으로 선택 취소되어 있습니다.
    본문 -- soap:Body> 요소의 <내용 들어오는 메시지의 SOAP Body 요소 콘텐츠를 사용하여 BizTalk 메시지 본문 부분을 만듭니다. Body 요소에 자식 요소가 두 개 이상 있는 경우 첫 번째 요소만 BizTalk 메시지 본문 부분이 됩니다.

    이 값은 기본 설정입니다.
    경로 -- 본문 경로에서 찾은 내용 본문 경로 식 텍스트 상자의 본문 경로 식을 사용하여 BizTalk 메시지 본문 부분을 만듭니다. 본문 경로 식은 들어오는 메시지의 SOAP Body 요소의 직접 자식 요소에 대해 평가됩니다.

    기본적으로 선택 취소되어 있습니다.
    본문 경로 식 본문 경로 식을 입력하여 BizTalk 메시지 본문을 만드는 데 사용되는 들어오는 메시지의 특정 파트를 식별합니다. 이 본문 경로 식은 들어오는 메시지의 SOAP Body 요소의 직접 자식 요소에 대해 평가됩니다. 이 본문 경로 식이 둘 이상의 노드를 반환하는 경우 첫 번째 노드만 BizTalk 메시지 본문에 선택됩니다. 이 속성은 경로 -- 본문 경로별 콘텐츠 옵션을 선택한 경우에 필요합니다.

    유형: String

    최소 길이: 0

    최대 길이: 32767

    기본값은 빈 문자열입니다.
    노드 인코딩 WCF-BasicHttpRelay 수신 어댑터가 본문 경로 식 텍스트 상자의 본문 경로 식으로 식별된 노드를 디코딩하는 데 사용하는 인코딩 유형을 지정합니다.

    이 속성은 경로 -- 본문 경로별 콘텐츠 옵션을 선택한 경우에 필요합니다. 유효한 값은 다음과 같습니다.

    - Base64: Base64 인코딩.
    - 16진수: 16진수 인코딩.
    - 문자열: 텍스트 인코딩 - UTF-8
    - XML: WCF 어댑터는 본문 경로 식 텍스트 상자의 본문 경로 식에서 선택한 노드의 외부 XML을 사용하여 BizTalk 메시지 본문을 만듭니다.

    기본값은 XML입니다.
    본문 -- BizTalk 응답 메시지 본문 BizTalk 메시지 본문 부분을 사용하여 나가는 응답 메시지의 SOAP 본문 요소 콘텐츠를 만듭니다. 이 속성은 요청-응답 수신 위치에만 유효합니다.

    이 값은 기본 설정입니다.
    템플릿 -- 템플릿에서 지정한 내용 XML 텍스트 상자에 제공된 템플릿을 사용하여 보내는 메시지에 대한 SOAP Body 요소의 콘텐츠를 만듭니다. 이 속성은 요청-응답 수신 위치에만 유효합니다.

    기본적으로 선택 취소되어 있습니다.
    XML 보내는 메시지의 SOAP 본문 요소 내용에 대한 XML 형식 템플릿을 입력합니다. 템플릿 -- BizTalk 응답 메시지 본문 옵션을 선택한 경우 이 속성이 필요합니다. 이 속성은 요청-응답 수신 위치에만 유효합니다.

    유형: String

    최소 길이: 0

    최대 길이: 32767

    기본값은 <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml">입니다.
    실패 시 요청 메시지 일시 중단 수신 파이프라인 오류 또는 라우팅 오류로 인해 인바운드 처리되지 못한 요청 메시지를 일시 중단할지 여부를 지정합니다.

    기본적으로 선택 취소되어 있습니다.
    오류에 예외 정보 포함 오류가 발생했을 때 디버깅하기 쉽도록 SOAP 오류를 반환할지 여부를 지정합니다.

    기본적으로 선택 취소되어 있습니다.

  9. 확인을 클릭합니다.

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

송신 포트 만들기

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

  2. 일반 탭의 전송 섹션에서 구성 단추를 클릭합니다.

  3. WCF-BasicHttpRelay 전송 속성 대화 상자의 일반 탭에서 다음을 지정합니다.

    사용 항목 원하는 작업
    주소(URI) 필수 사항입니다. Service Bus에 릴레이 엔드포인트가 배포되는 URL을 지정합니다. 일반적으로 URL에는 다음과 같은 형식이 사용됩니다.

    https://<namespace>.servicebus.windows.net/
    엔드포인트 ID 선택 사항입니다. 엔드포인트 ID를 지정합니다. 이 설정을 통해 송신 포트가 엔드포인트를 인증할 수 있습니다. 엔드포인트와 송신 포트 간의 핸드셰이크 프로세스에서 WCF(Windows Communication Foundation) 인프라는 엔드포인트의 ID가 이 요소의 값과 일치하는지 확인합니다.

    기본적으로 선택 취소되어 있습니다.
    작업 보내는 메시지에 대한 SOAPAction HTTP 헤더 필드를 지정합니다. 이 속성은 메시지 컨텍스트 속성 WCF를 통해 설정할 수도 있습니다 . 파이프라인 또는 오케스트레이션의 작업입니다. 단일 작업 형식과 작업 매핑 형식의 두 가지 방법으로 이 값을 지정할 수 있습니다. 이 속성을 단일 작업 형식(예 http://contoso.com/Svc/Op1: )으로 설정하면 보내는 메시지에 대한 SOAPAction 헤더가 항상 이 속성에 지정된 값으로 설정됩니다.

    이 속성을 작업 매핑 형식으로 설정하면 나가는 SOAPAction 헤더가 BTS에 의해 결정 됩니다. 작업 컨텍스트 속성입니다. 예를 들어 이 속성이 다음 XML 형식 및 BTS로 설정된 경우입니다. Operation 속성은 Op1로 설정되며, WCF 송신 어댑터는 나가는 SOAPAction 헤더에 사용합니다http://contoso.com/Svc/Op1.

    <BtsActionMapping> <Operation Name="Op1" Action="http://contoso.com/Svc/Op1" /> <Operation Name="Op2" Action="http://contoso.com/Svc/Op2" /> </BtsActionMapping>

    보내는 메시지가 오케스트레이션 포트에서 오는 경우 오케스트레이션 인스턴스는 BTS를 동적으로 설정합니다 . 포트의 작업 이름을 가진 Operation 속성입니다. 나가는 메시지가 콘텐츠 기반 라우팅을 사용하여 라우팅되는 경우 BTS를 설정할 수 있습니다 . 파이프라인 구성 요소의 작업 속성입니다.

    중요:

    Service Bus는 메시지를 릴레이 엔드포인트로 보낼 때 SOAP 작업을 설정하도록 합니다.

    최소 길이: 0

    최대 길이: 32767

    기본값은 빈 문자열입니다.

  4. WCF-BasicHttpRelay 전송 속성 대화 상자의 바인딩 탭에서 제한 시간 및 인코딩 속성을 구성합니다.

    사용 항목 원하는 작업
    열기 시간 제한(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-BasicHttpRelay 어댑터는 버퍼링된 전송 모드에서 BasicHttpBinding 클래스를 활용하여 엔드포인트와 통신합니다. 버퍼링된 전송 모드의 경우 BasicHttpBinding.MaxBufferSize 속성은 항상 이 속성의 값과 같습니다.

    기본값: 65536

    최대값: 2147483647
    메시지 인코딩 SOAP 메시지를 인코딩하는 데 사용되는 인코더를 지정합니다. 유효한 값은 다음과 같습니다.

    - 텍스트: 문자 메시지 인코더를 사용합니다.

    - Mtom: MTOM(메시지 전송 조직 메커니즘 1.0) 인코더를 사용합니다.

    기본값: 텍스트
    텍스트 인코딩 메시지 인코딩 속성이 Text로 설정된 경우 바인딩에서 메시지를 내보내는 데 사용할 문자 집합 인코딩을 지정 합니다. 유효한 값은 다음과 같습니다.

    - utf-16BE(unicodeFFFE): 유니코드 BigEndian 인코딩.

    - utf-16: 16비트 인코딩.

    - utf-8: 8비트 인코딩

    기본값: utf-8

  5. WCF-BasicHttpRelay 전송 속성 대화 상자의 보안 탭에서 WCF-BasicHttpRelay 송신 포트의 보안 기능을 정의합니다.

    사용 항목 원하는 작업
    보안 모드 사용할 보안 유형을 지정합니다. 유효한 값은 다음과 같습니다.

    - 없음: 전송 중에 메시지가 보호되지 않습니다.

    - 전송: HTTPS 전송을 사용하여 보안이 제공됩니다. SOAP 메시지는 HTTPS를 통해 보안이 유지됩니다. 서비스 인증서를 통해 송신 포트에 서비스를 인증할 수 있도록 서비스의 X.509 인증서에 대한 CA 인증서 체인을 이 컴퓨터의 신뢰할 수 있는 루트 인증 기관 인증서 저장소에 설치해야 합니다.

    - 메시지: SOAP 메시지 보안을 사용하여 보안이 제공됩니다. 기본적으로 SOAP Body 요소는 암호화되고 서명됩니다. WCF-BasicHttpRelay 송신 어댑터에 유효한 메시지 클라이언트 자격 증명 유형 은 인증서뿐입니다. 이 모드에는 HTTP 전송이 필요합니다.

    - TransportWithMessageCredential: 무결성, 기밀성 및 서비스 인증은 HTTPS 전송을 통해 제공됩니다. 서비스 인증서를 통해 송신 포트에 서비스를 인증할 수 있도록 서비스의 X.509 인증서에 대한 CA 인증서 체인을 이 컴퓨터의 신뢰할 수 있는 루트 인증 기관 인증서 저장소에 설치해야 합니다. 송신 포트 인증은 SOAP 메시지 보안에서 제공합니다.

    기본값은 None(없음)입니다.
    인증서 위의 보안 모드를 Message 또는 TransportWithMessageCredential로 설정한 경우에만 메시지 수준 보안 옵션을 지정합니다. 유효한 값은 다음과 같습니다.

    - UserName: 이 송신 포트는 UserName 자격 증명을 사용하여 엔드포인트에 인증됩니다. WCF-BasicHttpRelay 송신 어댑터에는 지원되지 않습니다.

    - 인증서: 이 송신 포트는 클라이언트 인증서 - 지문 속성을 통해 지정된 클라이언트 인증서를 사용하여 엔드포인트에 인증됩니다. 또한 이 자격 증명 유형을 사용하는 경우 서비스 인증서 - 지문 속성을 통해 서비스 인증서 를 제공해야 합니다.

    기본값은 UserName입니다.
    알고리즘 집합 메시지 암호화 및 키 랩 알고리즘을 지정합니다. 이러한 알고리즘은 보안 정책 언어(WS-SecurityPolicy) 사양에 지정된 알고리즘에 매핑됩니다. 가능한 값은 다음과 같습니다.

    - 기본128: 키 래핑에는 Aes128 암호화, 메시지 다이제스트에는 Sha1, Rsa-oaep-mgf1p를 사용합니다.

    - Basic128Rsa15: 메시지 암호화에는 Aes128, 메시지 다이제스트에는 Sha1, 키 래핑에는 Rsa15를 사용합니다.

    - Basic128Sha256: 메시지 암호화에는 Aes256, 메시지 다이제스트에는 Sha256, 키 래핑에는 Rsa-oaep-mgf1p를 사용합니다.

    - Basic128Sha256Rsa15: 메시지 암호화에는 Aes128, 메시지 다이제스트에는 Sha256, 키 래핑에는 Rsa15를 사용합니다.

    - Basic192: 키 래핑에는 Aes192 암호화, 메시지 다이제스트에는 Sha1, Rsa-oaep-mgf1p를 사용합니다.

    - Basic192Rsa15: 메시지 암호화에는 Aes192, 메시지 다이제스트에는 Sha1, 키 래핑에는 Rsa15를 사용합니다.

    - Basic192Sha256: 메시지 암호화에는 Aes192, 메시지 다이제스트에는 Sha256, 키 래핑에는 Rsa-oaep-mgf1p를 사용합니다.

    - Basic192Sha256Rsa15: 메시지 암호화에는 Aes192, 메시지 다이제스트에는 Sha256, 키 래핑에는 Rsa15를 사용합니다.

    - 기본256: 키 래핑에는 Aes256 암호화, 메시지 다이제스트에는 Sha1, Rsa-oaep-mgf1p를 사용합니다.

    - Basic256Rsa15: 메시지 암호화에는 Aes256, 메시지 다이제스트에는 Sha1, 키 래핑에는 Rsa15를 사용합니다.

    - Basic256Sha256: 메시지 암호화에는 Aes256, 메시지 다이제스트에는 Sha256, 키 래핑에는 Rsa-oaep-mgf1p를 사용합니다.

    - Basic256Sha256Rsa15: 메시지 암호화에는 Aes256, 메시지 다이제스트에는 Sha256, 키 래핑에는 Rsa15를 사용합니다.

    - TripleDes: TripleDes 암호화, 메시지 다이제스트에 Sha1, 키 래핑에 Rsa-oaep-mgf1p를 사용합니다.

    - TripleDesRsa15: TripleDes 암호화, 메시지 다이제스트에 Sha1, 키 래핑에 Rsa15를 사용합니다.

    - TripleDesSha256: 메시지 암호화에 TripleDes, 메시지 다이제스트에 Sha256, 키 래핑에 Rsa-oaep-mgf1p를 사용합니다.

    - TripleDesSha256Rsa15: 메시지 암호화에 TripleDes, 메시지 다이제스트의 경우 Sha256, 키 래핑에 Rsa15를 사용합니다.

    기본값은 Basic256입니다.
    클라이언트 인증서 - 지문 엔드포인트에 대해 이 송신 포트를 인증하는 데 사용할 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로 인증할 다음 값을 제공합니다.

    - 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 사용하여 이러한 값을 검색합니다.

  6. WCF-BasicHttpRelay 전송 속성 대화 상자의 프록시 탭에서 WCF-BasicHttpRelay 송신 포트에 대한 프록시 설정을 구성합니다.

    사용 항목 원하는 작업
    송신 핸들러 프록시 설정 사용 송신 포트에서 이 송신 포트를 호스팅하는 송신 핸들러의 프록시 설정을 사용할지 여부를 지정합니다.

    이 값은 기본 설정입니다.
    프록시 사용 안 함 이 송신 핸들러가 프록시 서버를 사용하는지 여부를 나타냅니다.

    기본적으로 선택 취소되어 있습니다.
    프록시 사용 이 송신 포트가 Address 속성에 지정된 프록시 서버를 사용하는지 여부를 나타냅니다.

    기본적으로 선택 취소되어 있습니다.
    주소 프록시 서버의 주소를 지정합니다. 보안 구성에 따라 https 또는 http 체계를 사용합니다. 이 주소 뒤에는 콜론과 포트 번호가 나올 수 있습니다. 예: http://127.0.0.1:8080.

    이 속성은 프록시 사용 이 선택된 경우에만 값이 필요합니다.

    유형: String

    최대 길이: 256

    기본값은 빈 문자열입니다.
    사용자 이름 인증에 사용할 사용자 이름을 지정합니다. 통합 인증을 사용하는 경우에는 사용자 이름에 도메인이 포함됩니다(예: domain\username). 기본 인증이나 다이제스트 인증을 사용하는 경우에는 사용자 이름에 domain\이 포함되지 않습니다. 이 속성은 프록시 사용 이 선택된 경우에만 값이 필요합니다.

    참고:

    WCF-BasicHttpRelay 송신 어댑터는 프록시에 기본 인증을 사용합니다.

    유형: String

    최소 길이: 0

    최대 길이: 256

    기본값은 빈 문자열입니다.
    암호 인증에 사용할 암호를 지정합니다.

    이 속성은 프록시 사용 이 선택된 경우에만 값이 필요합니다.

    유형: String

    최소 길이: 0

    최대 길이: 256

    기본값은 빈 문자열입니다.

  7. WCF-BasicHttpRelay 전송 속성 대화 상자의 메시지 탭에서 SOAP 본문 요소에 대한 데이터 선택을 지정합니다.

    사용 항목 원하는 작업
    본문 -- BizTalk 요청 메시지 본문 BizTalk 메시지 본문 부분을 사용하여 보내는 메시지에 대한 SOAP 본문 요소의 콘텐츠를 만듭니다.

    이 값은 기본 설정입니다.
    템플릿 -- 템플릿에서 지정한 내용 XML 텍스트 상자에 제공된 템플릿을 사용하여 보내는 메시지에 대한 SOAP 본문 요소의 콘텐츠를 만듭니다.

    기본적으로 선택 취소되어 있습니다.
    XML 보내는 메시지의 SOAP ody 요소 내용에 대한 XML 형식 템플릿을 입력합니다. 템플릿 -- BizTalk 응답 메시지 본문 옵션을 선택한 경우 이 속성이 필요합니다.

    유형: String

    최소 길이: 0

    최대 길이: 32767

    기본값은 <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/>입니다.
    봉투 -- 전체 <비누:봉투> 들어오는 메시지의 전체 SOAP 봉투 에서 BizTalk 메시지 본문 부분을 만듭니다. 이 속성은 간청-응답 포트에 대해서만 유효합니다.

    기본적으로 선택 취소되어 있습니다.
    본문 -- soap:Body> 요소의 <내용 들어오는 메시지의 SOAP 본문 요소의 콘텐츠를 사용하여 BizTalk 메시지 본문 부분을 만듭니다. Body 요소에 둘 이상의 자식 요소가 있는 경우 첫 번째 요소만 BizTalk 메시지 본문 부분이 됩니다. 이 속성은 간청-응답 포트에 대해서만 유효합니다.

    이 값은 기본 설정입니다.
    경로 -- 본문 경로에서 찾은 내용 본문 경로 식 텍스트 상자의 본문 경로 식을 사용하여 BizTalk 메시지 본문 부분을 만듭니다. 본문 경로 식은 들어오는 메시지의 SOAP Body 요소에 대한 직동 자식 요소에 대해 평가됩니다. 이 속성은 간청-응답 포트에 대해서만 유효합니다.

    기본적으로 선택 취소되어 있습니다.
    본문 경로 식 본문 경로 식을 입력하여 BizTalk 메시지 본문을 만드는 데 사용되는 들어오는 메시지의 특정 파트를 식별합니다. 이 본문 경로 식은 들어오는 메시지의 SOAP 본문 노드의 직할 자식 요소에 대해 평가됩니다. 이 본문 경로 식이 둘 이상의 노드를 반환하는 경우 첫 번째 노드만 BizTalk 메시지 본문에 선택됩니다. 이 속성은 경로 -- 본문 경로에 의해 있는 콘텐츠 옵션이 선택된 경우에 필요합니다. 이 속성은 간청-응답 포트에 대해서만 유효합니다.

    유형: String

    최소 길이: 0

    최대 길이: 32767

    기본값은 빈 문자열입니다.
    노드 인코딩 WCF-BasicHttpRelay 송신 어댑터가 본문 경로 식 텍스트 상자의 본문 경로 식으로 식별된 노드에 대해 디코딩하는 데 사용하는 인코딩 유형을 지정합니다. 이 속성은 경로 -- 본문 경로에 의해 있는 콘텐츠 옵션이 선택된 경우에 필요합니다. 이 속성은 간청-응답 포트에 대해서만 유효합니다. 유효한 값은 다음과 같습니다.

    - Base64: Base64 인코딩.

    - 16진수: 16진수 인코딩.

    - 문자열: 텍스트 인코딩 - UTF-8

    - XML: WCF 어댑터는 본문 경로 식 텍스트 상자의 본문 경로 식에서 선택한 노드의 외부 XML을 사용하여 BizTalk 메시지 본문을 만듭니다.

    기본값은 XML입니다.
    오류 메시지 전파 다른 수신 포트나 오케스트레이션 일정과 같은 등록 응용 프로그램으로 아웃바운드 처리를 하지 못한 메시지를 라우팅하려면 이 확인란을 선택합니다. 보내지 못한 메시지를 일시 중단하고 NACK(부정 승인)를 생성하려면 확인란의 선택을 취소합니다. 이 속성은 간청-응답 포트에 대해서만 유효합니다.

    기본적으로 선택되어 있습니다.

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

송신 처리기에 프록시 추가

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

  1. BizTalk Server 관리 콘솔에서 BizTalk Server 관리, BizTalk 그룹, 플랫폼 설정을 차례로 확장한 다음 어댑터를 확장합니다.

  2. WCF-BasicHttpRelay를 선택한 다음, 송신 처리기를 선택합니다.

  3. 어댑터 처리기 속성의 일반 탭에서 속성을 선택합니다.

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

    사용 항목 원하는 작업
    프록시 사용 이 송신 처리기가 프록시 서버를 사용하는지 여부를 나타냅니다.

    기본적으로 선택 취소되어 있습니다.
    주소 프록시 서버의 주소를 지정합니다. 보안 구성에 따라 https 또는 http 체계를 사용합니다. 이 주소 뒤에는 콜론과 포트 번호가 나올 수 있습니다. 예: http://127.0.0.1:8080.

    이 속성은 프록시 사용 이 선택된 경우에만 값이 필요합니다.

    유형: String

    최대 길이: 256

    기본값은 빈 문자열입니다.
    사용자 이름 인증에 사용할 사용자 이름을 지정합니다. 통합 인증이나 기본 인증을 사용하는 경우 사용자 이름에 도메인이 포함됩니다(예: domain\username). 다이제스트 인증을 사용하는 경우에는 사용자 이름에 domain\이 포함되지 않습니다.

    이 속성은 프록시 사용 이 선택된 경우에만 값이 필요합니다.

    유형: String

    최소 길이: 0

    최대 길이: 256

    기본값은 빈 문자열입니다.
    암호 인증에 사용할 암호를 지정합니다.

    이 속성은 프록시 사용 이 선택된 경우에만 값이 필요합니다.

    유형: String

    최소 길이: 0

    최대 길이: 256

    기본값은 빈 문자열입니다.

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

참고 항목

SB-Messaging 어댑터

어댑터 사용