WCF-BasicHttp 适配器

Microsoft BizTalk Server 使用 WCF-BasicHttp 适配器通过 BasicHttpBinding 类接收和发送 WCF 服务请求。 WCF-BasicHttp 适配器使你可以将业务流程和架构发布为 WCF 服务,并使用 BasicHttpBinding 的外部 WCF 服务。

可以使用 WCF-BasicHttp 适配器与符合 WS-I 基本配置文件 1.1 的旧版 ASMX Web 服务和客户端进行跨计算机通信,使用 HTTP 或 HTTPS 传输和文本编码。 但是,你将无法利用 WS-* 协议支持的功能。

下表总结了 WCF-BasicHttp 适配器的特征:

DESCRIPTION 特征
互作性级别 基础资料
邮件编码 文本或 MTOM
边界 跨计算机
传输协议 HTTP 或 HTTPS
安全模式 None、Message、Transport、TransportWithMessageCredential 和 TransportCredentialOnly
客户端身份验证机制 传输安全和消息安全
支持 WS-ReliableMessaging
支持 WS-AtomicTransaction
支持单向消息传送 是的
支持双向消息传送 是的
接收适配器的主机类型 孤立
发送适配器的主机类型 进程内

WCF-BasicHttp 适配器由两个适配器组成,即接收适配器和发送适配器。

本主题介绍如何使用 BizTalk 管理创建接收位置和发送端口。 还可以 创建接收位置并以编程方式发送端口

在您开始之前

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

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

  • 在以下方案中,WCF-BasicHttp 适配器优先于 SOAP 适配器:

    • WCF 适配器每秒文档的速率通常优于 SOAP 适配器。
    • SOAP 适配器在 .NET 类型和原始 XML 数据之间序列化和反序列化消息的缺点是,在某些情况下,可能会导致意外的数据修改。 WCF 适配器采用保留数据流的方法。
    • WCF 适配器发布本质上与 BizTalk 运行时中使用的架构相同的架构。 相比之下,SOAP 适配器返回通过反射. NET 类生成的元数据,以表示架构。 由于 .NET 不保留 XSD 架构的所有细微差别,因此公开的 WSDL 可能无法准确反映 BizTalk 运行时使用的架构。
    • 如果需要,可以更轻松地从 WCF-BasicHttp 迁移到 WCF-WSHttp。
  • 使用 WCF-BasicHttp 接收适配器通过 HTTP 或 HTTPS 协议接收 WCF 服务请求。 使用 WCF-BasicHttp 发送适配器通过无类型契约使用 HTTP 或 HTTPS 协议调用 WCF 服务。

创建接收位置

可以将此接收位置配置为单向或请求-响应(双向)。

注释

在完成以下步骤之前,必须已添加接收端口。 请参阅 如何创建接收端口

