如何配置 SOAP 发送端口

可以通过编程方式或使用 BizTalk Server 管理控制台配置 SOAP 发送端口。

如何以编程方式配置 SOAP 发送端口

BizTalk Explorer 对象模型公开了一个适用于发送端口的适配器专用接口,名为 ITransportInfo,其具有 TransportTypeData 读/写属性。 此属性接受 SOAP 发送端口配置属性包,格式为 XML 字符串的名称/值对。 请注意,若要在 BizTalk Explorer 对象模型中设置此属性,必须先设置 ITransportInfo 接口的 OutboundTransportLocation 属性。

无需 ITransportInfo 接口的 TransportTypeData 属性。 如果未设置,适配器将使用 SOAP 发送端口配置的默认值,如下表所示。

下表列出了可以在用于 SOAP 发送端口的 BizTalk 资源管理器对象模型中设置的配置属性。

属性名称 类型 DESCRIPTION
URI 字符串 包含部署服务器上的 Web 服务的虚拟目录。
用户名 字符串 要指定用于访问目标 Web 服务的用户名。

默认值:空白
密码 字符串 用于向服务器进行身份验证的用户密码。

默认值:空白
ClientCertificate 字符串 客户端 SSL 证书的指纹。

默认值:空白
AffiliateApplicationName 字符串 用于兑换客户端凭据票证的 SSO 应用程序的名称。

AffiliateApplicationName用户名密码组合互斥。

默认值:空白
UseProxy 布尔型 指示 SOAP 发送端口是否使用代理服务器访问目标 Web 服务。 代理服务器可由所有 SOAP 发送端口共享。

默认值:False
ProxyAddress 字符串 用于 Web 服务调用的 HTTP 代理的地址。

默认值:空白
ProxyPort 整数 用于 Web 服务调用的 HTTP 代理的端口。

默认值:空白
ProxyUsername 字符串 要用于代理的用户名。

默认值:空白
ProxyPassword 字符串 用于代理的密码。

默认值:空白

以下代码显示用于设置这些属性的格式:

<CustomProps>  
   <URI vt="8"/>  
   <ClientCertificate vt="8"/>  
   <Password vt="8">Encrypted</Password>  
   <ProxyAddress vt="8"/>  
   <ProxyPassword vt="8">Encrypted</ProxyPassword>  
   <ProxyPort vt="3"/>  
   <ProxyUsername vt="8"/>  
   <UseProxy vt="11"/>  
   <Username vt="8"/>  
   <AffiliateApplicationName vt="8"/>  
</CustomProps>  

如何使用 BizTalk Server 管理控制台配置 SOAP 发送端口

可以在 BizTalk Server 管理控制台中设置 SOAP 发送端口适配器变量。 如果未为发送端口设置属性,将使用 BizTalk Server 管理控制台中设置的默认发送处理程序值。

为 SOAP 发送端口配置变量

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

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

  3. “SOAP 传输属性 ”对话框中的“ 常规 ”选项卡上,执行以下作:

    用这个 要执行的操作
    Web 服务 URL 指定要调用的 Web 服务的地址。 注意: 发送端口或接收位置的 URI 不能超过 256 个字符。
    身份验证 指示所调用的 Web 服务使用的身份验证方法。

    选项:

    - 匿名。 默认设置。
    - 基本。 SOAP 连接以纯文本形式发送用户名和密码。
    - 摘要验证。 SOAP 连接以加密格式发送密码。
    - NTLM 。 用户名和密码都不会通过 SOAP 连接发送。 SOAP 适配器始终使用运行 SOAP 发送适配器的进程凭据进行身份验证。
    凭据 指定要使用的凭据类型。

    仅当 身份验证类型“基本 ”或“ 摘要”时可用。

    选项:

    - 请勿使用单一登录
    用户名
    用于向目标服务器进行身份验证的用户名。 如果 身份验证类型 属性为 AnonymousNTLM,则禁用此选项。 如果选择 了“基本 ”或 “摘要 ”,并且不使用企业单一 Sign-On,则此属性需要一个值。
    最小长度:0
    最大长度:256
    密码
    用于向目标服务器进行身份验证的密码。 如果 身份验证类型 属性为 AnonymousNTLM,则禁用此选项。 如果选择了 “基本 ”或 “摘要 ”,并且不使用“单 Sign-On”,则此属性需要一个值。
    最小长度:0
    最大长度:256
    - 使用单一登录
    指定是否使用单一 Sign-On 来获取客户端凭据,以用于与目标服务器进行身份验证。
    关联应用程序
    指定要用于单一登录的关联应用程序。 有关填充此列表的信息,请参阅 SSO 关联应用程序
    最小长度:0
    最大长度:256
    客户端证书指纹 指定用于建立连接的客户端证书的指纹。

    示例:01 23 45 67 89 AB CD EF 01 23 45 67 89 AB CD EF 01 23 45 67

    最小长度:0

    最大长度:59
  4. “SOAP 传输属性 ”对话框中的“ 代理 ”选项卡上,执行以下作:

    用这个 要执行的操作
    使用处理程序的默认代理配置 指定发送端口代理处理程序配置。 如果为 true,端口将使用在处理程序级别指定的代理设置。 如果为 false,则发送适配器将使用在发送端口上指定的代理信息。

    默认设置为 true。
    不使用代理 指示 SOAP 发送处理程序是否使用代理服务器。
    使用代理 指示 SOAP 发送处理程序是否使用代理服务器。 代理服务器可由所有 SOAP 发送端口共享。
    服务器 指定代理服务器的名称。

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

    类型:字符串

    最小长度:0

    最大长度:256
    端口 指定 SOAP 发送处理程序使用的端口。

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

    默认值:80

    类型:Long

    最小值:0

    最大值:65535 注意: 指定值 0 表示使用默认值,即端口 80。
    用户名 指定要用于身份验证的用户名。 如果使用 Windows 集成身份验证,则用户名包括域、 域\用户名。 如果使用“基本”或“摘要式身份验证”,则用户名不包括 域\

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

    类型:字符串

    最小长度:0

    最大长度:256
    密码 指定要用于身份验证的密码。

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

    类型:字符串

    最小长度:0

    最大长度:256
  5. “SOAP 传输属性 ”对话框中的 “Web 服务 ”选项卡上,执行以下作:

    用这个 要执行的操作
    编排 Web 端口 指定使用在“ 常规 ”选项卡上列出的 Web 服务 URL 上公开的 Web 服务。

    这是默认设置。
    程序集名称 指定包含 Web 服务代理的程序集的名称。 可以通过单击浏览按钮查找程序集来填充此字段。 选择程序集后,此框将填充程序集的完全限定名称。 注意: 指定的程序集必须存在于运行时的所有 BizTalk 服务器上。
    类型名称 指定要调用的 Web 方法的类的名称。 可以从程序集中包含的类型列表中进行选择。
    方法名称 在列表框中指定其中一种方法,或选择“稍后指定”选项。 如果选择了“稍后指定”选项,则必须通过一些其他方式(例如管道组件)设置 Web 方法。 在此方案中,Web 方法必须写入 Soap Adapter MethodName 上下文属性。
    SOAP 1.2 指定生成将支持 SOAP 1.2 协议的代理代码。 如果此选项保持清除状态,将生成符合 SOAP 1.1 的代理代码。

    默认值:已清除
  6. 单击“确定”,然后再次单击“确定”以保存设置。

另请参阅

发布 Web 服务