WCF 어댑터 속성 스키마 및 속성

WCF 어댑터 속성 스키마의 승격된 속성에 대해 읽어보세요. WCF 어댑터는 응용 프로그램에서 사용할 수 있는 속성에 값을 할당합니다. 또한 WCF 어댑터는 사용자 지정 속성을 BizTalk 메시지 컨텍스트에 쓸 수 있지만 승격할 수 없는 메커니즘과 사용자 지정 속성을 BizTalk 메시지 컨텍스트로 승격할 수 있는 메커니즘을 제공합니다. 자세한 내용은 게시된 WCF 서비스를 사용하는 SOAP 헤더를 참조하세요.

승격 속성

네임스페이스:http://schemas.microsoft.com/BizTalk/2006/01/Adapters/WCF-properties

작업

보내는 메시지에 대한 SOAPAction 헤더 필드를 지정합니다. 단일 작업 형식과 작업 매핑 형식의 두 가지 방법으로 이 값을 지정할 수 있습니다. 이 속성을 단일 작업 형식(예: ) 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를 설정할 수 있습니다 . 파이프라인 구성 요소의 작업 속성입니다. 이 속성은 단일 작업 형식을 사용하여 들어오는 메시지에서 자동으로 승격됩니다.

형식: 문자열 기본값: 빈 문자열 적용 대상: 모든 WCF 송신 어댑터

AffiliateApplicationName

Enterprise SSO(Single Sign-On)에 사용할 관련 응용 프로그램을 지정합니다. UseSSO 속성이 True로 설정된 경우 이 속성이 필요합니다.

형식: 문자열 기본값: 빈 문자열 적용 대상: WCF-NetNamedPipe 어댑터를 제외한 모든 WCF 송신 어댑터

AlgorithmSuite

메시지 암호화 및 키 랩 알고리즘을 지정합니다. 이러한 알고리즘은 보안 정책 언어(WS-SecurityPolicy) 사양에 지정된 알고리즘에 매핑됩니다.

AlgorithmSuite 속성에 해당하는 값에 대한 자세한 내용은 WCF-NetTcp 전송 속성 대화 상자의 Algorithm suite 속성, UI 지침 및 개발자 API 네임스페이스 참조의 보내기, 보안 탭을 참조하세요.

형식: 문자열 기본값: Basic256 적용 대상:

• WCF-BasicHttp 어댑터
• WCF-NetMsmq 어댑터
• WCF-NetTcp 어댑터
• WCF-WSHttp 어댑터

BindingConfiguration

바인딩 요소를 사용하여 XML 문자열을 <지정하여 WCF(Windows Communication Foundation)에서 제공하는 다양한 형식의 미리 정의된 바인딩을 구성합니다.> 시스템 제공 바인딩 및 사용자 지정 바인딩에 대한 자세한 내용은 참고 항목에서 해당 항목을 참조하십시오.

예제:

<binding name="wsHttpBinding" transactionFlow="true">
<security><message clientCredentialType="UserName"></security>
</binding>

형식: 문자열 기본값: 빈 문자열 적용 대상: WCF-Custom 어댑터, WCF-CustomIsolated 어댑터

BindingType

엔드포인트에 사용할 바인딩 유형을 지정합니다. BindingType 속성에 해당하는 값에 대한 자세한 내용은 UI 지침 및 개발자 API 네임스페이스 참조의 WCF-사용자 지정 전송 속성 대화 상자, 보내기, 바인딩 탭의 바인딩 형식 속성을 참조하세요.

형식: 문자열 기본값: 빈 문자열 적용 대상: WCF-Custom 어댑터, WCF-CustomIsolated 어댑터

ClientCertificate

서비스에 대해 이 송신 포트를 인증하는 데 사용할 X.509 인증서의 손 도장(Thumbprint)을 지정합니다. ClientCredentialsType 속성이 인증서로 설정된 경우 이 속성이 필요합니다. 이 속성에 사용할 인증서는 현재 사용자 위치의 내 저장소에 설치해야 합니다.

형식: 문자열 기본값: 빈 문자열 적용 대상:

• WCF-BasicHttp 송신 어댑터
• WCF-WSHttp 송신 어댑터
• WCF-NetTcp 송신 어댑터
• WCF-NetMsmq 송신 어댑터

CloseTimeout

채널 닫기 작업이 완료될 수 있도록 제공되는 시간 간격을 나타내는 시간 범위 값을 지정합니다.

형식: 문자열 기본값: 00:01:00 적용 대상: WCF-Custom 및 WCF-CustomIsolated 제외한 모든 WCF 어댑터

CustomDeadLetterQueue

