WCF-BasicHttp 适配器WCF-BasicHttp Adapter

MicrosoftMicrosoftBizTalk ServerBizTalk Server使用 WCF-BasicHttp 适配器通过BasicHttpBinding 类接收和发送 WCF 服务请求。BizTalk ServerBizTalk Server uses the WCF-BasicHttp adapter to receive and send WCF service requests through the BasicHttpBinding class. 使用 WCF-BasicHttp 适配器,可以将业务流程和架构发布为 WCF 服务,并使用 BasicHttpBinding 的外部 WCF 服务。The WCF-BasicHttp adapter enables you to publish orchestrations and schemas as WCF services and to consume external WCF services with the BasicHttpBinding.

借助 WCF-BasicHttp 适配器,您可以通过以文本编码的 HTTP 或 HTTPS 传输,采用符合 WS-I 基本配置文件 1.1 且基于 ASMX 的早期 Web 服务和客户端实现跨计算机通信。You can use the WCF-BasicHttp adapter to do cross-computer communication with legacy ASMX-based Web services and clients that conform to the WS-I Basic Profile 1.1, using either the HTTP or HTTPS transport with text encoding. 但是,您将无法利用 WS-* 协议支持的功能。However, you will not be able to take advantage of features that are supported by WS-* protocols.

下表总结了 WCF-BasicHttp 适配器的特征:The following table summarizes the characteristics of the WCF-BasicHttp adapter:

描述Description 特征Characteristic
互操作性水平Interoperability level 基本配置文件Basic Profile
消息编码Message encoding 文本或 MTOMText or MTOM
边界Boundary 跨计算机Cross-computer
传输协议Transport protocol HTTP 或 HTTPSHTTP or HTTPS
安全模式Security mode 无、消息、传输、TransportWithMessageCredential 和 TransportCredentialOnlyNone, Message, Transport, TransportWithMessageCredential, and TransportCredentialOnly
客户端身份验证机制Client authentication mechanism 传输安全性和消息安全性Transport Security and Message Security
是否支持 WS-ReliableMessagingSupport for WS-ReliableMessaging No
是否支持 WS-AtomicTransactionSupport for WS-AtomicTransaction No
支持单向消息传送Support for one-way messaging Yes
支持双向消息传送Support for two-way messaging Yes
接收适配器的主机类型Host type for receive adapter 隔离Isolated
发送适配器的主机类型Host type for send adapter 进程内In-process

WCF-BasicHttp 适配器由两个适配器组成:一个接收适配器和一个发送适配器。The WCF-BasicHttp adapter consists of two adapters — a receive adapter and a send adapter.

本主题说明如何使用 BizTalk 管理创建接收位置和发送端口。This topic shows you how to create the receive location and send port using BizTalk Administration. 还可以 通过编程方式创建接收位置和发送端口You can also create the receive location and send port programmatically.

在开始之前Before you begin

  • 从开始 BizTalk Server 2016BizTalk Server 2016 ,此发送适配器可以使用访问控制服务 (ACS) 或 (SAS) 的共享访问签名与服务总线 athenticate。Starting with BizTalk Server 2016BizTalk Server 2016, this send adapter can use Access Control Service (ACS) or the Shared Access Signature (SAS) to athenticate with Service Bus. 建议在使用 Service Bus 进行身份验证时,使用共享访问签名 (SAS) 。We recommend using the Shared Access Signature (SAS) when authenticating with Service Bus.

    创建 Service Bus 命名空间时,不会自动创建 (ACS) 命名空间的访问控制。When you create a Service Bus namespace, the Access Control (ACS) namespace is not automatically created. 如果使用 ACS 进行身份验证,则可能需要创建新的 ACS 命名空间。If you use ACS to authenticate, then you may need to create a new ACS namespace. 有关更多详细信息,请参阅 SB 消息适配器 ,其中包括检索 ACS 密钥值的步骤。See SB-Messaging adapter for more detailed information, including the steps to retrieve the ACS key values.

  • 在以下方案中,通过 SOAP 适配器首选 WCF-BasicHttp 适配器:The WCF-BasicHttp adapter is preferred over the SOAP adapter in the following scenarios:

    • WCF 适配器每秒的文档速率通常比 SOAP 适配器更好。WCF adapters documents-per-second rate is generally better than SOAP adapter.
    • SOAP 适配器具有在 .NET 类型和原始 XML 数据之间序列化和反序列化消息的缺点;在某些情况下,可能会导致不需要的数据修改。SOAP adapter has the disadvantage of serializing and deserializing messages between .NET types and raw XML data; which in some cases could result in unwanted data modification. WCF 适配器采用保留数据流的方法。WCF adapters take the approach of preserving the data stream.
    • WCF 适配器所发布的架构与在 BizTalk 运行时所使用的架构实质上相同。WCF adapters publish what is essentially the same schema as will be used in the BizTalk runtime. 与此相反,SOAP 适配器所返回的元数据是通过对生成的用于表示架构的 .NET 类进行反射而生成的。In contrast, SOAP adapter returns metadata generated by reflecting on the .NET classes generated to represent the schemas. 因为 .NET 不保留 XSD 架构的所有细微差别,所以公开的 WSDL 可能不会精确反映 BizTalk 运行时使用的架构。Since .NET does not preserve all the nuances of XSD schemas, the exposed WSDL may not accurately reflect the schemas used by the BizTalk runtime.
    • 如果需要,从 WCF-BasicHttp 迁移到 Wcf-wshttp 的过程会更容易。It is easier to migrate from WCF-BasicHttp to WCF-WSHttp, if needed.
  • 您可使用 WCF-BasicHttp 接收适配器通过 HTTP 或 HTTPS 协议接收 WCF 服务请求。You use the WCF-BasicHttp receive adapter to receive WCF service requests through the HTTP or HTTPS protocol. 您可使用 WCF-BasicHttp 发送适配器及 HTTP 或 HTTPS 协议通过无类型约定调用 WCF 服务。You use the WCF-BasicHttp send adapter to call a WCF service through the typeless contract by using the HTTP or HTTPS protocol.

创建接收位置Create the receive location

此接收位置可以配置为单向或请求-响应 (双向) 。This receive location can be configured as one-way or request-response (two-way).

备注

在完成以下步骤之前,您必须已添加一个接收端口。Before completing the following steps, you must have already added a receive port. 请参阅 如何创建接收端口See How to Create a Receive Port.