还可以 以编程方式创建接收位置

  1. 在 BizTalk 管理控制台中,展开 BizTalk Server 管理BizTalk 组应用程序,然后展开要在其中创建接收位置的应用程序。

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

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

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

  5. WCF-BasicHttp 传输属性“常规 ”选项卡上,为 WCF-BasicHttp 接收位置配置终结点地址和服务标识:

    注释

    如果将 传输TransportWithMessageCredential 用于 安全模式,则必须在 Microsoft Internet Information Services (IIS) 中设置安全套接字层 (SSL)。

    用这个 要执行的操作
    地址(URI) 必填。 指定此接收位置的 URI。 指定虚拟目录以及 BizTalk WCF 服务发布向导生成的 .svc 文件名,例如 /path/service.svc。

    默认值: /

    最小长度:1

    最大长度:255
    终结点标识 可选。 通过单击 “编辑” 按钮指定此接收位置提供的服务的标识。 可以为 Endpoint Identity 属性指定的值因安全配置而异。 这些设置使客户端能够对此接收位置进行身份验证。 在客户端和服务之间的握手过程中,Windows Communication Foundation (WCF) 基础结构将确保预期服务的标识与此元素的值匹配。

    默认值为空字符串。

    最小长度:0

    最大长度:32767
  6. “WCF-BasicHttp 传输属性 ”对话框中的“ 绑定 ”选项卡上,配置超时和编码属性:

    用这个 要执行的操作
    打开超时 (hh:mmss) 指定一个时间跨度值,该值表示完成通道打开操作所提供的时间间隔。 此值应大于或等于 System.TimeSpan.Zero

    默认值:00:01:00

    最大值:23:59:59
    发送超时 (hh:mmss) 指定一个时间跨度值,该值指示为发送操作完成所提供的时间间隔。 此值应大于或等于 System.TimeSpan.Zero。 如果使用请求-响应接收端口,则此值指定整个交互完成的时间跨度,即使客户端返回大型消息也是如此。

    默认值:00:01:00

    最大值:23:59:59
    关闭超时 (hh:mm:ss) 指定一个时间跨度值,该值表示为了完成通道关闭操作提供的时间间隔。 此值应大于或等于 System.TimeSpan.Zero

    默认值:00:01:00

    最大值:23:59:59
    最大接收消息大小(字节) 指定消息(包括标头)的最大大小,单位为字节,该消息可在网络上接收。 消息的大小受为每个消息分配的内存量的约束。 可以使用此属性来限制拒绝服务(DoS)攻击的暴露。

    WCF-BasicHttp 适配器利用缓冲传输模式下的 BasicHttpBinding 类与终结点通信。 对于缓冲传输模式, BasicHttpBinding.MaxBufferSize 属性始终等于此属性的值。

    默认值:65536

    最大值:2147483647
    消息编码 指定用于对 SOAP 消息进行编码的编码器。 有效值包括:

    - 文本:使用短信编码器。
    - Mtom:使用消息传输组织机制 1.0 (MTOM) 编码器。

    默认值为 Text
    文本编码 指定在 消息编码 属性设置为 Text 时用于在绑定上发出消息的字符集编码。 有效值包括:

    - utf-16BE (unicodeFFFE):Unicode BigEndian 编码。
    - utf-16:16 位编码。
    - utf-8:8位编码

    默认值为 utf-8
    最大并发调用数 指定对单个服务实例的并发调用数。 超出限制的电话调用将排队。 将此值设置为 0 等效于将其设置为 Int32.MaxValue

    默认值为 200
  7. “WCF-BasicHttp 传输属性 ”对话框中的“ 安全 ”选项卡上,定义安全功能:

    用这个 要执行的操作
    安全模式 指定所使用的安全类型。 有效值包括:

    - :传输期间不会保护消息。
    - 传输:使用 HTTPS 传输提供安全性。 SOAP 消息使用 HTTPS 进行保护。 若要使用此模式,必须在 Microsoft Internet Information Services (IIS)中设置安全套接字层(SSL)。
    - 消息:通过 HTTP 传输使用 SOAP 消息安全性提供安全性。 默认情况下,SOAP 正文 已加密并签名。 WCF-Basic 适配器的唯一有效的 消息客户端凭据类型证书。 此模式需要 HTTP 传输。 使用此安全模式时,需要通过 服务证书 - 指纹 属性提供此接收位置的服务证书。
    - TransportWithMessageCredential:完整性、机密性和服务身份验证由 HTTPS 传输提供。 若要使用此模式,必须在 Microsoft Internet Information Services (IIS)中设置安全套接字层(SSL)。
    - TransportCredentialOnly:此模式不提供消息完整性和机密性。 它提供基于 HTTP 的客户端身份验证。 应谨慎使用此模式。 它应在传输安全性由其他方式(如 IPSec)提供且只有客户端身份验证由 WCF 基础结构提供的环境中使用。 如果在此安全模式下为传输客户端凭据类型属性选择“证书”,则需要通过服务证书 - 指纹属性提供此接收位置的服务证书。

    默认值为 None
    传输层客户端凭据类型 指定执行客户端身份验证时要使用的凭据类型。 有效值包括:

    - :传输级别不会发生身份验证。
    - 基本:基本身份验证。 在基本身份验证中,用户名和密码通过网络以纯文本发送。 必须创建与凭据对应的域或本地用户帐户。
    - 摘要:摘要认证。 此身份验证方法的工作方式与基本身份验证非常类似,不同之处在于,密码通过网络作为哈希值发送,以确保额外的安全性。 摘要式身份验证仅适用于域控制器运行 Windows Server 操作系统的域。 必须创建与客户端凭据对应的域或本地用户帐户。
    - Ntlm:NTLM 身份验证。 客户端无需向此接收位置发送密码即可发送凭据。 必须创建与客户端凭据对应的域或本地用户帐户。
    - Windows:Windows 集成身份验证。 Windows Communication Foundation 会协商使用 Kerberos 或 NTLM,并且在存在域的情况下优先选择 Kerberos。 如果您想使用 Kerberos,重要的是要确保客户端用服务主体名称(SPN)来识别服务。 必须创建与客户端凭据对应的域或本地用户帐户。
    - 证书:使用客户端证书进行客户端身份验证。 客户端 X.509 证书的 CA 证书链必须安装在此计算机的受信任根证书颁发机构证书存储中,以便客户端能够向此接收位置进行身份验证。 注意:传输客户端凭据类型属性必须与承载此接收位置的 IIS 虚拟目录的身份验证方案匹配。 例如,如果属性设置为 Windows,则还需要为托管它的虚拟目录启用 集成 Windows 身份验证 。 同样,如果属性设置为 “无”,则必须允许匿名访问托管此接收位置的虚拟目录。

    默认值为 None
    消息客户端凭据类型 指定使用基于消息的安全性执行客户端身份验证时要使用的凭据类型。 有效值包括:

    - UserName:允许此接收位置要求使用 UserName 凭据对客户端进行身份验证。 必须创建与客户端凭据对应的域或本地用户帐户。
    - 证书:客户端使用客户端证书向此接收位置进行身份验证。 客户端 X.509 证书的 CA 证书链必须安装在此计算机的受信任根证书颁发机构证书存储中,以便客户端能够向此接收位置进行身份验证。

    默认值为 UserName
    算法套件 指定消息加密和密钥包装算法。 这些算法映射到安全策略语言(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

    默认值为空字符串。
    使用单一登录 使用单一命令 Sign-On 检索客户端凭据以签发单点登录 (SSO) 票证。 此选项仅适用于以下部分中列出的安全配置:“企业单一 Sign-On 的支持性”以及“WCF-BasicHttp 接收适配器”。

    清除默认值。

    企业单一 Sign-On 支持性针对 WCF-BasicHttp 接收适配器 此适配器只能在下表所示的安全配置中从 SSO 服务器发出 SSO 票证:

    安全模式 传输层客户端凭据类型 消息客户端凭据类型
    传输 基本
    传输 摘要
    传输 Ntlm
    传输 Windows操作系统
    传输 证书
    消息 UserName
    TransportWithMessageCredential UserName
    TransportCredentialOnly 基本
    TransportCredentialOnly 消化
    TransportCredentialOnly Ntlm
    TransportCredentialOnly Windows操作系统
    TransportCredentialOnly 证书
  8. “WCF-BasicHttp 传输属性 ”对话框中的“ 消息 ”选项卡上,指定 SOAP 正文 元素的数据选择:

    用这个 要执行的操作
    信封 -- 全部<soap:Envelope> 从传入消息的整个 SOAP 信封 创建 BizTalk 消息正文部分。

    清除默认值。
    Body -- <soap:Body> 元素的内容 使用传入消息的 SOAP Body 元素的内容创建 BizTalk 消息正文部件。 如果 Body 元素具有多个子元素,则只有第一个元素成为 BizTalk 消息正文部分。

    这是默认设置。
    路径 -- 按正文路径定位的内容 使用 正文路径表达式 文本框中的正文路径表达式创建 BizTalk 消息正文部件。 根据传入消息的 SOAP Body 元素的即时子元素计算正文路径表达式。

    清除默认值。
    正文路径表达式 键入正文路径表达式以标识用于创建 BizTalk 消息正文部件的传入消息的特定部分。 此正文路径表达式用于对传入消息的 SOAP Body 元素的直接子元素进行评估。 如果此正文路径表达式返回多个节点,则仅为 BizTalk 消息正文部分选择第一个节点。 如果选择了 路径 -- 根据正文路径定位的内容 选项,则此属性是必需的。

    类型:字符串

    最小长度:0

    最大长度:32767

    默认值为空字符串。
    节点编码 指定 WCF-BasicHttp 接收适配器用来解码正文路径表达式文本框中标识的节点的编码类型。

    如果选择了 路径 -- 正文路径 选项,则此属性是必需的。 有效值包括:

    - Base64:Base64 编码。
    - 十六进制:十六进制编码。
    - 字符串:文本编码 - UTF-8
    - XML:WCF 适配器使用 正文路径表达式 文本框中的正文路径表达式选择的节点外层 XML 创建 BizTalk 消息正文。

    默认值为 XML
    正文 -- BizTalk 响应消息正文 使用 BizTalk 消息正文部件创建传出响应消息的 SOAP Body 元素的内容。 此属性仅适用于请求-响应接收位置。

    这是默认设置。
    模板 - 模板指定的内容 使用 XML 文本框中提供的模板为传出消息创建 SOAP 正文 元素的内容。 此属性仅适用于请求-响应接收位置。

    清除默认值。
    XML 为传出消息的 SOAP Body 元素的内容键入 XML 格式的模板。 如果已选择 模板 -- BizTalk 响应消息正文 选项,则需要此属性。 此属性仅适用于请求-响应接收位置。

    类型:字符串

    最小长度:0

    最大长度:32767

    默认值为 <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml">
    出现故障时挂起请求消息 指定是否因接收管道故障或路由失败, 而挂起入站处理失败的请求消息。

    清除默认值。
    在故障中包含异常详细信息 指定在发生错误以方便调试时是否返回 SOAP 错误。

    清除默认值。

创建发送端口

注释

还可以 以编程方式创建发送端口

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

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

  3. “WCF-BasicHttp 传输属性 ”对话框中的“ 常规 ”选项卡上,为 WCF-BasicHttp 发送端口配置终结点地址、服务标识和 SOAPAction HTTP 标头:

    注释

    如果为 Address (URI) 属性指定 https 方案,则必须将安全模式属性配置为 TransportTransportWithMessageCredential。 可以使用 “安全 ”选项卡配置 安全模式 属性。

    用这个 要执行的操作
    地址(URI) 必填。 为此发送端口指定完全限定的 URI。 根据安全配置使用 httpshttp 方案。

    最大长度:255

    默认值:http://localhost/
    终结点标识 可选。 指定此发送端口所需的服务标识。 这些设置使此发送端口能够对服务进行身份验证。 在客户端和服务之间的握手过程中,Windows Communication Foundation (WCF) 基础结构将确保预期服务的标识与此元素的值匹配。 可以为 Identity 属性指定的值因安全配置而异。

    清除默认值。
    行动 指定传出消息的 SOAPAction HTTP 标头字段。 还可以通过管道或流程编排中的消息上下文属性 WCF.Action 设置此属性。

    可以通过两种不同的方式指定此值:单一动作格式和动作映射格式。 例如,如果在单一操作格式中设置此属性,http://contoso.com/Svc/Op1则传出消息的 SOAPAction 标头始终设置为此属性中指定的值。

    如果在动作映射格式中设置此属性,传出的 SOAPAction 标头由 BTS.Operation 上下文属性确定。 例如,如果将此属性设置为以下 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.Operation 属性。

    最小长度:0

    最大长度:32767

    默认值为空字符串。
  4. WCF-BasicHttp 传输属性中,在“ 绑定 ”选项卡上,配置超时和编码属性:

    用这个 要执行的操作
    打开超时 (hh:mmss) 指定一个时间跨度值,该值表示完成通道打开操作所提供的时间间隔。 此值应大于或等于 System.TimeSpan.Zero

    默认值:00:01:00

    最大值:23:59:59
    发送超时 (hh:mmss) 指定一个时间跨度值,该值指示为发送操作完成所提供的时间间隔。 此值应大于或等于 System.TimeSpan.Zero。 如果使用请求响应发送端口,则此值指定整个交互完成的时间跨度,即使服务返回大型消息也是如此。

    默认值:00:01:00

    最大值:23:59:59
    关闭超时 (hh:mm:ss) 指定一个时间跨度值,该值表示为了完成通道关闭操作提供的时间间隔。 此值应大于或等于 System.TimeSpan.Zero

    默认值:00:01:00

    最大值:23:59:59
    最大接收消息大小(字节) 指定消息(包括标头)的最大大小,单位为字节,该消息可在网络上接收。 消息的大小受为每个消息分配的内存量的约束。 可以使用此属性来限制拒绝服务(DoS)攻击的暴露。

    WCF-BasicHttp 适配器利用缓冲传输模式下的 BasicHttpBinding 类与终结点通信。 对于缓冲传输模式, BasicHttpBinding.MaxBufferSize 属性始终等于此属性的值。

    默认值:65536

    最大值:2147483647
    消息编码 指定用于对 SOAP 消息进行编码的编码器。 有效值包括:

    - 文本:使用短信编码器。
    - Mtom:使用消息传输组织机制 1.0 (MTOM) 编码器。

    默认值: 文本
    文本编码 指定在 消息编码 属性设置为 Text 时用于在绑定上发出消息的字符集编码。 有效值包括:

    - utf-16BE (unicodeFFFE):Unicode BigEndian 编码。
    - utf-16:16 位编码。
    - utf-8:8位编码

    默认值: utf-8
  5. “WCF-BasicHttp 传输属性 ”对话框中的“ 安全 ”选项卡上,定义 WCF-BasicHttp 发送端口的安全功能:

    用这个 要执行的操作
    安全模式 指定所使用的安全类型。 有效值包括:

    - :传输期间不会保护消息。
    - 传输:使用 HTTPS 传输提供安全性。 SOAP 消息使用 HTTPS 进行保护。 服务的 X.509 证书的 CA 证书链必须安装在此计算机的受信任根证书颁发机构证书存储中,以便可以使用服务的证书向发送端口进行身份验证。
    - 消息:使用 SOAP 消息安全性提供安全性。 默认情况下,SOAP Body 元素已加密并签名。 WCF-BasicHttp 发送适配器的唯一有效的 消息客户端凭据类型证书。 此模式需要 HTTP 传输。
    - TransportWithMessageCredential:完整性、机密性和服务身份验证由 HTTPS 传输提供。 服务的 X.509 证书的 CA 证书链必须安装在此计算机上的受信任的根证书颁发机构证书存储中,以便可以使用服务的证书向发送端口进行身份验证。 发送端口身份验证由 SOAP 消息安全性提供。
    - TransportCredentialOnly:此模式不提供消息完整性和机密性。 它提供基于 HTTP 的客户端身份验证。 应谨慎使用此模式。 它应在传输安全性由其他方式(如 IPSec)提供且只有客户端身份验证由 WCF 基础结构提供的环境中使用。

    默认值为 None
    传输层客户端凭据类型 指定执行发送端口身份验证时要使用的凭据类型。 有效值包括:

    - :传输级别不会发生身份验证。
    - 基本:基本身份验证。 在基本身份验证中,用户名和密码通过网络以纯文本发送。 此选项需要配置 客户端凭据 属性。
    - 摘要:摘要认证。 此身份验证方法的工作方式与基本身份验证非常类似,不同之处在于,密码通过网络作为哈希值发送,以确保额外的安全性。 摘要式身份验证仅适用于域控制器运行 Windows Server 操作系统的域。 此选项需要配置 客户端凭据 属性。
    - Ntlm:NTLM 身份验证。 运行此发送端口的用户帐户用于服务对此发送端口进行身份验证。
    - Windows:Windows 集成身份验证。 运行此发送端口的用户帐户用于服务对此发送端口进行身份验证。
    - 证书:使用通过 客户端证书 - 指纹 属性指定的客户端证书进行身份验证。 使用此凭据类型时,需要通过 服务证书 - 指纹属性提供服务证书

    默认值为 None
    消息客户端凭据类型 指定使用基于消息的安全性执行客户端身份验证时要使用的凭据类型。 有效值包括:

    - UserName:此发送端口通过 UserName 凭据向服务进行身份验证。 WCF-BasicHttp 发送适配器不支持此功能。
    - 证书:此发送端口使用通过 客户端证书 - 指纹属性指定的客户端证书 向服务进行身份验证。 此外,使用此凭据类型时,需要通过 服务证书 - 指纹属性提供服务证书

    默认值为 UserName
    算法套件 指定消息加密和密钥包装算法。 这些算法映射到安全策略语言(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

    默认值为空字符串。
    服务证书 - 指纹 指定 X.509 证书的指纹,用于对发送端口向其发送消息的服务进行身份验证。 您可以使用浏览按钮,在本地计算机位置的其他人存储中选择指纹。

    最小长度:0

    最大长度:40

    默认值为空字符串。
    用户名凭据 指定用于发送消息的凭据。 可以通过单击 “编辑” 按钮来指定属性。 此选项仅适用于以下部分中列出的安全配置:“WCF-BasicHttp 发送适配器的企业单一 Sign-On 可支持性”。

    默认值为 “请勿使用单一登录”。
    服务总线连接信息 从 BizTalk Server 2016 开始的新增功能。

    选择使用服务总线命名空间的共享访问签名(SAS)或访问控制服务(ACS)。

    选择一个选项,然后选择 “编辑” 以输入密钥信息:

    - 共享访问签名 :输入访问密钥名称和访问密钥。 这两个值都在 Azure 门户中列出。
    - 访问控制服务 :输入 STS URI(https://<yourNamespace>-sb.accesscontrol.windows.net/)、颁发者名称和颁发者密钥。 使用 Windows PowerShell 检索这些值,如 SB-Messaging 适配器中所述。

    WCF-BasicHttp 发送适配器的企业单一 Sign-On 可支持性 WCF-BasicHttp 发送适配器可以从 SSO 服务器兑换 SSO 票证,以便仅在下表所示的安全配置中获取用户凭据。

    安全模式 传输层客户端凭据类型 消息客户端凭据类型
    传输 基本
    传输 消化
    TransportCredentialOnly 基本
    TransportCredentialOnly 消化
    消息 UserName
    TransportWithMessageCredential UserName
  6. “WCF-BasicHttp 传输属性 ”对话框中的“ 代理 ”选项卡上,为 WCF-BasicHttp 发送端口配置代理设置:

    用这个 要执行的操作
    使用处理程序的默认代理设置 指定此发送端口是否使用托管此发送端口的发送处理程序中的代理设置。

    这是默认设置。
    不使用代理 指示此发送端口是否使用代理服务器。

    清除默认值。
    使用代理 指示此发送端口是否使用 Address 属性中指定的代理服务器。

    清除默认值。
    地址 指定代理服务器的地址。 根据安全配置使用 httpshttp 方案。 此地址后跟冒号和端口号。 例如,http://127.0.0.1:8080

    仅当选择了 “使用代理” 时,此属性才需要一个值。

    类型:字符串

    最大长度:256

    默认值为空字符串。
    用户名 指定要用于身份验证的用户名。 如果使用集成身份验证,则用户名包括域,即域\用户名。 如果使用基本身份验证或摘要式身份验证,则用户名不包括域\。 仅当选择了 “使用代理” 时,此属性才需要一个值。 注意:WCF-BasicHttp 发送适配器对代理使用基本身份验证。

    类型:字符串

    最小长度:0

    最大长度:256

    默认值为空字符串。
    密码 指定要用于身份验证的密码。

    仅当选择了 “使用代理” 时,此属性才需要一个值。

    类型:字符串

    最小长度:0

    最大长度:256

    默认值为空字符串。
  7. “WCF-BasicHttp 传输属性 ”对话框中的“ 消息 ”选项卡上,指定 SOAP 正文 元素的数据选择。

    用这个 要执行的操作
    正文 -- BizTalk 请求消息正文 使用 BizTalk 消息体部件来创建传出消息的 SOAP 正文 元素内容。

    这是默认设置。
    模板 - 模板指定的内容 使用 XML 文本框中提供的模板为传出消息创建 SOAP 正文 元素的内容。

    清除默认值。
    XML 为传出消息的 SOAP Body 元素的内容键入 XML 格式的模板。 如果已选择 模板 -- BizTalk 响应消息正文 选项,则需要此属性。

    类型:字符串

    最小长度: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 消息正文部分选择第一个节点。 如果选择了 路径 -- 正文路径 选项,则此属性是必需的。 此属性仅适用于请求响应端口。

    类型:字符串

    最小长度:0

    最大长度:32767

    默认值为空字符串。
    节点编码 指定 WCF-BasicHttp 发送适配器用于解码正文路径表达式文本框中正文路径 表达式 标识的节点的编码类型。 如果选择了 路径 -- 正文路径 选项,则此属性是必需的。 此属性仅适用于请求响应端口。 有效值包括:

    - Base64:Base64 编码。
    - 十六进制:十六进制编码。
    - 字符串:文本编码 - UTF-8
    - XML:WCF 适配器使用 正文路径表达式 文本框中的正文路径表达式选择的节点外层 XML 创建 BizTalk 消息正文。

    默认值为 XML
    传播错误消息 选中此复选框可将无法出站处理的消息路由到订阅应用程序(例如另一个接收端口或业务流程计划)。 取消勾选复选框以暂停失败的消息,并生成负面确认(NACK)。 此属性仅适用于请求响应端口。

    已选择默认值。

将代理添加到发送处理程序

可以将代理添加到发送端口或发送处理程序。 如果要在发送端口添加代理,请跳过本部分。

  1. 在 BizTalk Server 管理控制台中,展开 BizTalk Server 管理、 BizTalk 组平台设置,然后展开 适配器

  2. 选择 WCF-BasicHttp,然后双击发送处理程序。

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

  4. “代理 ”选项卡中,执行以下作。

    用这个 要执行的操作
    使用代理 指示此发送处理程序是否使用代理服务器。

    清除默认值。
    地址 指定代理服务器的地址。 根据安全配置使用 httpshttp 方案。 此地址后跟冒号和端口号。 例如,http://127.0.0.1:8080

    仅当选择了 “使用代理” 时,此属性才需要一个值。

    类型:字符串

    最大长度:256

    默认值为空字符串。
    用户名 指定要用于身份验证的用户名。 如果使用集成身份验证或基本身份验证,用户名应包括域,例如 ___domain\username。 如果使用摘要身份验证,用户名中不包含域。

    仅当选择了 “使用代理” 时,此属性才需要一个值。

    类型:字符串

    最小长度:0

    最大长度:256

    默认值为空字符串。
    密码 指定要用于身份验证的密码。

    仅当选择了 “使用代理” 时,此属性才需要一个值。

    类型:字符串

    最小长度:0

    最大长度:256

    默认值为空字符串。
  5. 单击 “确定 ”,直到退出所有对话框。

    另请参阅

什么是 WCF 适配器?

SB-Messaging 适配器

使用适配器