애플리케이션별 배달 못 한 편지 큐의 위치에 대해 net.msmq 스키마 를 사용하여 정규화된 URI를 지정합니다. 여기서 만료되었거나 전송 또는 배달에 실패한 메시지가 배치됩니다. net.msmq://localhost/deadLetterQueueName)를 지정합니다. 배달 못 한 편지 큐는 송신 애플리케이션의 큐 관리자에서 관리하는 큐로, 배달하지 못한 만료된 메시지가 보관됩니다. DeadLetterQueue 속성이 Custom으로 설정된 경우 이 속성이 필요합니다.

형식: 문자열 기본값: 빈 문자열 적용 대상: WCF-NetMsmq 송신 어댑터

DeadLetterQueue

응용 프로그램으로 배달하지 못한 메시지가 전송될 배달 못한 편지 큐를 지정합니다. 배달 못한 편지 큐에 배달된 메시지에 대한 자세한 내용은 UI 지침 및 개발자 API 네임스페이스 참조의 WCF-NetMsmq 전송 속성 대화 상자, 보내기, 바인딩 탭을 참조하세요.

형식: 문자열 기본값: 시스템 적용 대상: WCF-NetMsmq 송신 어댑터

DisableLocationOnFailure

수신 파이프라인 오류 또는 라우팅 오류로 인해 인바운드 처리가 실패하는 수신 위치를 해제할지 여부에 대해서 지정합니다. 수신 위치를 사용하지 않도록 설정할 수 있고 DoS(서비스 거부)가 문제가 되지 않는 경우 이 속성을 True 로 설정할 수 있습니다.

예:

• WCF-Custom 어댑터: BindingType 속성이 netMsmqBinding으로 설정된 경우
• WCF-Custom 어댑터: BindingType 속성이 customBinding으로 설정되고 BindingConfiguration 속성이 MSMQ와 같은 대기 중인 전송을 사용하는 사용자 지정 채널을 사용하도록 구성된 경우
• WCF-CustomIsolated 어댑터: BindingType 속성이 customBinding으로 설정되고 BindingConfiguration 속성이 MSMQ와 같은 대기 중인 전송을 사용하는 사용자 지정 채널을 사용하도록 구성된 경우
• WCF-NetMsmq 어댑터

형식: 부울 기본값: False 적용 대상:

• WCF-NetMsmq 수신 어댑터
• WCF-Custom 수신 어댑터
• WCF-CustomIsolated 수신 어댑터

EnableTransaction

이 속성의 효과는 WCF 어댑터에 따라 달라집니다. 이 속성에 대한 자세한 내용은 WCF 어댑터의 각 WCF 어댑터에 대한 topics 방법을 참조하세요.

형식: 부울 적용 대상:

• WCF-WSHttp 어댑터
• WCF-NetTcp 어댑터
• WCF-NetNamedPipe 어댑터
• WCF-NetMsmq 어댑터

EndpointBehaviorConfiguration

endpointBehaviors> 요소의<동작> 요소를 사용하여< XML 문자열을 지정하여 WCF 엔드포인트의 동작 설정을 구성합니다. endpointBehaviors> 요소에< 대한 자세한 내용은 참고 항목에서 해당 항목을 참조하세요.

예제:

<behavior name="sampleBehavior"><callbackTimeouts/></behavior>

형식: 문자열 기본값: 빈 문자열 적용 대상: WCF-Custom 송신 어댑터

EstablishSecurityContext

보안 채널에서 보안 세션을 설정할지 여부를 지정합니다. 보안 세션은 애플리케이션 메시지를 교환하기 전에 SCT(보안 컨텍스트 토큰)를 설정합니다.

형식: 부울 기본값: True 적용 날짜: WCF-WSHttp 어댑터

FromAddress

들어오는 WCF 메시지가 전송되는 소스 엔드포인트 주소를 나타냅니다. 이 속성은 들어오는 메시지에서 자동으로 승격됩니다.

형식: 문자열 적용 대상: WCF-NetMsmq 송신 어댑터를 제외한 모든 WCF 어댑터

헤더

URI를 벗어난 추가 주소 지정 정보를 제공하는 데 사용되는 엔드포인트 참조를 지정합니다. 이 속성을 사용 하는 경우이 속성은 루트 요소로 headers> 요소를 해야 < 합니다. 모든 주소 헤더는 headers> 요소 내에 < 배치해야 합니다. 이 속성은 들어오는 메시지에 대해 자동으로 승격됩니다.

예제:

<headers>
<Region xmlns="Uri">"String"</Region>
<Member xmlns="Uri">"String"</Member>
</headers>

형식: 문자열 적용 대상: 모든 WCF 어댑터

ID

수신 위치에서 제공하거나 송신 포트에 필요한 서비스의 ID를 지정합니다. Identity 속성에 대해 지정할 수 있는 값은 보안 구성에 따라 다릅니다. 이러한 설정을 통해 클라이언트에서 서비스를 인증할 수 있습니다. 클라이언트와 서비스 간의 핸드셰이크 프로세스에서 WCF(Windows Communication Foundation) 인프라는 서비스의 ID가 이 클라이언트의 값과 일치하는지 확인합니다.

