如何配置 SOAP 发送端口

项目
07/21/2023

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

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

BizTalk 资源管理器对象模型为具有 TransportTypeData 读/写属性的名为 ITransportInfo 的发送端口公开特定于适配器的接口。此属性以 XML 字符串的名称-值对形式接受 SOAP 发送端口配置属性包。请注意，若要在 BizTalk 资源管理器对象模型中设置此属性，必须先设置 ITransportInfo 接口的 OutboundTransportLocation 属性。

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

下表列出了可在 BizTalk 浏览器对象模型中为 SOAP 发送端口设置的配置属性：

属性名称	类型	说明
URI	字符串	在部署服务器上包含 Web Services 的虚拟目录。
用户名	字符串	为访问目标 Web Services 而指定的用户名。默认值：空白
密码	字符串	用于对服务器进行身份验证的用户密码。默认值：空白
ClientCertificate	字符串	客户端 SSL 证书的指纹。默认值：空白
AffiliateApplicationName	字符串	用于兑换客户端凭据票证的 SSO 应用程序的名称。 AffiliateApplicationName 与用户名和密码对互斥。默认值：空白
UseProxy	Boolean	指示 SOAP 发送端口是否使用代理服务器访问目标 Web Services。代理服务器可由所有的 SOAP 发送端口共享。默认值：False
ProxyAddress	字符串	用于 Web Services 调用的 HTTP 代理的地址。默认值：空白
ProxyPort	Integer	用于 Web Services 调用的 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 Services 的地址。注意：发送端口或接收位置的 URI 不能超过 256 个字符。
身份验证	指示要调用的 Web Services 所采用的验证方法。选项： - 匿名。默认设置。 - 基本。 SOAP 连接以纯文本形式发送用户名和密码。 - 消化。 SOAP 连接以加密格式发送密码。 - Ntlm。用户名和密码都不会通过 SOAP 连接发送。 SOAP 适配器始终为此验证类型使用运行 SOAP 发送适配器的进程的凭据。
凭据	指定要使用的凭据类型。仅当身份验证类型为 “基本 ”或“ 摘要”时可用。选项： - 请勿使用单一登录用户名对目标服务器进行验证所使用的用户名。如果 “身份验证类型” 属性为 Anonymous 或 NTLM，则禁用此选项。如果选择了 “基本” 或 “摘要” ，并且未使用企业单 Sign-On，则此属性需要一个值。最小长度：0 最大长度：256 密码对目标服务器进行验证所使用的密码。如果 “身份验证类型” 属性为 Anonymous 或 NTLM，则禁用此选项。如果选择了 “基本” 或 “摘要” ，并且未使用“单 Sign-On”，则此属性需要一个值。最小长度：0 最大长度：256 - 使用单一登录指定是否使用单一登录检索客户端凭据，以便在目标服务器上进行验证。关联应用程序指定要用于单一登录的关联应用程序。有关填充此列表的信息，请参阅 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 发送端口共享。
Server	指定代理服务器的名称。如果选择了 “使用代理” ，则此属性仅需要一个值。键入：String 最小长度：0 最大长度：256
端口	指定 SOAP 发送处理程序使用的端口。如果选择了 “使用代理” ，则此属性仅需要一个值。默认值：80 类型：长最小值：0 最大值：65535 注意：指定值 0 指示使用默认值，即端口 80。
用户名	指定用于身份验证的用户名。如果使用 Windows 集成身份验证，则用户名包括域、域\用户名。如果使用基本身份验证或摘要式身份验证，则用户名不包括 domain\。如果选择了 “使用代理” ，则此属性仅需要一个值。键入：String 最小长度：0 最大长度：256
密码	指定用于身份验证的密码。如果选择了 “使用代理” ，则此属性仅需要一个值。键入：String 最小长度：0 最大长度：256

在“ SOAP 传输属性 ”对话框中的“ Web 服务 ”选项卡上，执行以下操作：

使用此选项	要执行此操作
业务流程 Web 端口	指定以使用在“ 常规 ”选项卡上列出的 Web 服务 URL 处公开的 Web 服务。这是默认设置。
程序集名称	指定包含 Web Services 代理的程序集的名称。您可以通过单击“浏览”按钮找到程序集来填充此字段。选择程序集之后，此框将填充程序集的完全限定名称。注意：指定的程序集必须在运行时存在于所有 BizTalk 服务器上。
类型名称	指定包含要调用的 Web 方法的类的名称。可以从程序集中包含的类型列表中进行选择。
方法名称	在列表框中指定方法之一，或选择“稍后指定”选项。如果选择选项“以后指定”，则必须以其他方式（如管道组件）设置 Web 方法。在这种情况下，必须将 Web 方法写入 Soap Adapter MethodName 上下文属性。
SOAP 1.2	指定此项可生成将支持 SOAP 1.2 协议的代理代码。如果不选择此选项，则会生成符合 SOAP 1.1 的代理代码。默认值：已清除

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

另请参阅

发布 Web 服务

通过

如何配置 SOAP 发送端口

配置 SOAP 发送端口的变量

另请参阅

反馈

其他资源