WCF-NetTcpRelay 适配器

Microsoft BizTalk Server使用 WCF-NetTcpRelay 适配器通过 NetTcpRelayBinding 类接收和发送 WCF 服务请求。

本主题列出了使用 BizTalk Server 管理控制台配置 WCF-NetTcpRelay 接收位置和发送端口的步骤。

准备阶段

从 BizTalk Server 2016 开始，此适配器可以使用 访问控制 服务 (ACS) 或共享访问签名 (SAS) 来连接服务总线。 建议在使用服务总线进行身份验证时使用共享访问签名 (SAS) 。

创建服务总线命名空间时，不会自动创建访问控制 (ACS) 命名空间。 如果使用 ACS 进行身份验证，则可能需要创建新的 ACS 命名空间。 有关更多详细信息，包括检索 ACS 密钥值的步骤，请参阅 SB-Messaging 适配器 。

创建接收位置

注意

在完成以下过程之前，必须已添加单向接收端口。 请参阅 如何创建接收端口。

1. 在 BizTalk 管理控制台中，依次展开“BizTalk Server管理”、“BizTalk 组”和“应用程序”，然后展开要在其中创建接收位置的应用程序。

2. 在 BizTalk 管理控制台的左窗格中，单击“接收端口” 节点。 随后，在右窗格中右键单击与现有接收位置关联的接收端口或要与新接收位置关联的接收端口，然后单击“属性” 。

3. 在“接收端口属性” 对话框的左窗格中，选择“接收位置” ，然后在右窗格中双击现有的接收位置或单击“新建” 以创建新的接收位置。

4. 在“接收位置属性” 对话框的“传输” 部分中，从“类型” 下拉列表中选择“WCF-NetTcpRelay” ，然后单击“配置” 以配置接收位置的传输属性。

5. 在“WCF-NetTcpRelay 传输属性” 对话框中的“常规” 选项卡上，为 WCF-NetTcpRelay 接收位置配置终结点地址和终结点标识。

   使用此选项	要执行此操作
   地址(URI)	必需。 指定此接收位置的完全限定 URI。 此 URI 通常采用以下格式： sb://<Namespace>.servicebus.windows.net/
   终结点标识	可选。 指定终结点标识。 通过这些设置，终结点可对此接收位置进行验证。 在终结点与接收位置进行握手的过程中，Windows Communication Foundation (WCF) 基础结构将确保终结点的标识与此元素的值保持一致。 最小长度：0 最大长度：32767 默认值为空字符串。

6. 在“WCF-NetTcpRelay 传输属性” 对话框中的“绑定” 选项卡上，配置超时和事务属性。

   使用此选项	要执行此操作
   打开超时 (hh:mmss)	指定一个时间跨度值来表示为完成信道打开操作提供的时间间隔。 此值应大于或等于 System.TimeSpan.Zero。 默认值：00:01:00 最大值：23：59：59
   发送超时 (hh:mmss)	指定一个时间跨度值来表示为完成发送操作提供的时间间隔。 此值应大于或等于 System.TimeSpan.Zero。 如果使用请求-响应接收端口，则此值指定完成整个交互的时间跨度（即使客户端返回一条大消息）。 默认值：00:01:00 最大值：23：59：59
   关闭超时值 (hh:mmss)	指定一个时间跨度值来表示为完成信道关闭操作提供的时间间隔。 此值应大于或等于 System.TimeSpan.Zero。 默认值：00:01:00 最大值：23：59：59
   已接收消息的最大字节数	指定网络上可接收的消息的最大大小（包括标头），以字节表示。 消息的大小受为每条消息分配的内存量的限制。 你可以使用此属性来降低受拒绝服务 (DoS) 攻击的可能性。 WCF-NetTcpRelay 适配器在缓冲传输模式中利用 NetTcpRelayBinding 类与终结点进行通信。 对于缓冲传输模式， NetTcpRelayBindingBase.MaxBufferSize 属性始终等于此属性的值。 默认值：65536 最大值：2147483647
   最大并行调用数	指定针对单个服务实例的并发调用的数目。 超出此限制的调用将在队列中排队。 将此值设置为 0 等效于将其设置为 Int32.MaxValue。 默认值：200