예제:

<identity>
<userPrincipalName value="username@contoso.com"/>
</identity>

형식: 문자열 기본값: 빈 문자열 적용 대상: 모든 WCF 어댑터

InboundBodyLocation

들어오는 WCF 메시지의 SOAP Body 요소에 대한 데이터 선택을 지정합니다. InboundBodyLocation 속성을 사용하는 방법에 대한 자세한 내용은 WCF 어댑터에 대한 메시지 본문 지정을 참조하세요.

형식: 문자열 기본값: UseBodyElement

적용 가능한 값은 다음과 같습니다.

• UseBodyElement: 들어오는 메시지의 SOAP 본문 요소의 콘텐츠를 사용하여 BizTalk 메시지 본문 부분을 만듭니다. Body 요소에 둘 이상의 자식 요소가 있는 경우 첫 번째 요소만 BizTalk 메시지 본문 부분이 됩니다.
• UseEnvelope: 들어오는 메시지의 전체 SOAP 봉투 에서 BizTalk 메시지 본문 부분을 만듭니다.
• UseBodyPath: InboundBodyPathExpression 속성의 본문 경로 식을 사용하여 BizTalk 메시지 본문 부분을 만듭니다. 본문 경로 식은 들어오는 메시지의 SOAP Body 요소에 대한 직동 자식 요소에 대해 평가됩니다. 이 속성은 간청-응답 포트에 대해서만 유효합니다.

적용 대상: WCF-NetMsmq 송신을 제외한 모든 WCF 어댑터

InboundBodyPathExpression

본문 경로 식을 지정하여 BizTalk 메시지 본문을 만드는 데 사용되는 들어오는 메시지의 특정 파트를 식별합니다. 이 본문 경로 식은 들어오는 메시지의 SOAP 본문 노드의 직할 자식 요소에 대해 평가됩니다. 이 본문 경로 식이 둘 이상의 노드를 반환하는 경우 첫 번째 노드만 BizTalk 메시지 본문에 선택됩니다. InboundBodyLocation 속성이 UseBodyPath로 설정된 경우 이 속성이 필요합니다. InboundBodyPathExpression 속성을 사용하는 방법에 대한 자세한 내용은 WCF 어댑터 속성 스키마 및 속성을 참조하세요.

형식: 문자열 기본값: 빈 문자열 적용 대상: WCF-NetMsmq 송신 어댑터를 제외한 모든 WCF 어댑터

InboundHeaders

InboundHeaders 속성을 사용하여 들어오는 WCF 메시지의 SOAP 헤더에 액세스합니다. WCF 어댑터는 인바운드 메시지의 모든 SOAP 헤더 값을 이 속성에 복사합니다. 여기에는 WCF 인프라에서 WS-Addressing, WS-Security, WS-AtomicTransaction 등에 사용하는 사용자 지정 SOAP 헤더 및 표준 SOAP 헤더가 포함됩니다. 컨텍스트 속성에 포함된 값은 헤더> 루트 요소가 있는 XML 데이터를 < 포함하는 문자열이며 들어오는 SOAP 헤더는 헤더 요소의 < 자식 요소로 복사됩니다>. WCF 어댑터를 사용하여 SOAP 헤더에 액세스하는 방법에 대한 자세한 내용은 에서 WCF 어댑터와 함께 사용자 지정 SOAP 헤더 사용 SDK 샘플을 참조하세요 https://go.microsoft.com/fwlink/?LinkId=79960.

형식: 문자열 적용 대상: WCF-NetMsmq 송신 어댑터를 제외한 모든 WCF 어댑터

InboundNodeEncoding

WCF 수신 어댑터가 InboundBodyPathExpression에 지정된 본문 경로 식으로 식별되는 노드를 디코딩하는 데 사용하는 인코딩 유형을 지정합니다. InboundBodyLocation 속성이 UseBodyPath로 설정된 경우 이 속성이 필요합니다.

형식: 문자열 기본값: XML

적용 가능한 값은 다음과 같습니다.

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

적용 대상: WCF-NetMsmq 송신 어댑터를 제외한 모든 WCF 어댑터

IsFault

SOAP 오류 메시지 수신 여부를 나타냅니다. 이 속성은 들어오는 메시지에서 자동으로 승격됩니다.

참고

IsFault 속성은 HTTP 404(파일 또는 디렉터리를 찾을 수 없음) 오류와 같은 전송 오류에 대해 수신된 메시지를 검사 데 사용할 수 없습니다.

형식: 부울 적용 대상: WCF-NetMsmq 송신 어댑터를 제외한 모든 WCF 어댑터

LeaseTimeout

풀링된 활성 연결의 최대 수명을 지정합니다. 지정된 시간이 지난 후 현재 요청이 처리되면 연결이 닫힙니다.

