如何設定 SOAP 傳送埠

發行項
10/14/2023

您可以使用程式設計的方式或 [BizTalk Server 管理] 主控台來設定 SOAP 傳送埠。

如何以程式設計的方式設定 SOAP 傳送埠

BizTalk Explorer 物件模型會針對具有TransportTypeData讀取/寫入屬性的傳送埠ITransportInfo公開配接器特定介面。此屬性可接受以名稱-值組的 XML 字串為形式的 SOAP 傳送埠組態屬性包。請注意，若要在 BizTalk Explorer 物件模型中設定此屬性，您必須先設定ITransportInfo介面的OutboundTransportLocation屬性。

不需要ITransportInfo介面的TransportTypeData屬性。若未設定，則配接器會使用 SOAP 傳送埠組態的預設值，如下表所示。

下表列出可在 [BizTalk 總管] 物件模型中為 SOAP 傳送埠設定的組態屬性。

屬性名稱	類型	Description
URI	字串	包含部署伺服器上 Web 服務的虛擬目錄。
使用者名稱	String	指定要用於存取目標 Web 服務的使用者名稱。預設值：空白
密碼	String	要提供給伺服器驗證的使用者密碼。預設值：空白
ClientCertificate	字串	用戶端 SSL 憑證指紋。預設值：空白
AffiliateApplicationName	字串	用於贖回用戶端憑證票證的 SSO 應用程式名稱。 AffiliateApplicationName與Username和Password配對互斥。預設值：空白
UseProxy	Boolean	指示 SOAP 傳送埠是否使用 Proxy 伺服器來存取目標 Web 服務。 Proxy 伺服器可由所有 SOAP 傳送埠共用。預設值：False
ProxyAddress	字串	用於 Web 服務呼叫的 HTTP Proxy 位址。預設值：空白
ProxyPort	整數	用於 Web 服務呼叫的 HTTP Proxy 連接埠。預設值：空白
ProxyUsername	字串	用於 Proxy 的使用者名稱。預設值：空白
ProxyPassword	字串	用於 Proxy 的密碼。預設值：空白

下列程式碼顯示用來設定這些屬性的格式：

<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 傳送配接器在其下執行此驗證類型的處理序之認證。
認證	指定要使用的認證類型。只有在驗證類型為基本或摘要時，才能使用。選項： - 請勿使用單一登入使用者名稱要提供給目的地伺服器驗證的使用者名稱。如果 Authentication 類型屬性為 Anonymous 或 NTLM，則會停用此選項。如果選取 [基本] 或 [ 摘要 ]，且未使用 Enterprise Single Sign-On，則此屬性需要值。最小長度：00 最大長度：256 密碼要提供給目的地伺服器驗證的密碼。如果 Authentication 類型屬性為 Anonymous 或 NTLM，則會停用此選項。如果選取 [基本] 或 [ 摘要 ]，且未使用 Single Sign-On，則此屬性需要值。最小長度：00 最大長度：256 - 使用單一登入指定是否要使用「單一登入」來擷取用戶端認證，以供目的地伺服器驗證。分支機搆應用程式指定要用於「單一登入」的分支機構應用程式。如需填入此清單的詳細資訊，請參閱 SSO 分支機搆應用程式。最小長度：00 最大長度：256
用戶端憑證指紋	指定要用來建立連線的用戶端憑證指紋。範例：01 23 45 67 89 AB CD EF 01 23 45 67 89 AB CD EF 01 23 45 67 最小長度：00 最大長度：59

在 [ SOAP 傳輸屬性] 對話方塊的 [ Proxy ] 索引標籤上，執行下列動作：

使用	作法
使用處理常式的預設 Proxy 組態	指定傳送埠 Proxy 處理常式組態。若為 True，連接埠將使用在處理常式層級指定的 Proxy 設定。若為 False，傳送配接器將使用在傳送埠指定的 Proxy 資訊。預設設定是 true。
不使用 Proxy	指示 SOAP 傳送處理常式是否要使用 Proxy 伺服器。
使用 Proxy	指示 SOAP 傳送處理常式是否要使用 Proxy 伺服器。 Proxy 伺服器可由所有 SOAP 傳送埠共用。
伺服器	指定 Proxy 伺服器的名稱。選取 [使用 Proxy ] 時，此屬性只需要值。類型：字串最小長度：00 最大長度：256
連接埠	指定 SOAP 傳送處理常式使用的連接埠。選取 [使用 Proxy ] 時，此屬性只需要值。預設值：80 類型：Long 最小值：0 最大值：65535 注意：指定值 0 表示使用預設值，也就是埠 80。
使用者名稱	指定要用於驗證的使用者名稱。如果您使用 Windows 整合式驗證，使用者名稱會包含網域 domain\username。如果您使用基本或摘要式驗證，則使用者名稱不包含 domain\。選取 [使用 Proxy ] 時，此屬性只需要值。類型：字串最小長度：00 最大長度：256
密碼	指定要用於驗證的密碼。選取 [使用 Proxy ] 時，此屬性只需要值。類型：字串最小長度：00 最大長度：256

在 [ SOAP 傳輸屬性] 對話方塊的 [Web 服務 ] 索引標籤上，執行下列動作：

使用	作法
協調流程 Web 連接埠	指定使用在 [ 一般 ] 索引標籤上所列之 Web 服務 URL 公開的 Web 服務。這是預設值。
組件名稱	指定包含 Web 服務 Proxy 的組件名稱。您可以按一下 [瀏覽] 按鈕找出組件，填入此欄位。在選取組件後，會以組件的完整格式名稱填入此方塊。注意：指定的元件必須存在於執行時間的所有 BizTalk 伺服器上。
類型名稱	指定包含要叫用的 Web 方法的類別名稱。可以從組件中包含的類型清單中選取此項。
方法名稱	指定清單方塊中的一個方法，或選擇 [稍後指定] 選項。若選擇 [稍後指定] 選項，則必須藉由其他方式設定 Web 方法，例如，管線元件。在此案例中，Web 方法必須寫入 Soap Adapter MethodName 內容屬性。
SOAP 1.2	指定產生支援 SOAP 1.2 通訊協定的 Proxy 程式碼。若此選項為已清除，則會產生 SOAP 1.1 相容的 Proxy 程式碼。預設值：已清除

再次按一下 [確定 ] 和 [ 確定 ] 以儲存設定。

另請參閱

發佈 Web 服務

共用方式為

如何設定 SOAP 傳送埠

設定 SOAP 傳送埠的變數

另請參閱

意見反應

其他資源