共用方式為


如何設定SOAP傳送埠

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

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

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

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

下表列出您可以在適用於SOAP傳送埠的BizTalk Explorer物件模型中設定的組態屬性。

屬性名稱 類型 說明
URI 繩子 虛擬目錄,其中包含部署伺服器上的 Web 服務。
使用者名稱 繩子 要指定用來存取目標 Web 服務的用戶名稱。

默認值:空白
密碼 繩子 要用於向伺服器進行驗證的用戶密碼。

默認值:空白
ClientCertificate 繩子 用戶端 SSL 憑證的指紋。

默認值:空白
AffiliateApplicationName 繩子 用於客戶端憑證票據兌換的 SSO 應用程式名稱。

AffiliateApplicationNameUsernamePassword 配對無法共存。

默認值:空白
UseProxy 布爾邏輯 指出 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傳送埠的變數

  1. 在 BizTalk Server 管理控制台中,建立新的傳送埠,或按兩下現有的傳送埠加以修改。 如需詳細資訊,請參閱 如何建立傳送埠。 設定所有傳送埠選項,並在 [一般] 索引標籤的 [傳輸] 區段中指定 [類型] 選項的 SOAP

  2. 在 [一般] 索引標籤的 [類型] 旁的 [傳輸] 區段中,按兩下 [設定]。

  3. 在 [ SOAP 傳輸屬性] 對話方塊的 [ 一般 ] 索引標籤上,執行下列動作:

    使用此 若要這樣做
    Web 服務 URL 指定您要呼叫之 Web 服務的位址。 注意: 傳送埠或接收位置的 URI 不能超過 256 個字元。
    驗證 指出您呼叫的 Web 服務所使用的驗證方法。

    選項:

    - 匿名。 默認設定。
    - 基本。 SOAP 聯機會以純文字傳送使用者名稱和密碼。
    - 摘要。 SOAP 連線會以加密格式傳送密碼。
    - NTLM 。 用戶名稱和密碼都不會透過SOAP連線傳送。 SOAP 配接器始終會使用執行 SOAP 傳送配接器的程序的認證來進行此驗證類型。
    認證 指定要使用的認證類型。

    只有在 驗證類型基本摘要時,才能使用。

    選項:

    - 請勿使用單一登錄
    使用者名稱
    要用於向目的地伺服器進行驗證的用戶名稱。 如果 Authentication 類型 屬性為 AnonymousNTLM,則會停用此選項。 如果已選取 [基本 ] 或 [ 摘要 ],且未使用 Enterprise Single Sign-On,則此屬性需要值。
    最小長度:0
    最大長度:256
    密碼
    要用於向目的地伺服器進行驗證的密碼。 如果 Authentication 類型 屬性為 AnonymousNTLM,則會停用此選項。 如果已選取 [基本 ] 或 [ 摘要 ],則此屬性需要值,且不使用 Single 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 傳輸屬性 ] 對話方塊的 [ Proxy] 索引標籤上,執行下列動作:

    使用此 若要這樣做
    使用處理程序的預設 Proxy 組態 指定傳送埠 Proxy 處理程式組態。 若為 true,埠會使用處理程式層級指定的 Proxy 設定。 若為 false,傳送配接器會使用傳送埠上指定的 Proxy 資訊。

    默認設定為 true。
    不使用 Proxy 指出 SOAP 傳送處理程式是否使用 Proxy 伺服器。
    使用 Proxy 指出 SOAP 傳送處理程式是否使用 Proxy 伺服器。 Proxy 伺服器可由所有 SOAP 傳送埠共用。
    伺服器 指定 Proxy 伺服器的名稱。

    如果已選取 [使用 Proxy ],則此屬性只需要值。

    類型:字串

    最小長度:0

    最大長度:256
    通訊埠 指定 SOAP 傳送處理程式所使用的埠。

    如果已選取 [使用 Proxy ],則此屬性只需要值。

    默認值:80

    類型:長

    最小值:0

    最大值:65535 注意: 指定 0 值表示使用預設值,也就是埠 80。
    使用者名稱 指定要用於驗證的用戶名稱。 如果您使用 Windows 整合式驗證,用戶名稱會包含 網域、domain\username。 如果您使用基本或摘要式驗證,則使用者名稱不包含 domain\

    如果已選取 [使用 Proxy ],則此屬性只需要值。

    類型:字串

    最小長度:0

    最大長度:256
    密碼 指定要用於驗證的密碼。

    如果已選取 [使用 Proxy ],則此屬性只需要值。

    類型:字串

    最小長度:0

    最大長度:256
  5. 在 [ SOAP 傳輸屬性 ] 對話方塊的 [ Web 服務 ] 索引標籤上,執行下列動作:

    使用此 若要這樣做
    協調網路埠 指定使用公開在 [ 一般 ] 索引標籤上所列之 Web 服務 URL 上的 Web 服務。

    這是預設設定。
    組件名稱 指定包含 Web 服務 Proxy 的元件名稱。 點擊瀏覽按鈕以尋找組件,即可填入此欄位。 選取元件之後,這個方塊會填入元件的完整名稱。 注意: 指定的元件必須存在於執行期間的所有 BizTalk 伺服器上。
    類型名稱 指定要叫用之 Web 方法的類別名稱。 這可以從元件中包含的類型清單中選取。
    方法名稱 在清單框中指定其中一種方法,或選擇 [稍後指定] 選項。 如果選擇 [稍後指定] 選項,Web 方法必須透過一些其他方式來設定,例如管線元件。 在此案例中,Web 方法必須寫入 Soap Adapter MethodName 內容屬性。
    SOAP 1.2 指定 以產生將支援SOAP 1.2通訊協定的 Proxy 程式代碼。 如果已清除此選項,就會產生符合SOAP 1.1規範的 Proxy 程式代碼。

    預設值:已清除
  6. 再次按下 [確定 ] 和 [ 確定 ] 以儲存設定。

另請參閱

發佈 Web 服務