WCF-NetTcp 어댑터는 NetTcpBinding 클래스를 활용하여 엔드포인트와 통신합니다. 부하 분산 시나리오에서 NetTcpBinding을 사용하는 경우 기본 임대 제한 시간을 줄이는 것이 좋습니다. NetTcpBinding을 사용할 때 부하 분산에 대한 자세한 내용은 참고 항목에서 적절한 항목을 참조하세요.

형식: 문자열 기본값: 00:05:00 적용 대상: WCF-NetTcp 수신 어댑터

MaxConcurrentCalls

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

참고

이 속성은 추적 프로필을 사용하여 BAM 기본 가져오기 데이터베이스에서 추적할 수 없습니다.

형식: 정수 기본값: 200 적용 대상: WCF-Custom 및 WCF-CustomIsolated 어댑터를 제외한 모든 WCF 수신 어댑터

MaxConnections

수신기가 응용 프로그램에서 수락되도록 대기시킬 수 있는 최대 연결 수를 지정합니다. 이 할당량 값을 초과하면 새 들어 오는 연결은 수락될 때까지 기다리지 않고 연결이 끊깁니다.

참고

이 속성은 어댑터 핸들러 속성이므로 파이프라인 구성 요소 및 오케스트레이션에서 구성할 수 없습니다.

참고

이 속성은 추적 프로필을 사용하여 BAM 기본 가져오기 데이터베이스에서 추적할 수 없습니다.

형식: 정수 기본값: 10 적용 대상: WCF-NetNamedPipe 어댑터, WCF-NetTcp 어댑터

MaxReceivedMessageSize

유선으로 수신할 수 있는 메시지의 최대 크기(헤더 포함)를 바이트 단위로 지정합니다. 메시지 크기는 각 메시지에 할당된 메모리 용량으로 제한됩니다. 이 속성을 사용하여 Dos(서비스 거부) 공격에 노출될 가능성을 줄일 수 있습니다.

형식: 정수 기본값: 65536 적용 대상:

• WCF-BasicHttp 어댑터
• WCF-WSHttp 어댑터
• WCF-NetTcp 어댑터
• WCF-NetNamedPipe 어댑터
• WCF-NetMsmq 수신 어댑터

MessageClientCredentialType

메시지 기반 보안을 사용하여 클라이언트 인증 수행에 사용할 자격 증명 유형을 지정합니다.

적용 가능한 값은 WCF 어댑터마다 다릅니다. MessageClientCredentialType 속성에 대한 자세한 내용은 WCF 어댑터의 각 WCF 어댑터에 대한 topics 방법을 참조하세요.

형식: 문자열 적용 대상:

• WCF-BasicHttp 어댑터
• WCF-WSHttp 어댑터
• WCF-NetTcp 어댑터
• WCF-NetNamedPipe 어댑터

MessageEncoding

SOAP 메시지를 인코딩하는 데 사용되는 인코더를 지정합니다.

형식: 문자열 기본값: 텍스트

적용 가능한 값:

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

적용 대상: WCF-BasicHttp 어댑터, WCF-WSHttp 어댑터

MsmqAuthenticationMode

메시지가 MSMQ 전송에 의해 인증되는 방식을 지정합니다.

형식: 문자열 기본값: WindowsDomainMsmqAuthenticationMode 속성에 적용 가능한 값에 대한 자세한 내용은 WCF-NetMsmq 전송 속성 대화 상자의MSMQ 인증 모드 속성, UI 지침 및 개발자 API 네임스페이스 참조의 보내기, 보안 탭을 참조하세요. 적용 대상: WCF-NetMsmq 어댑터

MsmqEncryptionAlgorithm

메시지 큐 관리자 간 메시지 전송 시 메시지 암호화에 사용할 알고리즘을 지정합니다. 이 속성은 MsmqProtectionLevel 속성이 EncryptAndSign으로 설정된 경우에만 사용할 수 있습니다.

형식: 문자열 기본값: RC4Stream

적용 가능한 값은 RC4Stream, AES입니다.

적용 대상: WCF-NetMsmq 어댑터

MsmqProtectionLevel

메시지가 MSMQ 전송 수준에서 보호되는 방식을 지정합니다.

형식: 문자열 기본값: 기호

적용 가능한 값은 다음과 같습니다.

• 없음: 보호 없음
• 서명: 메시지가 서명됨
• EncryptAndSign: 메시지가 암호화되고 서명됩니다. 이 보호 수준을 사용하려면 MSMQ용 Active Directory 통합을 사용하도록 설정해야 합니다.

적용 대상: WCF-NetMsmq 어댑터

MsmqSecureHashAlgorithm

메시지 다이제스트를 확인하기 위해 사용할 해시 알고리즘을 지정합니다. MsmqProtectionLevel 속성이 None으로 설정된 경우에는 이 속성을 사용할 수 없습니다.

형식: 문자열 기본값: SHA1