7. 在“WCF-NetTcpRelay 传输属性” 对话框中的“安全性” 选项卡上，定义 WCF-NetTcpRelay 接收位置的安全功能。

   使用此选项	要执行此操作
   安全模式	指定使用的安全类型。 有效值包括以下值： - 无：传输期间不保护消息。 - 传输：使用 TLS over TCP 或 SPNego 提供传输安全性。 可以使用此模式控制保护级别。 如果在此安全模式中为“传输客户端凭据类型” 属性选择“无” 或“证书” ，则需要通过“服务证书 - 指纹” 属性提供此接收位置的服务证书。 - 消息：使用 SOAP 消息安全性提供安全性。 默认情况下，SOAP 正文 已加密并签名。 这种模式提供了多种功能，例如，服务凭据是否可用于带外客户端以及要使用的算法套件。 如果在此安全模式中为“消息客户端凭据类型” 属性选择“无” 、“用户名” 或“证书” ，则必须通过“服务证书 - 指纹” 属性提供此接收位置的服务证书。 - TransportWithMessageCredential：传输安全性与消息安全性相结合。 传输安全性由 TLS over TCP 或 SPNego 提供，可确保完整性、机密性和服务器身份验证。 如果在此安全模式中为“消息客户端凭据类型” 属性选择“Windows” 、“用户名” 或“证书” ，则需要通过“服务证书 - 指纹” 属性提供此接收位置的服务证书。 注意： 此安全模式不能与 传输客户端凭据类型 属性 None 一起使用。 默认值为“传输” 。
   传输保护级别	定义 TCP 传输一级的安全性。 消息签名降低了在消息传输过程中第三方对消息进行篡改的风险。 加密为传输过程提供了数据级保密功能。 有效值包括以下值： - 无：无保护。 - 签名：对消息进行签名。 - EncryptAndSign：对消息进行加密和签名。 默认值为 EncryptAndSign。
   消息客户端凭据类型	指定使用基于消息的安全性对客户端执行验证时所用的凭据类型。 仅当“安全模式” 设置为 消息 或 TransportWithMessageCredential时，才需执行此步骤。 有效值包括以下值： - 无：这允许服务与匿名客户端交互。 这表示此客户端不提供任何客户端凭据。 - Windows：允许 SOAP 交换在 Windows 凭据的经过身份验证的上下文下。 客户端凭据是使用 WSS SOAP Message Security Kerberos Token Profile 1.0 协议通过 SOAP“标头” 元素传递的。 你必须创建与客户端凭据对应的域或本地用户帐户。 此外，必须使用运行此接收处理程序的用户帐户名配置客户端的 userPrincipalName 元素。 - UserName：客户端使用 UserName 凭据对此接收位置进行身份验证。 此凭据是使用 WSS SOAP Message Security UsernameToken Profile 1.0 协议通过 SOAP Header 元素传递的。 你必须创建与客户端凭据对应的域或本地用户帐户。 -证书：客户端使用通过 服务证书 - 指纹 属性指定的客户端证书对此接收位置进行身份验证。 此凭据是使用 WSS SOAP Message Security X509 Token Profile 1.0 协议通过 SOAP Header 元素传递的。 若要验证客户端证书，必须将客户端证书的 CA 证书链安装到此计算机的“受信任根证书颁发机构”证书存储区中。 此外，你必须通过“服务证书 - 指纹” 属性为此位置提供服务证书。 默认值为 Windows。
   算法套件	指定消息加密和密钥包装算法。 这些算法与“安全策略语言”(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。
   服务证书 - 指纹	为此接收位置指定 X.509 证书的指纹，客户端利用该指纹验证服务。 使用“浏览” 按钮，导航到“当前用户” 位置中“我的” 存储，然后即可选择指纹。 注意： 对于托管此接收位置的接收处理程序，必须将服务证书安装到用户帐户的 “当前用户 ”位置。 最小长度：0 最大长度：40 默认值为空字符串。
   中继客户端身份验证类型	指定对 Service Bus 中继终结点（可通过其接收消息）进行身份验证的选项。 有效值包括以下值： - 无：无需身份验证。 - RelayAccessToken：指定此项以使用安全令牌向服务总线中继终结点授权。 默认值为“RelayAccessToken” 。
   启用服务发现	选中此复选框可指定是否在服务注册表中发布服务的行为。 - 显示名称 – 指定将服务发布到服务注册表时使用的名称。 - 发现模式 – 为服务注册表中发布的服务设置发现模式。 有关发现模式的详细信息，请参阅 https://msdn.microsoft.com/library/microsoft.servicebus.discoverytype.aspx。
   访问控制服务	适用于 BizTalk Server 2013 R2 和 BizTalk Server 2013。 如果将“中继客户端身份验证类型” 设置为“RelayAccessToken” ，请单击“编辑” 按钮，然后指定以下详细信息： - 访问控制服务 STS URI – 将此项设置为 https://<Namespace>-sb.accesscontrol.windows.net/，其中 <namespace> 是服务总线命名空间。 - 颁发者名称 – 指定颁发者名称。 通常将此值设置为 owner。 - 颁发者密钥 – 指定颁发者密钥。
   服务总线连接信息	从 2016 BizTalk Server 开始新增功能。 选择使用服务总线命名空间的共享访问签名 (SAS) 或 访问控制 服务 (ACS) 。 选择一个选项，然后选择 “编辑” 以输入密钥信息： - 共享访问签名 ：输入访问密钥名称和访问密钥。 Azure 门户中列出了这两个值。 - 访问控制服务：输入 STS URI (https://<yourNamespace>-sb.accesscontrol.windows.net/) 、颁发者名称和颁发者密钥。 使用 Windows PowerShell 检索这些值，如 SB-Messaging 适配器中所述。

8. 在“WCF-NetTcpRelay 传输属性” 对话框中的“消息” 选项卡上，为 SOAP Body 元素指定数据选择。

   使用此选项	要执行此操作
   信封 -- 整个 <soap：Envelope>	从传入消息的整个 SOAP 信封 创建 BizTalk 消息正文部分。 默认值为清除此复选框。
   Body -- soap：Body> 元素的内容<	使用传入消息的 SOAP Body 元素的内容创建 BizTalk 消息正文部分。 如果 Body 元素具有多个子元素，则只有第一个元素成为 BizTalk 消息正文部分。 这是默认设置。
   路径 -- 按正文路径定位内容	使用“正文路径表达式”文本框中的 正文路径表达式 创建 BizTalk 消息正文部分。 针对传入消息的 SOAP Body 元素的直接子元素计算正文路径表达式。 默认值为清除此复选框。
   正文路径表达式	键入正文路径表达式以标识传入消息中用于创建 BizTalk 消息正文部分的特定部分。 此正文路径表达式是针对传入消息的 SOAP Body 元素的直接子元素计算的。 如果此正文路径表达式返回多个节点，则只选择第一个节点作为 BizTalk 消息正文部分。 如果选择了 “路径 -- 按正文路径找到的内容 ”选项，则需要此属性。 键入：String 最小长度：0 最大长度：32767 默认值为空字符串。
   节点编码	指定 WCF-NetTcpRelay 接收适配器为“正文路径表达式” 文本框中正文路径表达式标识的节点进行解码所采用的编码类型。 如果选择了 “路径 -- 按正文路径找到的内容 ”选项，则需要此属性。 有效值包括以下值： - Base64：Base64 编码。 - 十六进制：十六进制编码。 - 字符串：文本编码 - UTF-8 - XML：WCF 适配器使用“ 正文 路径表达式”文本框中的正文路径表达式选择的节点的外部 XML 创建 BizTalk 消息正文。 默认值为 XML。
   正文 -- BizTalk 响应消息正文	使用 BizTalk 消息正文部件创建传出响应消息的 SOAP Body 元素的内容。 此属性仅对请求响应接收位置有效。 这是默认设置。
   模板 -- 由模板指定的内容	使用 XML 文本框中提供的模板为传出消息创建 SOAP Body 元素的内容。 此属性仅对请求响应接收位置有效。 默认值为清除此复选框。
   XML	为传出消息的 SOAP Body 元素的内容键入 XML 格式的模板。 如果选择了 “模板”-“BizTalk 响应消息正文 ”选项，则需要此属性。 此属性仅对请求响应接收位置有效。 键入：String 最小长度：0 最大长度：32767 默认值为 <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"\>。
   失败时挂起请求消息	指定是否将由于接收管道故障或路由故障而导致入站处理失败的请求消息挂起。 默认值为清除此复选框。
   在错误中包括异常详细信息	指定发生错误时是否返回 SOAP 错误以方便进行调试。 默认值为清除此复选框。

9. 单击 “确定” 。

10. 在“接收位置属性” 对话框中输入相应的值，完成对接收位置的配置，然后单击“确定” 保存设置。 有关“接收位置属性” 对话框的信息，请参阅 如何创建接收位置。

创建发送端口

1. 在 BizTalk 管理控制台中，创建一个新的发送端口或双击某个现有发送端口以对其进行修改。 有关详细信息，请参阅 如何创建发送端口。 配置所有发送端口选项，并在“常规”选项卡的“传输”部分中为“类型”选项指定 WCF-NetTcpRelay。

2. 在“ 常规 ”选项卡上的“ 传输 ”部分中，单击“ 配置 ”按钮。

3. 在 “WCF-NetTcpRelay 传输属性 ”对话框中的“ 常规 ”选项卡上，指定以下内容：

   使用此选项	要执行此操作
   地址(URI)	必需。 指定发送端口的完全限定 URI。 此 URI 通常采用以下格式： sb://<Namespace>.servicebus.windows.net/ 最大长度：255 默认值：net.tcp：//localhost/
   终结点标识	可选。 指定此发送端口将消息发送到的终结点的标识。 这些设置使此发送端口能够对终结点进行身份验证。 在终结点和发送端口之间的握手过程中，Windows Communication Foundation (WCF) 基础结构将确保终结点的标识与此元素的值匹配。 可为 终结点标识 属性指定的值因安全配置而异。 默认值为清除此复选框。
   操作	为传出消息指定 SOAP 操作 标头字段。 还可以通过消息上下文属性 WCF 设置此属性 。 管道或业务流程中的操作。 可以通过两种不同的方式指定此值：单个操作格式和操作映射格式。 如果以单个操作格式（例如 ）设置此属性， http://contoso.com/Svc/Op1则传出消息的 SOAPAction 标头始终设置为此属性中指定的值。 如果以操作映射格式设置此属性，则传出 SOAPAction 标头由 BTS 确定。操作 上下文属性。 例如，如果此属性设置为以下 XML 格式和 BTS。Operation 属性设置为 Op1，WCF 发送适配器将用于 http://contoso.com/Svc/Op1 传出 SOAPAction 标头。 <BtsActionMapping> <Operation Name="Op1" Action="http://contoso.com/Svc/Op1" /> <Operation Name="Op2" Action="http://contoso.com/Svc/Op2" /> </BtsActionMapping> 如果传出消息来自业务流程端口，则业务流程实例会动态设置 BTS。具有 端口的操作名称的 Operation 属性。 如果传出消息使用基于内容的路由进行路由，则可以设置 BTS。 管道组件中的操作属性。 最小长度：0 最大长度：32767 默认值为空字符串。

4. 在“WCF-NetTcpRelay 传输属性” 对话框中的“绑定” 选项卡上，配置超时和事务属性。

   使用此选项	要执行此操作
   打开超时 (hh:mmss)	指定一个时间跨度值来表示为完成信道打开操作提供的时间间隔。 此值应大于或等于 System.TimeSpan.Zero。 默认值：00:01:00 最大值：23：59：59
   发送超时 (hh:mmss)	指定一个时间跨度值来表示为完成发送操作提供的时间间隔。 此值应大于或等于 System.TimeSpan.Zero。 如果使用要求-响应发送端口，则此值指定完成整个交互的时间跨度（即使服务返回一条大消息）。 默认值：00:01:00 最大值：23：59：59
   关闭超时值 (hh:mmss)	指定一个时间跨度值来表示为完成信道关闭操作提供的时间间隔。 此值应大于或等于 System.TimeSpan.Zero。 默认值：00:01:00 最大值：23：59：59
   已接收消息的最大字节数	指定网络上可接收的消息的最大大小（包括标头），以字节表示。 消息的大小受为每条消息分配的内存量的限制。 你可以使用此属性来降低受拒绝服务 (DoS) 攻击的可能性。 WCF-NetTcpRelay 适配器在缓冲传输模式中利用 NetTcpRelayBinding 类与终结点进行通信。 对于缓冲传输模式， NetTcpRelayBindingBase.MaxBufferSize 属性始终等于此属性的值。 默认值：65536 最大值：2147483647

5. 在 “WCF-NetTcpRelay 传输属性 ”对话框中的“ 安全性 ”选项卡上，定义 WCF-NetTcpRelay 发送端口的安全功能。

   使用此选项	要执行此操作
   安全模式	指定使用的安全类型。 有效值包括以下值： - 无：传输期间不保护消息。 - 传输：使用 TLS over TCP 或 SPNego 提供传输安全性。 可以使用此模式控制保护级别。 - 消息：使用 SOAP 消息安全性提供安全性。 默认情况下，SOAP 正文 已加密并签名。 这种模式提供了多种功能，例如，服务凭据是否可用于带外客户端以及要使用的算法套件。 - TransportWithMessageCredential：传输安全性与消息安全性相结合。 传输安全性由 TCP 或 SPNego的 TLS 提供，可确保完整性、机密性和服务器身份验证。 SOAP 消息安全性提供客户端身份验证。 若要使用此模式，必须将服务的 X.509 证书的 CA 证书链安装到此计算机的“受信任根证书颁发机构”证书存储区中，以便向发送端口验证该服务。 注意： 此安全模式不能与 传输客户端凭据类型 属性 None 一起使用。 默认值为“传输” 。
   传输保护级别	定义 TCP 传输一级的安全性。 消息签名降低了在消息传输过程中第三方对消息进行篡改的风险。 加密为传输过程提供了数据级保密功能。 有效值包括以下值： - 无：无保护。 - 签名：对消息进行签名。 - EncryptAndSign：对消息进行加密和签名。 默认值为 EncryptAndSign。
   消息客户端凭据类型	指定使用基于消息的安全性对客户端执行验证时所用的凭据类型。 仅当“安全模式” 设置为 消息 或 TransportWithMessageCredential时，才需执行此步骤。 有效值包括以下值： - 无：这允许服务与匿名客户端交互。 这表示此发送端口不提供任何客户端凭据。 必须将服务 X.509 证书的 CA 证书链安装到此计算机的“受信任根证书颁发机构”证书存储区中，以便向发送端口验证该服务。 - Windows：允许 SOAP 交换在 Windows 凭据的经过身份验证的上下文下。 服务使用运行此发送端口的用户帐户来验证此发送端口。 客户端凭据是使用 WSS SOAP Message Security Kerberos Token Profile 1.0 协议通过 SOAP“标头” 元素传递的。 必须使用“标识编辑器”对话框将“用户主体名称”属性配置为运行目标服务的用户帐户名。 - UserName：此发送端口使用 UserName 凭据向服务进行身份验证。 此凭据是使用 WSS SOAP Message Security UsernameToken Profile 1.0 协议通过 SOAP Header 元素传递的。 此选项需要配置 客户端凭据 属性。 必须将服务 X.509 证书的 CA 证书链安装到此计算机的“受信任根证书颁发机构”证书存储区中，以便向发送端口验证该服务。 - 证书：此发送端口使用通过客户端证书 - 指纹属性指定的客户端证书 对服务进行身份验证。 此凭据是使用 WSS SOAP Message Security X509 Token Profile 1.0 协议通过 SOAP Header 元素传递的。 必须将服务 X.509 证书的 CA 证书链安装到此计算机的“受信任根证书颁发机构”证书存储区中，以便向发送端口验证该服务。 默认值为 Windows。
   算法套件	指定消息加密和密钥包装算法。 这些算法与“安全策略语言”(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。
   客户端证书 - 指纹	指定向服务验证此发送端口时使用的 X.509 证书的指纹。 使用“浏览” 按钮，导航到“当前用户” 位置中“我的” 存储，然后即可选择指纹。 注意： 对于托管此发送端口的发送处理程序，必须将客户端证书安装到用户帐户的 “当前用户 ”位置。 最小长度：0 最大长度：40 默认值为空字符串。
   用户名凭据	将 UserName 用于 Message 客户端凭据类型 属性时，指定用于发送消息的凭据。 可以通过单击“ 编辑凭据” 按钮来指定属性。 默认值为 “不使用单一登录”。
   使用 ACS 服务标识	适用于 BizTalk Server 2013 R2 和 BizTalk Server 2013。 选中此复选框并单击“ 编辑 ”，并提供以下值以向服务总线进行身份验证。 - 访问控制服务 STS URI – 将此项设置为 https://<Namespace>-sb.accesscontrol.windows.net/，其中 <namespace> 是服务总线命名空间。 - 颁发者名称 – 指定颁发者名称。 通常将此值设置为 owner。 - 颁发者密钥 – 指定颁发者密钥。
   服务总线连接信息	从 2016 BizTalk Server 开始新增功能。 选择使用服务总线命名空间的共享访问签名 (SAS) 或 访问控制 服务 (ACS) 。 选择一个选项，然后选择 “编辑” 以输入密钥信息： - 共享访问签名 ：输入访问密钥名称和访问密钥。 Azure 门户中列出了这两个值。 - 访问控制服务：输入 STS URI (https://<yourNamespace>-sb.accesscontrol.windows.net/) 、颁发者名称和颁发者密钥。 使用 Windows PowerShell 检索这些值，如 SB-Messaging 适配器中所述。

6. 在“WCF-NetTcpRelay 传输属性” 对话框中的“消息” 选项卡上，为 SOAP Body 元素指定数据选择。

   使用此选项	要执行此操作
   正文 -- BizTalk 请求消息正文	使用 BizTalk 消息正文部件为传出消息创建 SOAP Body 元素的内容。 这是默认设置。
   模板 -- 由模板指定的内容	使用 XML 文本框中提供的模板为传出消息创建 SOAP Body 元素的内容。 默认值为清除此复选框。
   XML	为传出消息的 SOAP Body 元素的内容键入 XML 格式的模板。 如果选择了 “模板”-“BizTalk 响应消息正文 ”选项，则需要此属性。 键入：String 最小长度：0 最大长度：32767 默认值为 <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/>
   信封 -- 整个 <soap：Envelope>	从传入的整个 SOAP 信封 创建 BizTalk 消息正文部分。 此属性仅对要求-响应端口有效。 默认值为清除此复选框。
   Body -- soap：Body> 元素的内容<	使用传入消息的 SOAP Body 元素的内容创建 BizTalk 消息正文部分。 如果 Body 元素具有多个子元素，则只有第一个元素成为 BizTalk 消息正文部分。 此属性仅对要求-响应端口有效。 这是默认设置。
   路径 -- 按正文路径定位内容	使用“正文路径表达式”文本框中的 正文路径表达式 创建 BizTalk 消息正文部件。 针对传入消息的 SOAP Body 元素的直接子元素计算正文路径表达式。 此属性仅对要求-响应端口有效。 默认值为清除此复选框。
   正文路径表达式	键入正文路径表达式以标识传入消息中用于创建 BizTalk 消息正文部分的特定部分。 此正文路径表达式是针对传入消息的 SOAP 正文 节点的直接子元素计算的。 如果此正文路径表达式返回多个节点，则只选择第一个节点作为 BizTalk 消息正文部分。 如果选择了 “路径 -- 按正文路径找到的内容 ”选项，则此属性是必需的。 此属性仅对要求-响应端口有效。 键入：String 最小长度：0 最大长度：32767 默认值为空字符串。
   节点编码	指定 WCF-NetTcpRelay 发送适配器用于在“正文路径表达式”文本框中解码由正文路径表达式标识的节点 的 编码类型。 如果选择了 “路径 -- 按正文路径找到的内容 ”选项，则此属性是必需的。 此属性仅对要求-响应端口有效。 有效值包括以下值： - Base64：Base64 编码。 - 十六进制：十六进制编码。 - 字符串：文本编码 - UTF-8 - XML：WCF 适配器使用“正文路径表达式”文本框中的正文路径表达式选择的节点的外部 XML 创建 BizTalk 消息正文 。 默认值为 XML。
   传播故障消息	选中此复选框可将无法执行出站处理的消息路由至某个订阅应用程序（例如其他接收端口或业务流程计划）。 清除此复选框可挂起失败的消息，并生成一个否定确认 (NACK)。 此属性仅对要求-响应端口有效。 默认值为选中此复选框。

7. 再次单击“确定”和“确定”以保存设置。

在处理程序中设置 MaxConnections

1. 在BizTalk Server管理控制台中，依次展开“BizTalk Server管理”、“BizTalk 组”、“平台设置”和“适配器”。

2. 在适配器列表中，选择 “WCF-NetTcpRelay”，然后选择发送或接收处理程序。

3. 在 “适配器处理程序属性”的“ 常规 ”选项卡上，选择“ 属性”。

4. 在 处理程序 选项卡中：

   使用此选项	要执行此操作
   最大连接数	指定 (接收处理程序) 的最大入站连接数和出站连接数， (在连接池中缓存的每个终结点发送处理程序) 。 这限制了为每个唯一远程终结点缓存的连接数。 对于每个唯一的远程终结点，你应该将此值设置为一个大于最大期望缓存连接数的值。 如果活动连接数超过此最大值，则服务可能会对此发送接手下运行的 WCF-NetTcpRelay 发送端口无响应。 默认值为 10。

5. 选择“确定”，保存所做更改。

另请参阅

SB-消息适配器

使用适配器