你还可以 通过编程方式创建接收位置You can also create the receive location programmatically.

  1. 在 BizTalk 管理控制台中,依次展开 " BizTalk Server 管理"、" BizTalk 组"、" 应用程序",然后展开要在其中创建接收位置的应用程序。In the BizTalk Administration console, expand BizTalk Server Administration, expand BizTalk Group, expand Applications, and then expand the application you want to create a receive location in.

  2. 在 BizTalk 管理控制台的左窗格中,单击“接收端口” 节点。In the BizTalk Administration console, in the left pane, click the Receive Port node. 随后,在右窗格中右键单击与现有接收位置关联的接收端口或要与新接收位置关联的接收端口,然后单击“属性” 。Then in the right pane, right-click the receive port that is associated with an existing receive location or that you want to associate with a new receive location, and then click Properties.

  3. 在“接收端口属性” 对话框的左窗格中,选择“接收位置” ,然后在右窗格中双击现有的接收位置或单击“新建” 以创建新的接收位置。In the Receive Port Properties dialog box, in the left pane, select Receive Locations, and then in the right pane, double-click an existing receive location or click New to create a new receive location.

  4. 在 "接收位置属性" 对话框的 "类型" 旁边的 "传输" 部分中,从下拉列表中选择 " wcf-basichttp ",然后单击 "配置"。In the Receive Location Properties dialog box, in the Transport section next to Type, select WCF-BasicHttp from the drop-down list, and then click Configure.

  5. 在 " Wcf-basichttp 传输属性" 的 " 常规 " 选项卡上,为 WCF-BasicHttp 接收位置配置终结点地址和服务标识:In WCF-BasicHttp Transport Properties, on the General tab, configure the endpoint address and the service identity for the WCF-BasicHttp receive location:

    备注

    如果在 安全模式下 使用 传输TRANSPORTWITHMESSAGECREDENTIAL ,则必须 (IIS) 在 Microsoft Internet Information Services 中设置 (SSL) 安全套接字层。If you use Transport or TransportWithMessageCredential for the Security mode, you must set up Secure Sockets Layer (SSL) in Microsoft Internet Information Services (IIS).

    使用此选项Use this 要执行此操作To do this
    地址(URI)Address (URI) 必需。Required. 指定此接收位置的 URI。Specify the URI for this receive location. 指定虚拟目录以及 BizTalk WCF 服务发布向导生成的 .svc 文件名称,例如例如/path/service.svc。Specify the virtual directory plus the .svc file name that the BizTalk WCF Service Publishing Wizard generates—for example, /path/service.svc.

    默认值:/Default value: /

    最小长度:1Minimum length: 1

    最大长度:255Maximum length: 255
    终结点标识Endpoint Identity 可选。Optional. 单击 " 编辑 " 按钮,指定此接收位置提供的服务的标识。Specify the identity of the service that this receive location provides by clicking the Edit button. 可为 " 终结点标识 " 属性指定的值因安全配置而异。The values that can be specified for the Endpoint Identity property differ according to the security configuration. 通过这些设置,客户端可对此接收位置进行验证。These settings enable the client to authenticate this receive location. 在客户端与服务进行握手的过程中,Windows Communication Foundation (WCF) 基础结构将确保预期服务的标识与此元素的值保持一致。In the handshake process between the client and service, the Windows Communication Foundation (WCF) infrastructure will ensure that the identity of the expected service matches the values of this element.

    默认值为一个空字符串。The default is an empty string.

    最小长度:0Minimum length: 0

    最大长度:32767Maximum length: 32767
  6. 在 " WCF-Wcf-basichttp 传输属性 " 对话框的 " 绑定 " 选项卡上,配置超时和编码属性:In the WCF-BasicHttp Transport Properties dialog box, on the Binding tab, configure the time-out and encoding properties:

    使用此选项Use this 要执行此操作To do this
    打开超时 (hh:mmss)Open timeout (hh:mmss) 指定一个时间跨度值来表示为完成信道打开操作提供的时间间隔。Specify a time span value that indicates the interval of time provided for a channel open operation to complete. 此值应大于或等于 System.TimeSpan.ZeroThis value should be greater than or equal to System.TimeSpan.Zero.

    默认值:00:01:00Default value: 00:01:00

    最大值:23:59:59Maximum value: 23:59:59
    发送超时 (hh:mmss)Send timeout (hh:mmss) 指定一个时间跨度值来表示为完成发送操作提供的时间间隔。Specify a time span value that indicates the interval of time provided for a send operation to complete. 此值应大于或等于 System.TimeSpan.ZeroThis value should be greater than or equal to System.TimeSpan.Zero. 如果使用请求-响应接收端口,则此值指定完成整个交互的时间跨度(即使客户端返回一条大消息)。If you use a request-response receive port, this value specifies a time span for the whole interaction to complete, even if the client returns a large message.

    默认值:00:01:00Default value: 00:01:00

    最大值:23:59:59Maximum value: 23:59:59
    关闭超时值 (hh:mmss)Close timeout (hh:mmss) 指定一个时间跨度值来表示为完成信道关闭操作提供的时间间隔。Specify a time span value that indicates the interval of time provided for a channel close operation to complete. 此值应大于或等于 System.TimeSpan.ZeroThis value should be greater than or equal to System.TimeSpan.Zero.

    默认值:00:01:00Default value: 00:01:00

    最大值:23:59:59Maximum value: 23:59:59
    已接收消息的最大字节数Maximum received message size (bytes) 指定网络上可接收的消息的最大大小(包括标头),以字节表示。Specify the maximum size, in bytes, for a message including headers, which can be received on the wire. 消息的大小受为每条消息分配的内存量的限制。The size of the messages is bounded by the amount of memory allocated for each message. 你可以使用此属性来降低受拒绝服务 (DoS) 攻击的可能性。You can use this property to limit exposure to denial of service (DoS) attacks.

    WCF-BasicHttp 适配器利用缓冲传输模式下的 BasicHttpBinding 类来与终结点通信。The WCF-BasicHttp adapter leverages the BasicHttpBinding class in the buffered transfer mode to communicate with an endpoint. 对于缓冲传输模式, BasicHttpBinding. MaxBufferSize 属性始终等于此属性的值。For the buffered transport mode, the BasicHttpBinding.MaxBufferSize property is always equal to the value of this property.

    默认值:65536Default value: 65536

    最大值:2147483647Maximum value: 2147483647
    消息编码Message encoding 指定用于对 SOAP 消息进行编码的编码器。Specify the encoder used to encode the SOAP message. 有效值包括以下值:Valid values include the following:

    - Text:使用文本消息编码器。- Text: Use a text message encoder.
    - Mtom:使用消息传输组织机制 1.0 (Mtom) 编码器。- Mtom: Use a Message Transmission Organization Mechanism 1.0 (MTOM) encoder.

    默认值为 TextThe default is Text.
    文本编码Text encoding 指定在将 消息编码 属性设置为 文本 时要用于在绑定上发出消息的字符集编码。Specify the character set encoding to be used for emitting messages on the binding when the Message encoding property is set to Text. 有效值包括以下值:Valid values include the following:

    - utf-16be (unicodeFFFE): Unicode BigEndian 编码。- utf-16BE (unicodeFFFE): Unicode BigEndian encoding.
    - utf-16:16位编码。- utf-16: 16-bit encoding.
    - utf-8:8位编码- utf-8: 8-bit encoding

    默认值为 utf-8The default is utf-8.
    最大并发调用数Max concurrent calls 指定针对单个服务实例的并发调用的数目。Specify the number of concurrent calls to a single service instance. 超出此限制的调用将在队列中排队。Calls in excess of the limit are queued. 将该值设置为 0 等效于将它设置为 Int32.MaxValueSetting this value to 0 is equivalent to setting it to Int32.MaxValue.

    默认值为 200。The default is 200
  7. 在 " WCF-Wcf-basichttp 传输属性 " 对话框的 " 安全 " 选项卡上,定义安全功能:In the WCF-BasicHttp Transport Properties dialog box, on the Security tab, define the security capabilities:

    使用此选项Use this 要执行此操作To do this
    安全模式Security mode 指定使用的安全类型。Specify the type of security that is used. 有效值包括以下值:Valid values include the following:

    - None:传输过程中消息不受保护。- None: Messages are not secured during transfer.
    - 传输:使用 HTTPS 传输提供安全性。- Transport: Security is provided using the HTTPS transport. 使用 HTTPS 对 SOAP 消息进行保护。The SOAP messages are secured using HTTPS. 若要使用此模式,你必须在 Microsoft Internet 信息服务 (IIS) 中设置安全套接字层 (SSL)。To use this mode, you must set up Secure Sockets Layer (SSL) in Microsoft Internet Information Services (IIS).
    - 消息:通过 HTTP 传输使用 SOAP 消息安全提供安全性。- Message: Security is provided using SOAP message security over the HTTP transport. 默认情况下,SOAP“正文” 已加密和签名。By default, the SOAP Body is encrypted and signed. WCF-Basic 适配器的唯一有效 消息客户端凭据类型 是 " 证书"。The only valid Message client credential type for the WCF-Basic adapter is Certificate. 此模式需要 HTTP 传输。This mode requires the HTTP transport. 使用此安全模式时,需要通过 " 服务证书-指纹 " 属性提供此接收位置的服务证书。When using this security mode, the service certificate for this receive location needs to be provided through the Service certificate - Thumbprint property.
    - TransportWithMessageCredential:完整性、机密性和服务身份验证通过 HTTPS 传输提供。- TransportWithMessageCredential: Integrity, confidentiality, and service authentication are provided by the HTTPS transport. 若要使用此模式,你必须在 Microsoft Internet 信息服务 (IIS) 中设置安全套接字层 (SSL)。To use this mode, you must set up Secure Sockets Layer (SSL) in Microsoft Internet Information Services (IIS).
    - TransportCredentialOnly:此模式不提供消息完整性和机密性。- TransportCredentialOnly: This mode does not provide message integrity and confidentiality. 而是提供基于 HTTP 的客户端身份验证。It provides HTTP-based client authentication. 使用此模式时应当小心。This mode should be used with caution. 此模式适用于传输安全性通过其他途径(如 IPSec)提供且 WCF 基础结构只提供客户端验证的环境。It should be used in environments where the transport security is provided by other means (such as IPSec) and only client authentication is provided by the WCF infrastructure. 如果在此安全模式中为 "传输客户端凭据类型" 属性选择 "证书",则需要通过 "服务证书-指纹" 属性提供此接收位置的服务证书。If you select Certificate for the Transport client credential type property in this security mode, the service certificate for this receive location needs to be provided through the Service certificate - Thumbprint property.

    默认值为“无”。The default is None.
    传输客户端凭据类型Transport client credential type 指定执行客户端验证时要使用的凭据类型。Specify the type of credential to be used when performing the client authentication. 有效值包括以下值:Valid values include the following:

    - None:在传输级别不进行身份验证。- None: No authentication occurs at the transport level.
    - 基本:基本身份验证。- Basic: Basic authentication. 在基本身份验证中,用户名和密码将以明文形式通过网络发送。In Basic authentication, user names and passwords are sent in plain text over the network. 你必须创建与凭据对应的域或本地用户帐户。You must create the domain or local user accounts corresponding to the credentials.
    - 摘要:摘要式身份验证。- Digest: Digest authentication. 此身份验证方法与基本身份验证方法相似,不同之处在于密码以哈希值的形式通过网络发送,以增强安全性。This authentication method operates much like Basic authentication, except that passwords are sent across the network as a hash value for additional security. 摘要身份验证只可在域控制器运行 Windows Server 操作系统验证的域中使用。Digest authentication is available only on domains with domain controllers running Windows Server operating systems authentication. 你必须创建与客户端凭据对应的域或本地用户帐户。You must create the domain or local user accounts corresponding to client credentials.
    - Ntlm: ntlm 身份验证。- Ntlm: NTLM authentication. 客户端可只发送凭据而不向此接收位置发送密码。Clients can send the credentials without sending a password to this receive location. 你必须创建与客户端凭据对应的域或本地用户帐户。You must create the domain or local user accounts corresponding to client credentials.
    - Windows: windows 集成身份验证。- Windows: Windows integrated authentication. Windows Communication Foundation 可与 Kerberos 或 NTLM 协商,如果存在域,则首选使用 Kerberos。Windows Communication Foundation negotiates Kerberos or NTLM, preferring Kerberos if a domain is present. 如果要使用 Kerberos,则非常重要的一点是让客户端使用服务主体名称 (SPN) 标识该服务。If you want to use Kerberos it is important to have the client identify the service with a service principal name (SPN). 你必须创建与客户端凭据对应的域或本地用户帐户。You must create the domain or local user accounts corresponding to client credentials.
    - 证书:使用客户端证书进行客户端身份验证。- Certificate: Client authentication using the client certificate. 必须将用于客户端 X.509 证书的 CA 证书链安装到此计算机的“受信任根证书颁发机构”证书存储中,以便可以针对此接收位置验证客户端。The CA certificate chain for the client X.509 certificates must be installed in the Trusted Root Certification Authorities certificate store of this computer so that the clients can be authenticated to this receive location. 注意: " 传输客户端凭据类型 " 属性必须与承载此接收位置的 IIS 虚拟目录的身份验证方案相匹配。Note: The Transport client credential type property must match the authentication scheme of the IIS virtual directory hosting this receive location. 例如,如果该属性设置为“Windows” ,则你还需为此接收位置所在的虚拟目录启用“集成 Windows 验证” 。For example, if the property is set to Windows, you also need to enable Integrated Windows authentication for the virtual directory that hosts it. 相似地,如果将该属性设置为“无” ,则你必须允许匿名访问此接收位置所在的虚拟目录。Similarly if the property is set to None, you must allow anonymous access to the virtual directory that hosts this receive location.

    默认值为“无”。The default is None.
    消息客户端凭据类型Message client credential type 指定使用基于消息的安全性对客户端执行验证时所用的凭据类型。Specify the type of credential to be used when performing client authentication using message-based security. 有效值包括以下值:Valid values include the following:

    - 用户名:允许此接收位置要求使用 用户名 凭据对客户端进行身份验证。- UserName: Allow this receive location to require that clients be authenticated using the UserName credential. 你必须创建与客户端凭据对应的域或本地用户帐户。You must create the domain or local user accounts corresponding to the client credentials.
    - 证书:使用客户端证书向此接收位置验证客户端。- Certificate: Clients are authenticated to this receive location using the client certificate. 必须将用于客户端 X.509 证书的 CA 证书链安装到此计算机的“受信任根证书颁发机构”证书存储中,以便可以针对此接收位置验证客户端。The CA certificate chain for the client X.509 certificates must be installed in the Trusted Root Certification Authorities certificate store of this computer so that the clients can be authenticated to this receive location.

    默认值为 UserNameThe default is UserName.
    算法套件Algorithm suite 指定消息加密和密钥包装算法。Specify the message encryption and key-wrap algorithms. 这些算法与“安全策略语言”(WS-SecurityPolicy) 规范中指定的算法一致。These algorithms map to those specified in the Security Policy Language (WS-SecurityPolicy) specification. 可能的值有:Possible values are:

    - Basic128:使用 Aes128 加密,Sha1 用于消息摘要,使用 Rsa-oaep-rsa-oaep-mgf1p 进行密钥包装。- Basic128: Use Aes128 encryption, Sha1 for message digest, and Rsa-oaep-mgf1p for key wrap.
    - Basic128Rsa15:将 Aes128 用于消息加密,使用 Sha1 作为消息摘要,使用 Rsa15 进行密钥包装。- Basic128Rsa15: Use Aes128 for message encryption, Sha1 for message digest, and Rsa15 for key wrap.
    - Basic128Sha256:将 Aes256 用于消息加密、Sha256 用于消息摘要,并使用 Rsa-oaep-rsa-oaep-mgf1p 进行密钥包装。- Basic128Sha256: Use Aes256 for message encryption, Sha256 for message digest, and Rsa-oaep-mgf1p for key wrap.
    - Basic128Sha256Rsa15:将 Aes128 用于消息加密、Sha256 用于消息摘要,并使用 Rsa15 进行密钥包装。- Basic128Sha256Rsa15: Use Aes128 for message encryption, Sha256 for message digest, and Rsa15 for key wrap.
    - Basic192:使用 Aes192 加密,Sha1 用于消息摘要,使用 Rsa-oaep-rsa-oaep-mgf1p 进行密钥包装。- Basic192: Use Aes192 encryption, Sha1 for message digest, and Rsa-oaep-mgf1p for key wrap.
    - Basic192Rsa15:将 Aes192 用于消息加密,使用 Sha1 作为消息摘要,使用 Rsa15 进行密钥包装。- Basic192Rsa15: Use Aes192 for message encryption, Sha1 for message digest, and Rsa15 for key wrap.
    - Basic192Sha256:将 Aes192 用于消息加密、Sha256 用于消息摘要,并使用 Rsa-oaep-rsa-oaep-mgf1p 进行密钥包装。- Basic192Sha256: Use Aes192 for message encryption, Sha256 for message digest, and Rsa-oaep-mgf1p for key wrap.
    - Basic192Sha256Rsa15:将 Aes192 用于消息加密、Sha256 用于消息摘要,并使用 Rsa15 进行密钥包装。- Basic192Sha256Rsa15: Use Aes192 for message encryption, Sha256 for message digest, and Rsa15 for key wrap.
    - Basic256:使用 Aes256 加密,Sha1 用于消息摘要,使用 Rsa-oaep-rsa-oaep-mgf1p 进行密钥包装。- Basic256: Use Aes256 encryption, Sha1 for message digest, and Rsa-oaep-mgf1p for key wrap.
    - Basic256Rsa15:将 Aes256 用于消息加密,使用 Sha1 作为消息摘要,使用 Rsa15 进行密钥包装。- Basic256Rsa15: Use Aes256 for message encryption, Sha1 for message digest, and Rsa15 for key wrap.
    - Basic256Sha256:将 Aes256 用于消息加密、Sha256 用于消息摘要,并使用 Rsa-oaep-rsa-oaep-mgf1p 进行密钥包装。- Basic256Sha256: Use Aes256 for message encryption, Sha256 for message digest, and Rsa-oaep-mgf1p for key wrap.
    - Basic256Sha256Rsa15:将 Aes256 用于消息加密、Sha256 用于消息摘要,并使用 Rsa15 进行密钥包装。- Basic256Sha256Rsa15: Use Aes256 for message encryption, Sha256 for message digest, and Rsa15 for key wrap.
    - TripleDes:使用 TripleDes 加密,Sha1 用于消息摘要,Rsa-oaep-rsa-oaep-mgf1p 用于密钥包装。- TripleDes: Use TripleDes encryption, Sha1 for message digest, Rsa-oaep-mgf1p for key wrap.
    - TripleDesRsa15:使用 TripleDes encryption,使用 Sha1 作为消息摘要,使用 Rsa15 进行密钥换行。- TripleDesRsa15: Use TripleDes encryption, Sha1 for message digest, and Rsa15 for key wrap.
    - TripleDesSha256:将 TripleDes 用于消息加密、Sha256 用于消息摘要,并使用 Rsa-oaep-rsa-oaep-mgf1p 进行密钥包装。- TripleDesSha256: Use TripleDes for message encryption, Sha256 for message digest, and Rsa-oaep-mgf1p for key wrap.
    - TripleDesSha256Rsa15:将 TripleDes 用于消息加密、Sha256 用于消息摘要,并使用 Rsa15 进行密钥包装。- TripleDesSha256Rsa15: Use TripleDes for message encryption, Sha256 for message digest, and Rsa15 for key wrap.

    默认值为“Basic256” 。The default value is Basic256.
    服务证书 - 指纹Service certificate -Thumbprint 为此接收位置指定 X.509 证书的指纹,客户端利用该指纹验证服务。Specify the thumbprint of the X.509 certificate for this receive location that the clients use to authenticate the service. 使用“浏览” 按钮,导航到“当前用户” 位置中“我的” 存储,然后即可选择指纹。The thumbprint can be selected by navigating the My store in the Current User location with the Browse button. 注意: 必须将服务证书安装到承载此接收位置的接收处理程序的用户帐户的 " 当前用户 " 位置中。Note: You must install the service certificate into the Current User location of the user account for the receive handler hosting this receive location.

    最小长度:0Minimum length: 0

    最大长度:40Maximum length: 40

    默认值为一个空字符串。The default is an empty string.
    使用单一登录Use Single Sign-On 使用单一登录检索客户端凭据以发放 SSO 票证。Use Single Sign-On to retrieve client credentials to issue an SSO ticket. 此选项仅对以下部分中列出的安全配置有效: "企业单一 Sign-On WCF-BasicHttp 接收适配器的可支持性"。This option is valid only for the security configurations listed in the following section, "Enterprise Single Sign-On Supportability for the WCF-BasicHttp Receive Adapter."

    默认值为清除此复选框。The default value is cleared.

    WCF-BasicHttp 接收适配器的企业单一 Sign-On 可支持 性此适配器只能在下表所示的安全配置中颁发 sso 服务器的 SSO 票证:Enterprise Single Sign-On Supportability for the WCF-BasicHttp Receive Adapter This adapter can issue an SSO ticket from the SSO server only in the security configurations shown in the following table:

    安全模式Security mode 传输客户端凭据类型Transport client credential type 消息客户端凭据类型Message client credential type
    TransportTransport 基本Basic 不适用N/A
    TransportTransport 摘要式Digest 不适用N/A
    TransportTransport NtlmNtlm 不适用N/A
    TransportTransport WindowsWindows 不适用N/A
    TransportTransport 证书Certificate 不适用N/A
    消息Message 不适用N/A UserNameUserName
    TransportWithMessageCredentialTransportWithMessageCredential 不适用N/A UserNameUserName
    TransportCredentialOnlyTransportCredentialOnly 基本Basic 不适用N/A
    TransportCredentialOnlyTransportCredentialOnly 摘要式Digest 不适用N/A
    TransportCredentialOnlyTransportCredentialOnly NtlmNtlm 不适用N/A
    TransportCredentialOnlyTransportCredentialOnly WindowsWindows 不适用N/A
    TransportCredentialOnlyTransportCredentialOnly 证书Certificate 不适用N/A
  8. 在 " WCF-Wcf-basichttp 传输属性 " 对话框的 " 消息 " 选项卡上,为 SOAP Body 元素指定数据选择:In the WCF-BasicHttp Transport Properties dialog box, on the Messages tab, specify the data selection for the SOAP Body element:

    使用此选项Use this 要执行此操作To do this
    信封--整个 <soap:Envelope>Envelope -- entire <soap:Envelope> 从传入消息的整个 SOAP Envelope 创建 BizTalk 消息正文部分。Create the BizTalk message body part from the entire SOAP Envelope of an incoming message.

    默认值为清除此复选框。The default value is cleared.
    Body-元素的内容 <soap:Body>Body -- contents of <soap:Body> element 使用传入消息的 SOAP Body 元素的内容创建 BizTalk 消息正文部分。Use the content of the SOAP Body element of an incoming message to create the BizTalk message body part. 如果 Body 元素具有多个子元素,则只有第一个元素将成为 BizTalk 消息正文部分。If the Body element has more than one child element, only the first element becomes the BizTalk message body part.

    此为默认设置。This is the default setting.
    路径 -- 按正文路径定位内容Path -- content located by body path 使用“正文路径表达式” 文本框中的正文路径表达式创建 BizTalk 消息正文部分。Use the body path expression in the Body path expression text box to create the BizTalk message body part. 针对传入消息的 SOAP Body 元素的直接子元素计算正文路径表达式。The body path expression is evaluated against the immediate child element of the SOAP Body element of an incoming message.

    默认值为清除此复选框。The default value is cleared.
    正文路径表达式Body path expression 键入正文路径表达式以标识传入消息中用于创建 BizTalk 消息正文部分的特定部分。Type the body path expression to identify a specific part of an incoming message used to create the BizTalk message body part. 针对传入消息的 SOAP Body 元素的直接子元素计算此正文路径表达式。This body path expression is evaluated against the immediate child element of the SOAP Body element of an incoming message. 如果此正文路径表达式返回多个节点,则只选择第一个节点作为 BizTalk 消息正文部分。If this body path expression returns more than one node, only the first node is chosen for the BizTalk message body part. 如果选择了“路径 -- 按正文路径定位内容” 选项,则此属性是必需的。This property is required if the Path -- content located by body path option is selected.

    键入:StringType: String

    最小长度:0Minimum length: 0

    最大长度:32767Maximum length: 32767

    默认值为一个空字符串。The default is an empty string.
    节点编码Node encoding 指定 WCF-BasicHttp 接收适配器用于对 " 正文路径表达式 " 文本框中的正文路径表达式所标识的节点进行解码的编码类型。Specify the type of encoding that the WCF-BasicHttp receive adapter uses to decode the node identified by the body path expression in the Body path expression text box.

    如果选择了“路径 -- 按正文路径定位内容” 选项,则此属性是必需的。This property is required if the Path -- content located by body path option is selected. 有效值包括以下值:Valid values include the following:

    - Base64: base64 编码。- Base64: Base64 encoding.
    - 十六进制:十六进制编码。- Hex: Hexadecimal encoding.
    - String:文本编码-utf-8- String: Text encoding - UTF-8
    - XML: WCF 适配器使用 " 正文路径表达式 " 文本框中的正文路径表达式所选择的节点的外部 XML 创建 BizTalk 消息正文。- XML: The WCF adapters create the BizTalk message body with the outer XML of the node selected by the body path expression in the Body path expression text box.

    默认值为“XML” 。The default is XML.
    正文 -- BizTalk 响应消息正文Body -- BizTalk response message body 使用 BizTalk 消息正文部分创建传出响应消息的 SOAP Body 元素的内容。Use the BizTalk message body part to create the content of the SOAP Body element of an outgoing response message. 此属性仅对请求响应接收位置有效。This property is valid only for request-response receive locations.

    此为默认设置。This is the default setting.
    模板 -- 由模板指定的内容Template -- content specified by template 使用在“XML” 文本框中提供的模板创建传出消息的 SOAP Body 元素的内容。Use the template supplied in the XML text box to create the content of the SOAP Body element for an outgoing message. 此属性仅对请求响应接收位置有效。This property is valid only for request-response receive locations.

    默认值为清除此复选框。The default value is cleared.
    XMLXML 为传出消息的 SOAP Body 元素的内容键入 XML 格式的模板。Type the XML-formatted template for the content of the SOAP Body element of an outgoing message. 如果选择了“模板 -- BizTalk 响应消息正文” 选项,则此属性是必需的。This property is required if the Template -- BizTalk response message body option is selected. 此属性仅对请求响应接收位置有效。This property is valid only for request-response receive locations.

    键入:StringType: String

    最小长度:0Minimum length: 0

    最大长度:32767Maximum length: 32767

    默认值为 <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml">The default is <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml">.
    失败时挂起请求消息Suspend request message on failure 指定是否将由于接收管道故障或路由故障而导致入站处理失败的请求消息挂起。Specify whether to suspend the request message that fails inbound processing due to a receive pipeline failure or a routing failure.

    默认值为清除此复选框。The default value is cleared.
    在错误中包括异常详细信息Include exception detail in faults 指定发生错误时是否返回 SOAP 错误以方便进行调试。Specify whether to return SOAP faults when an error occurs to easy debugging.

    默认值为清除此复选框。The default value is cleared.