적용 가능한 값은 MD5, SHA1, SHA25, SHA512입니다.

적용 대상: WCF-NetMsmq 어댑터

NegotiateServiceCredential

대역 외 클라이언트에서 서비스 자격 증명을 제공하거나 협상 프로세스를 통해 서비스에서 클라이언트로 서비스 자격 증명을 가져올 수 있는지 여부를 지정합니다. 그러한 협상은 일반적인 메시지 교환에 앞서 수행됩니다.

MessageClientCredentialType 속성이 None, Username 또는 Certificate와 같으면 이 속성을 False로 설정하면 대역 외 클라이언트에서 서비스 인증서를 사용할 수 있고 클라이언트가 서비스 인증서를 지정해야 한다는 의미입니다. 이 모드는 WS-Trust 및 WS-SecureConversation을 구현하는 SOAP 스택과 상호 운용할 수 있습니다.

MessageClientCredentialType 속성이 Windows로 설정된 경우 이 속성을 False로 설정하면 Kerberos 기반 인증이 지정됩니다. 이것은 클라이언트와 서비스가 동일한 Kerberos 도메인에 속해야 함을 의미합니다. 이 모드는 Kerberos 토큰 프로필(OASIS WSS TC에서 정의) 그리고 WS-Trust 및 WS-SecureConversation을 구현하는 SOAP 스택과 상호 운용할 수 있습니다.

이 속성이 True이면 SOAP 메시지를 통해 SPNego 교환을 터널하는 .NET SOAP 협상이 발생합니다.

형식: 부울 기본값: True 적용 대상: WCF-WSHttp 어댑터

OpenTimeout

채널 열기 작업이 완료될 수 있도록 제공되는 시간 간격을 나타내는 시간 범위 값을 지정합니다.

참고

이 속성은 추적 프로필을 사용하여 BAM 기본 가져오기 데이터베이스에서 추적할 수 없습니다.

형식: 문자열 기본값: 00:01:00 적용 대상: WCF-Custom 및 WCF-CustomIsolated 어댑터를 제외한 모든 WCF 어댑터

OrderedProcessing

메시지를 순차적으로 처리할 것인지 여부를 지정합니다. 이 속성을 선택하면 이 수신 위치는 주문 배달 옵션이 로 설정된 BizTalk 메시징 또는 오케스트레이션 송신 포트와 함께 사용할 때 주문된 메시지 배달 을 수용합니다 True. 주문 배달 옵션에 대한 자세한 내용은 참고 항목에서 적절한 topics 참조하세요.

이 속성은 다음과 같은 경우에 적용됩니다.

• WCF-Custom 어댑터: BindingType 속성이 netMsmqBinding으로 설정된 경우
• WCF-Custom 어댑터: BindingType 속성이 customBinding으로 설정되고 BindingConfiguration 속성이 MSMQ와 같은 정렬된 배달을 지원하는 전송에 의존하는 사용자 지정 채널을 사용하도록 구성된 경우
• WCF-CustomIsolated 어댑터: BindingType 속성이 customBinding으로 설정되고 BindingConfiguration 속성이 정렬된 배달을 지원하는 전송에 의존하는 사용자 지정 채널을 사용하도록 구성된 경우
• WCF-NetMsmq 어댑터

형식: 문자열 기본값: False 적용 대상:

• WCF-NetMsmq 수신 어댑터
• WCF-Custom 수신 어댑터
• WCF-CustomIsolated 수신 어댑터

OutboundBodyLocation

나가는 WCF 메시지의 SOAP Body 요소에 대한 데이터 선택을 지정합니다. OutboundBodyLocation 속성을 사용하는 방법에 대한 자세한 내용은 WCF 어댑터에 대한 메시지 본문 지정을 참조하세요.

형식: 문자열 기본값: UseBodyElement

적용 가능한 값은 다음과 같습니다.

• UseBodyElement: BizTalk 메시지 본문 부분을 사용하여 보내는 메시지에 대한 SOAP Body 요소의 콘텐츠를 만듭니다.
• UseTem****plate: OutboundXMLTemplate 속성에 제공된 템플릿을 사용하여 보내는 메시지에 대한 SOAP Body 요소의 콘텐츠를 만듭니다.

적용 대상: WCF-NetMsmq 수신 어댑터를 제외한 모든 WCF 어댑터

OutboundCustomHeaders

나가는 메시지에 대한 사용자 지정 SOAP 헤더를 지정합니다. 이 속성을 사용 하는 경우 속성은 루트 요소로 헤더> 요소를 해야 < 합니다. 모든 사용자 지정 SOAP 헤더는 headers> 요소 내에 < 배치해야 합니다. 사용자 지정 SOAP 헤더 값이 빈 문자열인 경우 이 속성에 헤더></헤더> 또는 <헤더를> 할당 < 해야 합니다. WCF 어댑터에서 SOAP 헤더를 사용하는 방법에 대한 자세한 내용은 의 SDK 샘플인 WCF 어댑터와 함께 사용자 지정 SOAP 헤더 사용을 참조하세요 https://go.microsoft.com/fwlink/?LinkId=79960.

