可以通过编程方式或使用 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 发送端口配置变量
在 BizTalk Server 管理控制台中,创建新的发送端口,或双击现有发送端口对其进行修改。 有关详细信息,请参阅 如何创建发送端口。 配置所有发送端口选项,并为“常规”选项卡的“传输”部分中的“类型”选项指定 SOAP。
在“常规”选项卡上的“类型”旁边的“传输”部分中,单击“配置”。
在 “SOAP 传输属性 ”对话框中的“ 常规 ”选项卡上,执行以下作:
用这个 要执行的操作 Web 服务 URL 指定要调用的 Web 服务的地址。 注意: 发送端口或接收位置的 URI 不能超过 256 个字符。 身份验证 指示所调用的 Web 服务使用的身份验证方法。
选项:
- 匿名。 默认设置。
- 基本。 SOAP 连接以纯文本形式发送用户名和密码。
- 摘要验证。 SOAP 连接以加密格式发送密码。
- NTLM 。 用户名和密码都不会通过 SOAP 连接发送。 SOAP 适配器始终使用运行 SOAP 发送适配器的进程凭据进行身份验证。凭据 指定要使用的凭据类型。
仅当 身份验证类型 为 “基本 ”或“ 摘要”时可用。
选项:
- 请勿使用单一登录
用户名
用于向目标服务器进行身份验证的用户名。 如果 身份验证类型 属性为 Anonymous 或 NTLM,则禁用此选项。 如果选择 了“基本 ”或 “摘要 ”,并且不使用企业单一 Sign-On,则此属性需要一个值。
最小长度:0
最大长度:256
密码
用于向目标服务器进行身份验证的密码。 如果 身份验证类型 属性为 Anonymous 或 NTLM,则禁用此选项。 如果选择了 “基本 ”或 “摘要 ”,并且不使用“单 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在 “SOAP 传输属性 ”对话框中的“ 代理 ”选项卡上,执行以下作:
用这个 要执行的操作 使用处理程序的默认代理配置 指定发送端口代理处理程序配置。 如果为 true,端口将使用在处理程序级别指定的代理设置。 如果为 false,则发送适配器将使用在发送端口上指定的代理信息。
默认设置为 true。不使用代理 指示 SOAP 发送处理程序是否使用代理服务器。 使用代理 指示 SOAP 发送处理程序是否使用代理服务器。 代理服务器可由所有 SOAP 发送端口共享。 服务器 指定代理服务器的名称。
仅当选择了 “使用代理” 时,此属性才需要一个值。
类型:字符串
最小长度:0
最大长度:256端口 指定 SOAP 发送处理程序使用的端口。
仅当选择了 “使用代理” 时,此属性才需要一个值。
默认值:80
类型:Long
最小值:0
最大值:65535 注意: 指定值 0 表示使用默认值,即端口 80。用户名 指定要用于身份验证的用户名。 如果使用 Windows 集成身份验证,则用户名包括域、 域\用户名。 如果使用“基本”或“摘要式身份验证”,则用户名不包括 域\。
仅当选择了 “使用代理” 时,此属性才需要一个值。
类型:字符串
最小长度:0
最大长度:256密码 指定要用于身份验证的密码。
仅当选择了 “使用代理” 时,此属性才需要一个值。
类型:字符串
最小长度:0
最大长度:256在 “SOAP 传输属性 ”对话框中的 “Web 服务 ”选项卡上,执行以下作:
用这个 要执行的操作 编排 Web 端口 指定使用在“ 常规 ”选项卡上列出的 Web 服务 URL 上公开的 Web 服务。
这是默认设置。程序集名称 指定包含 Web 服务代理的程序集的名称。 可以通过单击浏览按钮查找程序集来填充此字段。 选择程序集后,此框将填充程序集的完全限定名称。 注意: 指定的程序集必须存在于运行时的所有 BizTalk 服务器上。 类型名称 指定要调用的 Web 方法的类的名称。 可以从程序集中包含的类型列表中进行选择。 方法名称 在列表框中指定其中一种方法,或选择“稍后指定”选项。 如果选择了“稍后指定”选项,则必须通过一些其他方式(例如管道组件)设置 Web 方法。 在此方案中,Web 方法必须写入 Soap Adapter MethodName 上下文属性。 SOAP 1.2 指定生成将支持 SOAP 1.2 协议的代理代码。 如果此选项保持清除状态,将生成符合 SOAP 1.1 的代理代码。
默认值:已清除单击“确定”,然后再次单击“确定”以保存设置。