创建发送端口Create the send port

  1. 在 BizTalk 管理控制台中,创建一个新的发送端口或双击某个现有发送端口以对其进行修改。In the BizTalk Administration console, create a new send port or double-click an existing send port to modify it. 有关详细信息,请参阅 如何创建发送端口For more information, see How to Create a Send Port. 配置所有发送端口选项,并为 "常规" 选项卡的 "传输" 部分中的 "类型" 选项指定 wcf-basichttpConfigure all of the send port options and specify WCF-BasicHttp for the Type option in the Transport section of the General tab.

  2. 在 "常规" 选项卡上的 "传输" 部分中,单击 "类型" 旁边的 "配置" 按钮。On the General tab, in the Transport section, click the Configure button next to Type.

  3. 在 " WCF-Wcf-basichttp 传输属性 " 对话框的 " 常规 " 选项卡上,为 WCF-BasicHttp 发送端口配置终结点地址、服务标识和 SOAPAction HTTP 标头:In the WCF-BasicHttp Transport Properties dialog box, on the General tab, configure the endpoint address, the service identity, and the SOAPAction HTTP header for the WCF-BasicHttp send port:

    备注

    如果为 Address (URI) 属性指定 https 方案,则必须将 "安全模式" 属性配置为 " Transport " 或 " TransportWithMessageCredential"。If you specify the https scheme for the Address (URI) property, you must configure the Security mode property to Transport or TransportWithMessageCredential. 可以使用 " 安全 " 选项卡来配置 " 安全模式 " 属性。You can use the Security tab to configure the Security mode property.

    使用此选项Use this 要执行此操作To do this
    地址(URI)Address (URI) 必需。Required. 指定此发送端口的完全限定 URI。Specify the fully qualified URI for this send port. 使用 httpshttp 方案,具体取决于安全配置。Use the https or the http scheme depending on the security configuration.

    最大长度:255Maximum length: 255

    默认值:30http://localhost/Default value: http://localhost/
    终结点标识Endpoint Identity 可选。Optional. 指定此发送端口预期的服务标识。Specify the identity of the service that this send port expects. 这些设置支持此发送端口对服务进行验证。These settings enable this send port to authenticate the service. 在客户端与服务进行握手的过程中,Windows Communication Foundation (WCF) 基础结构将确保预期服务的标识与此元素的值保持一致。In the handshake process between the client and service, the Windows Communication Foundation (WCF) infrastructure will ensure that the identity of the expected service matches the values of this element. 根据安全配置,可为 Identity 属性指定的值会有所不同。The values that can be specified for the Identity property differ according to the security configuration.

    默认值为清除此复选框。The default value is cleared.
    ActionAction 指定传出消息的 SOAPAction HTTP 标头字段。Specify the SOAPAction HTTP header field for outgoing messages. 还可以通过消息上下文属性 WCF 设置此属性 管道或业务流程中的操作。This property can also be set through the message context property WCF.Action in a pipeline or orchestration. 可以通过两种不同的方式来指定此值:单一操作格式和操作映射格式。You can specify this value in two different ways: the single action format and the action mapping format. 如果以单一操作格式设置此属性,则 http://contoso.com/Svc/Op1- 传出消息的 SOAPAction 标头始终设置为在此属性中指定的值。If you set this property in the single action format- for example, http://contoso.com/Svc/Op1- the SOAPAction header for outgoing messages is always set to the value specified in this property.

    如果以操作映射格式设置此属性,则传出 SOAPAction 标头由 BTS 决定。操作 上下文属性。If you set this property in the action mapping format, the outgoing SOAPAction header is determined by the BTS.Operation context property. 例如,如果将此属性设置为以下 XML 格式和 BTS。操作 属性设置为 Op1,WCF 发送适配器将 http://contoso.com/Svc/Op1 为传出的 SOAPAction 标头使用。For example, if this property is set to the following XML format and the BTS.Operation property is set to Op1, the WCF send adapter uses http://contoso.com/Svc/Op1 for the outgoing SOAPAction header.

    <BtsActionMapping>

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

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

    </BtsActionMapping>

    如果传出消息来自某个业务流程端口,则业务流程实例会动态设置 BTS。操作 属性,其操作名称为端口。If outgoing messages comes from an orchestration port, orchestration instances dynamically set the BTS.Operation property with the operation name of the port. 如果传出消息通过基于内容的路由进行路由,则可以设置 BTS。 管道组件中的操作属性。If outgoing messages are routed with content-based routing, you can set the BTS.Operation property in pipeline components.

    最小长度:0Minimum length: 0

    最大长度:32767Maximum length: 32767

    默认值为一个空字符串。The default is an empty string.
  4. 在 " Wcf-basichttp 传输属性" 的 " 绑定 " 选项卡上,配置超时和编码属性:In WCF-BasicHttp Transport Properties, on the Binding tab, configure the time-out and encoding properties:

    使用此选项Use this 要执行此操作To do this
    打开超时 (hh:mmss)Open timeout (hh:mmss) 指定一个时间跨度值来表示为完成信道打开操作提供的时间间隔。Specify a time span value that indicates the interval of time provided for a channel open operation to complete. 此值应大于或等于 System.TimeSpan.ZeroThis value should be greater than or equal to System.TimeSpan.Zero.

    默认值:00:01:00Default value: 00:01:00

    最大值:23:59:59Maximum value: 23:59:59
    发送超时 (hh:mmss)Send timeout (hh:mmss) 指定一个时间跨度值来表示为完成发送操作提供的时间间隔。Specify a time span value that indicates the interval of time provided for a send operation to complete. 此值应大于或等于 System.TimeSpan.ZeroThis value should be greater than or equal to System.TimeSpan.Zero. 如果使用要求-响应发送端口,则此值指定完成整个交互的时间跨度(即使服务返回一条大消息)。If you use a solicit-response send port, this value specifies a time span for the whole interaction to complete, even if the service returns a large message.

    默认值:00:01:00Default value: 00:01:00

    最大值:23:59:59Maximum value: 23:59:59
    关闭超时值 (hh:mmss)Close timeout (hh:mmss) 指定一个时间跨度值来表示为完成信道关闭操作提供的时间间隔。Specify a time span value that indicates the interval of time provided for a channel close operation to complete. 此值应大于或等于 " timespan.zero"。This value should be greater than or equal System.TimeSpan.Zero.

    默认值:00:01:00Default value: 00:01:00

    最大值:23:59:59Maximum value: 23:59:59
    已接收消息的最大字节数Maximum received message size (bytes) 指定网络上可接收的消息的最大大小(包括标头),以字节表示。Specify the maximum size, in bytes, for a message including headers, which can be received on the wire. 消息的大小受为每条消息分配的内存量的限制。The size of the messages is bounded by the amount of memory allocated for each message. 你可以使用此属性来降低受拒绝服务 (DoS) 攻击的可能性。You can use this property to limit exposure to denial of service (DoS) attacks.

    WCF-BasicHttp 适配器利用缓冲传输模式下的 BasicHttpBinding 类来与终结点通信。The WCF-BasicHttp adapter leverages the BasicHttpBinding class in the buffered transfer mode to communicate with an endpoint. 对于缓冲传输模式, BasicHttpBinding. MaxBufferSize 属性始终等于此属性的值。For the buffered transport mode, the BasicHttpBinding.MaxBufferSize property is always equal to the value of this property.

    默认值:65536Default value: 65536

    最大值:2147483647Maximum value: 2147483647
    消息编码Message encoding 指定用于对 SOAP 消息进行编码的编码器。Specify the encoder used to encode the SOAP message. 有效值包括以下值:Valid values include the following:

    - Text:使用文本消息编码器。- Text: Use a text message encoder.
    - Mtom:使用消息传输组织机制 1.0 (Mtom) 编码器。- Mtom: Use a Message Transmission Organization Mechanism 1.0 (MTOM) encoder.

    默认值: 文本Default value: Text
    文本编码Text encoding 指定在将 消息编码 属性设置为 文本 时要用于在绑定上发出消息的字符集编码。Specify the character set encoding to be used for emitting messages on the binding when the Message encoding property is set to Text. 有效值包括以下值:Valid values include the following:

    - utf-16be (unicodeFFFE): Unicode BigEndian 编码。- utf-16BE (unicodeFFFE): Unicode BigEndian encoding.
    - utf-16:16位编码。- utf-16: 16-bit encoding.
    - utf-8:8位编码- utf-8: 8-bit encoding

    默认值: utf-8Default value: utf-8
  5. 在 " Wcf-basichttp 传输属性 " 对话框的 " 安全 " 选项卡上,定义 WCF-BasicHttp 发送端口的安全功能:In the WCF-BasicHttp Transport Properties dialog box, on the Security tab, define the security capabilities of the WCF-BasicHttp send port:

    使用此选项Use this 要执行此操作To do this
    安全模式Security mode 指定使用的安全类型。Specify the type of security that is used. 有效值包括以下值:Valid values include the following:

    - None:传输过程中消息不受保护。- None: Messages are not secured during transfer.
    - 传输:使用 HTTPS 传输提供安全性。- Transport: Security is provided using the HTTPS transport. 使用 HTTPS 对 SOAP 消息进行保护。The SOAP messages are secured using HTTPS. 服务的 X.509 证书的 CA 证书链必须安装到此计算机的“受信任根证书颁发机构”证书存储区中,以便可以使用该服务的证书向发送端口验证该服务。The CA certificate chain for the service's X.509 certificate must be installed in the Trusted Root Certification Authorities certificate store of this computer so that the service can be authenticated to the send port using the service's certificate.
    - 消息:使用 SOAP 消息安全提供安全性。- Message: Security is provided using SOAP message security. 默认情况下,SOAP Body 元素经过加密和签名。By default, the SOAP Body element is encrypted and signed. WCF-BasicHttp 发送适配器的唯一有效 消息客户端凭据类型证书The only valid Message client credential type for the WCF-BasicHttp send adapter is Certificate. 此模式需要 HTTP 传输。This mode requires the HTTP transport.
    - TransportWithMessageCredential:完整性、机密性和服务身份验证通过 HTTPS 传输提供。- TransportWithMessageCredential: Integrity, confidentiality, and service authentication are provided by the HTTPS transport. 服务的 X.509 证书的 CA 证书链必须安装到此计算机的“受信任根证书颁发机构”证书存储区中,以便使用服务证书向发送端口验证该服务。The CA certificate chain for the service's X.509 certificate must be installed in the Trusted Root Certification Authorities certificate store on this computer so that the service can be authenticated to the send port using the service's certificate. 发送端口验证由 SOAP 消息安全性提供。The send port authentication is provided by SOAP message security.
    - TransportCredentialOnly:此模式不提供消息完整性和机密性。- TransportCredentialOnly: This mode does not provide message integrity and confidentiality. 而是提供基于 HTTP 的客户端身份验证。It provides HTTP-based client authentication. 使用此模式时应当小心。This mode should be used with caution. 此模式适用于传输安全性通过其他途径(如 IPSec)提供且 WCF 基础结构只提供客户端验证的环境。It should be used in environments where the transport security is provided by other means (such as IPSec) and only client authentication is provided by the WCF infrastructure.

    默认值为“无”。The default is None.
    传输客户端凭据类型Transport client credential type 指定执行发送端口验证时使用的凭据类型。Specify the type of credential to be used when performing the send port authentication. 有效值包括以下值:Valid values include the following:

    - None:在传输级别不进行身份验证。- None: No authentication occurs at the transport level.
    - 基本:基本身份验证。- Basic: Basic authentication. 在基本身份验证中,用户名和密码将以明文形式通过网络发送。In Basic authentication, user names and passwords are sent in plain text over the network. 此选项需要配置 " 客户端凭据 " 属性。This option requires configuring the Client credentials property.
    - 摘要:摘要式身份验证。- Digest: Digest authentication. 此身份验证方法与基本身份验证方法相似,不同之处在于密码以哈希值的形式通过网络发送,以增强安全性。This authentication method operates much like Basic authentication, except that passwords are sent across the network as a hash value for additional security. 摘要身份验证只可在域控制器运行 Windows Server 操作系统验证的域中使用。Digest authentication is available only on domains with domain controllers running Windows Server operating systems authentication. 此选项需要配置 " 客户端凭据 " 属性。This option requires configuring the Client credentials property.
    - Ntlm: ntlm 身份验证。- Ntlm: NTLM authentication. 服务使用运行此发送端口的用户帐户来验证此发送端口。The user account under which this send port runs is used for services to authenticate this send port.
    - Windows: windows 集成身份验证。- Windows: Windows integrated authentication. 服务使用运行此发送端口的用户帐户来验证此发送端口。The user account under which this send port runs is used for services to authenticate this send port.
    - 证书:使用通过 " 客户端证书-指纹 " 属性指定的客户端证书进行客户端身份验证。- Certificate: Client authentication using the client certificate specified through the Client certificate - Thumbprint property. 使用此凭据类型时,需要通过 " 服务证书-指纹 " 属性提供服务证书。When using this credential type, the service certificate needs to be provided through the Service certificate - Thumbprint property.

    默认值为“无”。The default is None.
    消息客户端凭据类型Message client credential type 指定使用基于消息的安全性对客户端执行验证时所用的凭据类型。Specify the type of credential to be used when performing client authentication using message-based security. 有效值包括以下值:Valid values include the following:

    - 用户名:此发送端口使用 用户名 凭据对服务进行身份验证。- UserName: This send port is authenticated to the service with a UserName credential. 对于 WCF-BasicHttp 发送适配器,不支持此功能。For the WCF-BasicHttp send adapter, this is not supported.
    - 证书:使用通过 " 客户端证书-指纹 " 属性指定的客户端证书向服务验证此发送端口。- Certificate: This send port is authenticated to services using the client certificate specified through the Client certificate - Thumbprint property. 此外,使用此凭据类型时,需要通过 " 服务证书-指纹 " 属性提供服务证书。In addition, when using this credential type, the service certificate needs to be provided through the Service certificate - Thumbprint property.

    默认值为 UserNameThe default is UserName.
    算法套件Algorithm suite 指定消息加密和密钥包装算法。Specify the message encryption and key-wrap algorithms. 这些算法与“安全策略语言”(WS-SecurityPolicy) 规范中指定的算法一致。These algorithms map to those specified in the Security Policy Language (WS-SecurityPolicy) specification. 可能的值有:Possible values are:

    - Basic128:使用 Aes128 加密,Sha1 用于消息摘要,使用 Rsa-oaep-rsa-oaep-mgf1p 进行密钥包装。- Basic128: Use Aes128 encryption, Sha1 for message digest, and Rsa-oaep-mgf1p for key wrap.
    - Basic128Rsa15:将 Aes128 用于消息加密,使用 Sha1 作为消息摘要,使用 Rsa15 进行密钥包装。- Basic128Rsa15: Use Aes128 for message encryption, Sha1 for message digest, and Rsa15 for key wrap.
    - Basic128Sha256:将 Aes256 用于消息加密、Sha256 用于消息摘要,并使用 Rsa-oaep-rsa-oaep-mgf1p 进行密钥包装。- Basic128Sha256: Use Aes256 for message encryption, Sha256 for message digest, and Rsa-oaep-mgf1p for key wrap.
    - Basic128Sha256Rsa15:将 Aes128 用于消息加密、Sha256 用于消息摘要,并使用 Rsa15 进行密钥包装。- Basic128Sha256Rsa15: Use Aes128 for message encryption, Sha256 for message digest, and Rsa15 for key wrap.
    - Basic192:使用 Aes192 加密,Sha1 用于消息摘要,使用 Rsa-oaep-rsa-oaep-mgf1p 进行密钥包装。- Basic192: Use Aes192 encryption, Sha1 for message digest, and Rsa-oaep-mgf1p for key wrap.
    - Basic192Rsa15:将 Aes192 用于消息加密,使用 Sha1 作为消息摘要,使用 Rsa15 进行密钥包装。- Basic192Rsa15: Use Aes192 for message encryption, Sha1 for message digest, and Rsa15 for key wrap.
    - Basic192Sha256:将 Aes192 用于消息加密、Sha256 用于消息摘要,并使用 Rsa-oaep-rsa-oaep-mgf1p 进行密钥包装。- Basic192Sha256: Use Aes192 for message encryption, Sha256 for message digest, and Rsa-oaep-mgf1p for key wrap.
    - Basic192Sha256Rsa15:将 Aes192 用于消息加密、Sha256 用于消息摘要,并使用 Rsa15 进行密钥包装。- Basic192Sha256Rsa15: Use Aes192 for message encryption, Sha256 for message digest, and Rsa15 for key wrap.
    - Basic256:使用 Aes256 加密,Sha1 用于消息摘要,使用 Rsa-oaep-rsa-oaep-mgf1p 进行密钥包装。- Basic256: Use Aes256 encryption, Sha1 for message digest, and Rsa-oaep-mgf1p for key wrap.
    - Basic256Rsa15:将 Aes256 用于消息加密,使用 Sha1 作为消息摘要,使用 Rsa15 进行密钥包装。- Basic256Rsa15: Use Aes256 for message encryption, Sha1 for message digest, and Rsa15 for key wrap.
    - Basic256Sha256:将 Aes256 用于消息加密、Sha256 用于消息摘要,并使用 Rsa-oaep-rsa-oaep-mgf1p 进行密钥包装。- Basic256Sha256: Use Aes256 for message encryption, Sha256 for message digest, and Rsa-oaep-mgf1p for key wrap.
    - Basic256Sha256Rsa15:将 Aes256 用于消息加密、Sha256 用于消息摘要,并使用 Rsa15 进行密钥包装。- Basic256Sha256Rsa15: Use Aes256 for message encryption, Sha256 for message digest, and Rsa15 for key wrap.
    - TripleDes:使用 TripleDes 加密,Sha1 用于消息摘要,Rsa-oaep-rsa-oaep-mgf1p 用于密钥包装。- TripleDes: Use TripleDes encryption, Sha1 for message digest, Rsa-oaep-mgf1p for key wrap.
    - TripleDesRsa15:使用 TripleDes encryption,使用 Sha1 作为消息摘要,使用 Rsa15 进行密钥换行。- TripleDesRsa15: Use TripleDes encryption, Sha1 for message digest, and Rsa15 for key wrap.
    - TripleDesSha256:将 TripleDes 用于消息加密、Sha256 用于消息摘要,并使用 Rsa-oaep-rsa-oaep-mgf1p 进行密钥包装。- TripleDesSha256: Use TripleDes for message encryption, Sha256 for message digest, and Rsa-oaep-mgf1p for key wrap.
    - TripleDesSha256Rsa15:将 TripleDes 用于消息加密、Sha256 用于消息摘要,并使用 Rsa15 进行密钥包装。- TripleDesSha256Rsa15: Use TripleDes for message encryption, Sha256 for message digest, and Rsa15 for key wrap.

    默认值为“Basic256” 。The default value is Basic256.
    客户端证书 - 指纹Client certificate - Thumbprint 指定用于向服务验证此发送端口的 X.509 证书的指纹。Specify the thumbprint of the X.509 certificate for authenticating this send port to services. 可以通过使用 "浏览" 按钮导航到 "当前用户" 位置中的 " 的存储" 来选择指纹。You can select the thumbprint by navigating to the My store in the Current User location with the Browse button. 注意: 必须将客户端证书安装到承载此发送端口的发送处理程序的用户帐户的 " 当前用户 " 位置中。Note: You must install the client certificate into the Current User location of the user account for the send handler hosting this send port.

    最小长度:0Minimum length: 0

    最大长度:40Maximum length: 40

    默认值为一个空字符串。The default is an empty string.
    服务证书 - 指纹Service certificate - Thumbprint 指定用于验证服务(此发送端口要将消息发送到的服务)的 X.509 证书的指纹。Specify the thumbprint of the X.509 certificate for authenticating the service to which this send port sends messages. 你可以通过 "浏览" 按钮选择导航到 "本地计算机" 位置中的 "其他人" 存储的指纹。You can select the thumbprint navigating to the Other People store in the Local Machine location with the Browse button.

    最小长度:0Minimum length: 0

    最大长度:40Maximum length: 40

    默认值为一个空字符串。The default is an empty string.
    用户名凭据User name credentials 指定用于发送消息的凭据。Specify the credentials for sending messages. 可以通过单击 " 编辑 " 按钮来指定属性。You can specify the property by clicking the Edit button. 此选项仅对下面的“WCF-BasicHttp 发送适配器的企业单一登录可支持性”部分中列出的安全配置有效。This option is valid only for the security configuration listed in the following section, "Enterprise Single Sign-On Supportability for the WCF-BasicHttp Send Adapter."

    默认值为 " 不使用单一登录"。The default value is Do not use Single Sign-On.
    服务总线连接信息Service Bus connection information 新的,以开头 BizTalk Server 2016BizTalk Server 2016New starting with BizTalk Server 2016BizTalk Server 2016.

    选择使用共享访问签名 (SAS) 或服务总线命名空间 (ACS) 的访问控制服务。Choose to use the Shared Access Signature (SAS) or Access Control Service (ACS) of the Service Bus namespace.

    选择一个选项,然后选择 " 编辑 " 以输入密钥信息:Select an option, and then select Edit to enter the key information:

    - 共享访问签名 :输入访问密钥名称和访问密钥。- Shared Access Signature : Enter the access key name, and the access key. 这两个值都列在 " Azure 门户中。Both values are listed in the Azure portal.
    - 访问控制服务 :输入 STS URI (https://<yourNamespace>-sb.accesscontrol.windows.net/) 、颁发者名称和颁发者密钥。- Access Control Service : Enter the STS URI (https://<yourNamespace>-sb.accesscontrol.windows.net/), Issuer name, and Issuer key. 使用 Windows PowerShell 检索这些值,如 SB 消息适配器中所述。Use Windows PowerShell to retrieve these values, as described in SB-Messaging adapter.

    WCF-BasicHttp 发送适配器的企业单一 Sign-On 可支持 性WCF-BasicHttp 发送适配器可以从 SSO 服务器兑换 SSO 票证,以便仅在下表所示的安全配置中获取用户凭据。Enterprise Single Sign-On Supportability for the WCF-BasicHttp Send Adapter The WCF-BasicHttp send adapter can redeem an SSO ticket from the SSO server to obtain the user credential only in the security configurations shown in the following table.

    安全模式Security mode 传输客户端凭据类型Transport client credential type 消息客户端凭据类型Message client credential type
    TransportTransport 基本Basic 不适用N/A
    TransportTransport 摘要式Digest 不适用N/A
    TransportCredentialOnlyTransportCredentialOnly 基本Basic 不适用N/A
    TransportCredentialOnlyTransportCredentialOnly 摘要式Digest 不适用N/A
    消息Message 不适用N/A UserNameUserName
    TransportWithMessageCredentialTransportWithMessageCredential 不适用N/A UserNameUserName
  6. 在 " Wcf-basichttp 传输属性 " 对话框的 " 代理 " 选项卡上,为 WCF-BasicHttp 发送端口配置代理设置:In the WCF-BasicHttp Transport Properties dialog box, on the Proxy tab, configure the proxy setting for the WCF-BasicHttp send port:

    使用此选项Use this 要执行此操作To do this
    使用处理程序的默认代理设置Use Handler's default proxy settings 指定此发送端口是否使用承载此发送端口的发送处理程序中的代理设置。Specify whether this send port uses the proxy settings in the send handler hosting this send port.

    此为默认设置。This is the default setting.
    不使用代理Do not use proxy 指示此发送端口是否使用代理服务器。Indicate whether this send port uses a proxy server.

    默认值为清除此复选框。The default value is cleared.
    使用代理Use proxy 指示此发送端口是否使用在 Address 属性中指定的代理服务器。Indicate whether this send port uses the proxy server specified in the Address property.

    默认值为清除此复选框。The default value is cleared.
    AddressAddress 指定代理服务器的地址。Specify the address of the proxy server. 使用 httpshttp 方案,具体取决于安全配置。Use the https or the http scheme depending on the security configuration. 此地址后面可跟冒号和端口号。This address can be followed by a colon and the port number. 例如,http://127.0.0.1:8080。For example, http://127.0.0.1:8080.

    只有在选择了 " 使用代理 " 的情况下,此属性才需要值。This property requires a value only if Use proxy is selected.

    键入:StringType: String

    最大长度:256Maximum length: 256

    默认值为一个空字符串。The default is an empty string.
    用户名User name 指定用于身份验证的用户名。Specify the user name to use for authentication. 如果使用集成身份验证,则用户名将包括域,即采用“域\用户名”格式。If integrated authentication is used, the user name includes the domain, that is, domain\username. 如果使用基本身份验证或摘要式身份验证,则用户名不包括域 \ 。If Basic or Digest authentication is used, the user name does not include domain\. 只有在选择了 " 使用代理 " 的情况下,此属性才需要值。This property requires a value only if Use proxy is selected. 注意: WCF-BasicHttp 发送适配器使用代理的基本身份验证。Note: The WCF-BasicHttp send adapter uses the basic authentication for the proxy.

    键入:StringType: String

    最小长度:0Minimum length: 0

    最大长度:256Maximum length: 256

    默认值为一个空字符串。The default is an empty string.
    密码Password 指定用于身份验证的密码。Specify the password to use for authentication.

    只有在选择了 " 使用代理 " 的情况下,此属性才需要值。This property requires a value only if Use proxy is selected.

    键入:StringType: String

    最小长度:0Minimum length: 0

    最大长度:256Maximum length: 256

    默认值为一个空字符串。The default is an empty string.
  7. 在 " Wcf-basichttp 传输属性 " 对话框的 " 消息 " 选项卡上,为 SOAP Body 元素指定数据选择。In the WCF-BasicHttp Transport Properties dialog box, on the Messages tab, specify the data selection for the SOAP Body element.

    使用此选项Use this 要执行此操作To do this
    正文 -- BizTalk 请求消息正文Body -- BizTalk request message body 使用 BizTalk 消息正文部分为传出消息创建 SOAP body 元素的内容。Use the BizTalk message body part to create the content of the SOAP Body element for an outgoing message.

    此为默认设置。This is the default setting.
    模板 -- 由模板指定的内容Template -- content specified by template 使用在“XML” 文本框中提供的模板创建传出消息的 SOAP Body 元素的内容。Use the template supplied in the XML text box to create the content of the SOAP Body element for an outgoing message.

    默认值为清除此复选框。The default value is cleared.
    XMLXML 为传出消息的 SOAP Body 元素的内容键入 XML 格式的模板。Type the XML-formatted template for the content of the SOAP Body element of an outgoing message. 如果选择了“模板 -- BizTalk 响应消息正文” 选项,则此属性是必需的。This property is required if the Template -- BizTalk response message body option is selected.

    键入:StringType: String

    最小长度:0Minimum length: 0

    最大长度:32767Maximum length: 32767

    默认值为 <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/>The default is <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/>.
    信封--整个 <soap:Envelope>Envelope -- entire <soap:Envelope> 从传入消息的整个 SOAP Envelope 创建 BizTalk 消息正文部分。Create the BizTalk message body part from the entire SOAP Envelope of an incoming message. 此属性仅对要求-响应端口有效。This property is valid only for solicit-response ports.

    默认值为清除此复选框。The default value is cleared.
    Body-元素的内容 <soap:Body>Body -- contents of <soap:Body> element 使用传入消息的 SOAP Body 元素的内容创建 BizTalk 消息正文部分。Use the content of the SOAP Body element of an incoming message to create the BizTalk message body part. 如果 Body 元素具有多个子元素,则只有第一个元素将成为 BizTalk 消息正文部分。If the Body element has more than one child element, only the first element becomes the BizTalk message body part. 此属性仅对要求-响应端口有效。This property is valid only for solicit-response ports.

    此为默认设置。This is the default setting.
    路径 -- 按正文路径定位内容Path -- content located by body path 使用“正文路径表达式” 文本框中的正文路径表达式创建 BizTalk 消息正文部分。Use the body path expression in the Body path expression text box to create the BizTalk message body part. 针对传入消息的 SOAP Body 元素的直接子元素计算正文路径表达式。The body path expression is evaluated against the immediate child element of the SOAP Body element of an incoming message. 此属性仅对要求-响应端口有效。This property is valid only for solicit-response ports.

    默认值为清除此复选框。The default value is cleared.
    正文路径表达式Body path expression 键入正文路径表达式以标识传入消息中用于创建 BizTalk 消息正文部分的特定部分。Type the body path expression to identify a specific part of an incoming message used to create the BizTalk message body part. 针对传入消息的 SOAP 正文 节点的直接子元素计算此正文路径表达式。This body path expression is evaluated against the immediate child element of the SOAP Body node of an incoming message. 如果此正文路径表达式返回多个节点,则只选择第一个节点作为 BizTalk 消息正文部分。If this body path expression returns more than one node, only the first node is chosen for the BizTalk message body part. 如果选择了“路径 -- 按正文路径定位内容” 选项,则此属性是必需的。This property is required if the Path -- content located by body path option is selected. 此属性仅对要求-响应端口有效。This property is valid only for solicit-response ports.

    键入:StringType: String

    最小长度:0Minimum length: 0

    最大长度:32767Maximum length: 32767

    默认值为一个空字符串。The default is an empty string.
    节点编码Node encoding 指定 WCF-BasicHttp 发送适配器对 " 正文路径表达式 " 文本框中的正文路径表达式所标识的节点进行解码所使用的编码类型。Specify the type of encoding that the WCF-BasicHttp send adapter uses to decode for the node identified by the body path expression in the Body path expression text box. 如果选择了“路径 -- 按正文路径定位内容” 选项,则此属性是必需的。This property is required if the Path -- content located by body path option is selected. 此属性仅对要求-响应端口有效。This property is valid only for solicit-response ports. 有效值包括以下值:Valid values include the following:

    - Base64: base64 编码。- Base64: Base64 encoding.
    - 十六进制:十六进制编码。- Hex: Hexadecimal encoding.
    - String:文本编码-utf-8- String: Text encoding - UTF-8
    - XML: WCF 适配器使用 " 正文路径表达式 " 文本框中的正文路径表达式所选择的节点的外部 XML 创建 BizTalk 消息正文。- XML: The WCF adapters create the BizTalk message body with the outer XML of the node selected by the body path expression in the Body path expression text box.

    默认值为“XML” 。The default is XML.
    传播故障消息Propagate fault message 选中此复选框可将无法执行出站处理的消息路由至某个订阅应用程序(例如其他接收端口或业务流程计划)。Select this check box to route the message that fails outbound processing to a subscribing application (such as another receive port or orchestration schedule). 清除此复选框可挂起失败的消息,并生成一个否定确认 (NACK)。Clear the check box to suspend failed messages and generate a negative acknowledgment (NACK). 此属性仅对要求-响应端口有效。This property is valid only for solicit-response ports.

    默认值为选中此复选框。The default value is selected.

向发送处理程序添加代理Add a proxy to the send handler

您可以向发送端口或发送处理程序添加代理。You can add a proxy to the send port, or the send handler. 如果要在发送端口添加代理,请跳过此部分。If you are adding a proxy at the send port, then skip this section.

  1. BizTalk ServerBizTalk Server 管理控制台中,依次展开 BizTalk ServerBizTalk Server "管理"、" BizTalk 组"、" 平台设置" 和 " 适配器"。In the BizTalk ServerBizTalk Server Administration Console, expand BizTalk ServerBizTalk Server Administration, expand BizTalk Group, expand Platform Settings, and then expand Adapters.

  2. 选择 " wcf-basichttp",然后双击 "发送处理程序"。Select WCF-BasicHttp, and then double-select the send handler.

  3. 在 " 适配器处理程序属性" 的 " 常规 " 选项卡上,选择 " 属性"。In Adapter Handler Properties, on the General tab, select Properties.

  4. 在 " 代理 " 选项卡中,执行以下操作。In the Proxy tab, do the following.

    使用此选项Use this 要执行此操作To do this
    使用代理Use proxy 指示此发送处理程序是否使用代理服务器。Indicate whether this send handler uses a proxy server.

    默认值为清除此复选框。The default value is cleared.
    AddressAddress 指定代理服务器的地址。Specify the address of the proxy server. 使用 httpshttp 方案,具体取决于安全配置。Use the https or the http scheme depending on the security configuration. 此地址后面可跟冒号和端口号。This address can be followed by a colon and the port number. 例如,http://127.0.0.1:8080。For example, http://127.0.0.1:8080.

    只有在选择了 " 使用代理 " 的情况下,此属性才需要值。This property requires a value only if Use proxy is selected.

    键入:StringType: String

    最大长度:256Maximum length: 256

    默认值为一个空字符串。The default is an empty string.
    用户名User name 指定用于身份验证的用户名。Specify the user name to use for authentication. 如果使用集成或基本验证,则用户名将包括域,即采用“域\用户名”格式。If integrated or Basic authentication is used, the user name includes the domain, that is, domain\username. 如果使用摘要式身份验证,则用户名不包括域 \ 。If Digest authentication is used, the user name does not include domain\.

    只有在选择了 " 使用代理 " 的情况下,此属性才需要值。This property requires a value only if Use proxy is selected.

    键入:StringType: String

    最小长度:0Minimum length: 0

    最大长度:256Maximum length: 256

    默认值为一个空字符串。The default is an empty string.
    密码Password 指定用于身份验证的密码。Specify the password to use for authentication.

    只有在选择了 " 使用代理 " 的情况下,此属性才需要值。This property requires a value only if Use proxy is selected.

    键入:StringType: String

    最小长度:0Minimum length: 0

    最大长度:256Maximum length: 256

    默认值为一个空字符串。The default is an empty string.
  5. 单击 "确定" ,直到您退出所有对话框为止。Click OK until you exit all the dialog boxes.

    另请参阅See also

WCF 适配器概述What Are the WCF Adapters?

SB-消息适配器SB-Messaging adapter

使用适配器Using Adapters