형식: 문자열 적용 대상: WCF-NetMsmq 수신 어댑터를 제외한 모든 WCF 어댑터

OutboundXmlTemplate

보내는 메시지의 SOAP 본문 요소 내용에 대한 XML 형식 템플릿을 지정합니다. OutboundBodyLocation 속성이 UseTemplate으로 설정된 경우 이 속성이 필요합니다. OutboundXMLTemplate 속성을 사용하는 방법에 대한 자세한 내용은 WCF 어댑터에 대한 메시지 본문 지정을 참조하세요.

형식: 문자열 기본값: 빈 문자열 적용 대상: WCF-NetMsmq 수신 어댑터를 제외한 모든 WCF 어댑터

암호

UseSSO 속성이 False로 설정된 경우 대상 서버에서 인증에 사용할 암호를 지정합니다.

형식: 문자열 기본값: 빈 문자열 적용 대상: WCF-NetNamedPipe 어댑터를 제외한 모든 WCF 송신 어댑터

PropagateFaultMessage

아웃바운드 처리를 진행하는 동안 보내지 못한 메시지를 라우팅할지 또는 일시 중지할지 지정합니다. 이 속성은 간청-응답 포트에 대해서만 유효합니다.

참고

이 속성은 추적 프로필을 사용하여 BAM 기본 가져오기 데이터베이스에서 추적할 수 없습니다.

형식: 부울 기본값: True

적용 가능한 값은 다음과 같습니다.

• True: 아웃바운드 처리에 실패한 메시지를 구독 애플리케이션(예: 다른 수신 포트 또는 오케스트레이션 일정)으로 라우팅합니다.
• False: 실패한 메시지를 일시 중단하고 NACK(부정 승인) 생성

적용 대상: WCF-NetMsmq 어댑터를 제외한 모든 WCF 송신 어댑터

ProxyAddress

프록시 서버의 주소를 지정합니다. 보안 구성에 따라 https 또는 http 체계를 사용합니다. 이 주소 뒤에는 콜론과 포트 번호가 나올 수 있습니다. ProxyToUse 속성이 UserSpecified로 설정된 경우 속성이 필요합니다(예: http://127.0.0.1:8080).

형식: 문자열 기본값: 빈 문자열 적용 대상: WCF-BasicHttp 송신 어댑터, WCF-WSHttp 송신 어댑터

ProxyPassword

ProxyAddress 속성에 지정된 프록시 서버에 사용할 암호를 지정합니다.

형식: 문자열 기본값: 빈 문자열 적용 대상: WCF-BasicHttp 송신 어댑터, WCF-WSHttp 송신 어댑터

ProxyToUse

나가는 HTTP 트래픽에 사용할 프록시 서버를 지정합니다.

형식: 문자열 기본값: 없음

적용 가능한 값은 다음과 같습니다.

• 없음: 이 송신 포트에 프록시 서버를 사용하지 마세요.
• 기본값: 이 송신 포트를 호스트하는 송신 처리기에서 프록시 설정을 사용합니다.
• UserSpecified: ProxyAddress 속성에 지정된 프록시 서버를 사용합니다.

적용 대상: WCF-BasicHttp 송신 어댑터, WCF-WSHttp 송신 어댑터

ProxyUserName

ProxyAddress 속성에 지정된 프록시 서버에 사용할 사용자 이름을 지정합니다. ProxyToUse 속성이 UserSpecified로 설정된 경우 속성이 필요합니다.

이 속성에 대한 자세한 내용은 WCF-WSHttp 송신 포트 구성 및 WCF-BasicHttp 송신 포트 구성을 참조하세요.

형식: 문자열 적용 대상: WCF-BasicHttp 송신 어댑터, WCF-WSHttp 송신 어댑터

ReplyToAddress

요청-응답 수신 위치를 통해 받은 들어오는 메시지에 해당하는 나가는 WCF 메시지의 회신 엔드포인트 주소를 나타냅니다. 이 속성은 들어오는 메시지에서 자동으로 승격됩니다.

형식: 문자열 기본값: 빈 문자열 적용 대상: WCF-NetMsmq 어댑터를 제외한 모든 WCF 어댑터

SecurityMode

사용할 보안 유형을 지정합니다. 적용 가능한 값은 WCF 어댑터마다 다릅니다. SecurityMode 속성에 대한 자세한 내용은 WCF 어댑터의 각 WCF 어댑터에 대한 topics 방법을 참조하세요.

참고

이 속성은 추적 프로필을 사용하여 BAM 기본 가져오기 데이터베이스에서 추적할 수 없습니다.

형식: 문자열 적용 대상: WCF-Custom 및 WCF-CustomIsolated 어댑터를 제외한 모든 WCF 어댑터

SendTimeout

송신 작업이 완료될 수 있도록 제공되는 시간 간격을 나타내는 시간 범위 값을 지정합니다. 이 값은 해당 송신 작업에서 큰 메시지를 보내는 경우에도 전체 상호 작용을 완료하는 데 필요한 시간 범위를 지정합니다.

형식: 문자열 기본값: 00:01:00 적용 대상: WCF-Custom 및 WCF-CustomIsolated 어댑터를 제외한 모든 WCF 어댑터

ServiceBehaviorConfiguration

serviceBehaviors> 요소의<동작> 요소를 사용하여< XML 문자열을 지정하여 WCF 서비스의 동작 설정을 구성합니다. serviceBehaviors> 요소에< 대한 자세한 내용은 참고 항목에서 해당 항목을 참조하세요.

예제:

<behavior name="SampleServiceBehavior">
<serviceAuthorization principalPermissionMode="UseAspNetRoles"/>
<serviceCredentials>
<serviceCertificate findValue="539d9ab3089bb6dc187fa7dbb382cf01f8d78f5f" storeLocation="CurrentUser" x509FindType="FindByThumbprint"/>
</serviceCredentials>
<serviceMetadata httpGetEnabled="true"/>
</behavior>

형식: 문자열 기본값: 빈 문자열 적용 대상: WCF-Custom 수신 어댑터, WCF-CustomIsolated 어댑터

ServiceCertificate

이 속성을 수신 위치에 사용하는 경우 클라이언트에서 서비스를 인증하는 데 사용할 수신 위치에 대한 X.509 인증서의 손 도장(Thumbprint)을 지정합니다. 이 속성에 사용할 인증서는 현재 사용자 위치의 내 저장소에 설치해야 합니다.

이 속성을 송신 포트에 사용하는 경우 해당 송신 포트에서 메시지를 보내는 대상 서비스를 인증하는 데 사용할 X.509 인증서의 손 도장(Thumbprint)을 지정합니다. 이 속성에 사용할 인증서는 로컬 컴퓨터 위치의 기타 사람 저장소에 설치해야 합니다.

형식: 문자열 기본값: 빈 문자열 적용 대상:

• WCF-BasicHttp 어댑터
• WCF-NetMsmq 어댑터
• WCF-WSHttp 어댑터
• WCF-NetTcp 수신 어댑터

SuspendMessageOnFailure

수신 파이프라인 오류 또는 라우팅 오류로 인해 인바운드 처리되지 못한 요청 메시지를 일시 중단할지 여부를 지정합니다.

형식: 부울 기본값: True 적용 대상: 모든 WCF 수신 어댑터

TextEncoding

MessageEncoding 속성이 Text로 설정된 경우 바인딩에서 메시지를 내보내는 데 사용할 문자 집합 인 코딩을 지정 합니다.

참고

이 속성은 추적 프로필을 사용하여 BAM 기본 가져오기 데이터베이스에서 추적할 수 없습니다.

형식: 문자열 기본값: utf-8

적용 가능한 값은 다음과 같습니다.

• unicodeFFF: 유니코드 BigEndian 인코딩
• utf-16: 16비트 인코딩
• utf-8: 8비트 인코딩

적용 대상: WCF-BasicHttp 어댑터, WCF-WSHttp 어댑터

timeToLive

메시지가 만료되어 배달 못한 편지 큐에 배치되기까지 메시지 유효 기간의 시간 범위를 지정합니다. 이 속성은 시간이 중요한 메시지가 송신 포트에서 처리되기 전에 기한이 지나지 않도록 하기 위해 설정됩니다. 이 송신 포트에서 지정된 시간 간격 내에 처리하지 않은 큐의 메시지는 만료된 것으로 간주됩니다. 만료된 메시지는 배달 못한 편지 큐라는 특수 큐로 전송됩니다. 배달 못한 편지 큐의 위치는 DeadLetterQueue 속성으로 설정됩니다.

형식: 문자열 기본값: 1.00:00:00 적용 대상: WCF-NetMsmq 송신 어댑터

대상

WCF 송신 포트에서 보내는 나가는 WCF 메시지의 대상 엔드포인트 주소를 지정합니다.

형식: 문자열 기본값: 빈 문자열 적용 대상: 모든 WCF 송신 어댑터

TransactionProtocol

이 바인딩에 사용할 트랜잭션 프로토콜을 지정합니다. EnableTransaction 속성이 True로 설정된 경우 이 속성이 필요합니다.

형식: 문자열 기본값: OleTransaction

적용 가능한 값은 OleTransaction, WS-AtomicTransaction

적용 대상: WCF-NetNamedPipe 어댑터, WCF-NetTcp 어댑터

TransportClientCredentialType

송신 포트 인증을 수행할 때 사용할 자격 증명 유형을 지정합니다. 적용 가능한 값은 WCF 어댑터마다 다릅니다. TransportClientCredentialType 속성에 대한 자세한 내용은 WCF 어댑터의 각 WCF 어댑터에 대한 topics 방법을 참조하세요.

형식: 문자열 적용 대상: WCF-Basic 어댑터, WCF-NetTcp 어댑터, WCF-WSHttp 어댑터

TransportProtectionLevel

TCP 전송 수준에서 보안을 지정합니다. 메시지에 서명하면 전송 중인 메시지를 제3자가 손상할 위험을 줄일 수 있습니다. 암호화는 전송 중에 데이터 수준에서 개인 정보를 보호합니다.

형식: 문자열 기본값: EncryptAndSign

적용 가능한 값은 다음과 같습니다.

• 없음: 보호 없음
• 서명: 메시지가 서명됨
• EncryptAndSign: 메시지가 암호화 및 서명됨

적용 대상: WCF-NetTcp 어댑터, WCF-NetNamedPipe 어댑터

UserName

UseSSO 속성이 False로 설정된 경우 대상 서버에서 인증에 사용할 사용자 이름을 지정합니다. 이 속성에 대해 도메인\사용자 형식을 사용하지 않아도 됩니다.

형식: 문자열 기본값: 빈 문자열 적용 대상: WCF-NetNamedPipe 어댑터를 제외한 모든 WCF 송신 어댑터

UseSourceJournal

이 송신 포트에서 처리한 메시지 복사본을 소스 저널 큐에 저장할지 여부를 지정합니다.

형식: 부울 기본값: False 적용 대상: WCF-NetMsmq 송신 어댑터

UseSSO

대상 서버 인증을 위한 클라이언트 자격 증명을 검색하는 데 Single Sign-On을 사용할지 여부를 지정합니다.

참고 추적 프로필이 있는 BAM 기본 가져오기 데이터베이스에서는 이 속성을 추적할 수 없습니다.

형식: 부울 기본값: False 적용 대상: WCF-NetNamedPipe 어댑터를 제외한 모든 WCF 송신 어댑터

ReferencedBindings

wsFederationHttpBinding 및 customBinding에 대한 발급자> 요소의<bindingConfiguration 특성에서 참조하는 바인딩 구성을 지정합니다. 이는 보안 토큰을 발급하는 STS(보안 토큰 서비스)를 나타냅니다. 발급자> 요소에< 대한 자세한 내용은 의 "<발급자>" 항목을 참조하세요https://go.microsoft.com/fwlink/?LinkId=83476.

wsFederationHttpBinding 및 customBinding에 대한 발급자> 요소를 포함한< 바인딩 정보는 WCF-Custom 및 WCF-CustomIsolated 어댑터의 BindingConfiguration 속성을 통해 구성할 수 있습니다. 이 속성에 대해 참조된 모든 바인딩 구성은 bindings> 요소 형식으로< 배치해야 합니다.

참고

발급자> 요소의<bindingConfiguration 특성은 이 속성에서 유효한 바인딩 이름을 참조해야 합니다.

참고

참조된 바인딩 구성의 발급자> 요소는 이 참조 체인이 순환 종속성을 만들지 않는 경우 이 속성의 다른 바인딩 구성을 참조할 수도 있습니다.<

예제:

WCF.BindingConfiguration = @"<wsFederationHttpBinding>
<binding name=""sampleBinding"">
<security mode=""Message"">
<message issuedKeyType=""AsymmetricKey"">
<issuer address=""http://www.contoso.com/samplests"" binding=""wsFederationHttpBinding"" bindingConfiguration=""**contosoSTSBinding**""/>
</message>
</security>
</binding>
</wsFederationHttpBinding>";
WCF.ReferencedBinding =@"<bindings>
<wsFederationHttpBinding>
<binding name=""**contosoSTSBinding**"">
<security mode=""Message"">
<message negotiateServiceCredential=""false"">
<issuer address=""https://northwind.com/samplests"" bindingConfiguration=""**northwindBinding**"" binding=""wsHttpBinding"">
</issuer>
</message>
</security>
</binding>
</wsFederationHttpBinding>
<wsHttpBinding>
<binding name=""**northwindBinding**"">
<security mode=""Message"">
<message clientCredentialType=""Certificate""/>
</security>
</binding>
</wsHttpBinding>
</bindings>"

참고

ReferencedBinding 속성에는 BindingConfiguration 속성에 사용되는 바인딩 구성이 포함되어서는 안됩니다.

형식: 문자열 기본값: 빈 문자열 적용 대상: WCF-Custom 어댑터, WCF-CustomIsolated 어댑터

참고 항목

endpointBehaviors<>>의 <WCF 어댑터<동작>ServiceBehaviors>메시지 부하 분산의 순서가 지정된 배달 동작><<