WCF-BasicHttpRelay 配接器

Microsoft BizTalk Server使用WCF-BasicHttpRelay配接器，透過BasicHttpRelayBinding 類別接收和傳送 WCF 服務要求。 WCF-BasicHttpRelay配接器會使用使用 BasicHttpRelayBinding的服務匯流排轉送端點。

開始之前

從 BizTalk Server 2016 開始，此配接器可以使用 存取控制 Service (ACS) 或共用存取簽章 (SAS) ，以使用服務匯流排進行擷取。 建議您在使用服務匯流排進行驗證時，使用共用存取簽章 (SAS) 。

當您建立服務匯流排命名空間時，不會自動建立存取控制 (ACS) 命名空間。 如果您使用 ACS 進行驗證，您可能需要建立新的 ACS 命名空間。 如需詳細資訊，請參閱 SB-Messaging 配接 器，包括擷取 ACS 金鑰值的步驟。

建立接收位置

注意

完成下列程式之前，您必須先新增單向接收埠。 請參閱 如何建立接收埠。

1. 在 [BizTalk Server管理主控台] 中，依序展開 [管理] BizTalk Server [管理]、[BizTalk 群組]、[應用程式] 和 [您要建立接收位置] 底下的應用程式。

2. 在左窗格中按一下 [接收埠] 節點，在右窗格中以滑鼠右鍵按一下您想與新接收位置建立關聯的接收埠，然後按一下 [屬性]。

3. 在 [ 接收埠內容 ] 對話方塊的左窗格中，選取 [ 接收位置]，然後在右窗格中按一下 [ 新增 ] 以建立新的接收位置。

4. 在 [接收位置屬性]對話方塊的 [傳輸] 區段中，從 [類型] 下拉式清單中選取[WCF-BasicHttpRelay]，然後按一下 [設定] 來設定接收位置的傳輸屬性。

5. 在 [WCF-BasicHttpRelay 傳輸屬性 ] 對話方塊的 [ 一般 ] 索引標籤上，設定裝載服務匯流排轉送端點的端點位址，以及 WCF-BasicHttpRelay 接收位置的服務識別。

   使用	作法
   位址 (URI)	必要。 指定已部署服務匯流排轉接端點的 URI。
   端點識別	選擇性。 指定端點識別。 這些設定可讓端點驗證此接收位置。 在端點與接收位置之間的交握程序中，Windows Communication Foundation (WCF) 基礎結構可確保預期之服務的識別與此元素的值相符。 預設為空字串。

6. 在 [WCF-BasicHttpRelay 傳輸屬性 ] 對話方塊的 [ 系結 ] 索引標籤上，設定逾時和編碼相關的屬性。

   使用	作法
   啟用等候逾時 (hh:mmss)	指定時間值，表示可供完成通道開啟作業的時間間隔。 這個值應大於或等於 System.TimeSpan.Zero。 預設值：00:01:00 最大值：23：59：59
   傳送逾時 (hh:mmss)	指定時間值，表示可供完成傳送作業的時間間隔。 這個值應大於或等於 System.TimeSpan.Zero。 如果您使用要求-回應接收埠，這個值會指定完成整個互動的時間長度，即使服務傳回很大的訊息也是如此。 預設值：00:01:00 最大值：23：59：59
   關閉逾時 (hh:mmss)	指定時間值，表示可供完成通道關閉作業的時間間隔。 這個值應大於或等於 System.TimeSpan.Zero。 預設值：00:01:00 最大值：23：59：59
   接收訊息大小上限 (以位元組為單位)	以位元組為單位，指定可在網路上接收的訊息大小上限 (含標頭)。 訊息的大小受限於配置給每個訊息的記憶體數量。 您可以使用這個屬性來限制遭受拒絕服務 (DoS) 攻擊的風險程度。 WCF-BasicHttpRelay 配接器會利用緩衝傳輸模式中的 BasicHttpRelayBinding 類別來與端點通訊。 對於緩衝傳輸模式， BasicHttpRelayBinding.MaxBufferSize 屬性一律等於此屬性的值。 預設值：65536 最大值：2147483647
   訊息編碼	指定用來為 SOAP 訊息編碼的編碼器。 有效值如下： - 文字：使用簡訊編碼器。 - Mtom：使用訊息傳輸組織機制 1.0 (MTOM) 編碼器。 預設值為 Text。
   文字編碼	指定當 Message 編碼 屬性設定為 Text時，用來在系結上發出訊息的字元集編碼。 有效值如下： - utf-16BE (unicodeFFFE) ：Unicode BigEndian 編碼。 - utf-16：16 位編碼。 - utf-8：8 位編碼 預設值為 utf-8。
   同時呼叫數目上限	指定對單一服務執行個體的並行呼叫數目。 超出上限的呼叫將排入佇列。 將此值設定為 0 相當於將它設定為 Int32.MaxValue。 預設值為 200。

7. 在 [WCF-BasicHttpRelay 傳輸屬性 ] 對話方塊的 [ 安全性 ] 索引標籤上，定義 WCF-BasicHttpRelay 接收位置的安全性功能。

   使用	作法
   安全性模式	指定使用的安全性類型。 有效值如下： - 無：傳輸期間不會保護訊息。 - 傳輸：使用 HTTPS 傳輸提供安全性。 使用 HTTPS 來維護 SOAP 訊息的安全。 若要使用這個模式，您必須在 Microsoft Internet Information Services (IIS) 中設定「安全通訊端層」(SSL)。 - 訊息：透過 HTTP 傳輸使用 SOAP 訊息安全性來提供安全性。 根據預設，SOAP 本文 會加密並簽署。 WCF-Basic 配接器的唯一有效 訊息用戶端認證類型 是 憑證。 這種模式需要使用 HTTP 傳輸。 使用此安全性模式時，必須透過 服務憑證 - 指紋 屬性提供此接收位置的服務憑證。 - TransportWithMessageCredential：HTTPS 傳輸會提供完整性、機密性和服務驗證。 若要使用這個模式，您必須在 Microsoft Internet Information Services (IIS) 中設定「安全通訊端層」(SSL)。 預設值為 [傳輸]。
   [憑證]	只有在您將上方的安全性模式設定為 Message 或TransportWithMessageCredential時，才指定訊息層級安全性選項。 有效值如下： - UserName：啟用此接收位置，要求用戶端使用 UserName 認證進行驗證。 您必須建立對應到用戶端認證的網域或本機使用者帳戶。 - 憑證：用戶端會使用用戶端憑證向這個接收位置進行驗證。 用戶端 X.509 憑證的 CA 憑證鏈結必須安裝在這部電腦的「信任的根憑證授權單位」憑證存放區中，才可以向這個接收位置驗證用戶端。 預設值為 UserName。
   演算法套件	只有在將上方 的安全性模式 設定為 Message 或 TransportWithMessageCredential時，才指定訊息加密和金鑰包裝演算法。 如果您將 [安全性] 模式 設定為 [無 ] 或 [ 傳輸]，則不適用。 這些演算法會對應到安全性原則語言 (WS-SecurityPolicy) 規格中所指定的演算法。 可能的值包括： - 基本128：使用 Aes128 加密、Sha1 用於訊息摘要，Rsa-oaep-mgf1p 用於金鑰包裝。 - Basic128Rsa15：使用 Aes128 進行訊息加密、Sha1 用於訊息摘要，Rsa15 用於金鑰換行。 - Basic128Sha256：使用 Aes256 進行訊息加密、Sha256 用於訊息摘要，Rsa-oaep-mgf1p 用於金鑰包裝。 - Basic128Sha256Rsa15：使用 Aes128 進行訊息加密、Sha256 用於訊息摘要，Rsa15 用於金鑰換行。 - Basic192：使用 Aes192 加密、Sha1 進行訊息摘要，Rsa-oaep-mgf1p 用於金鑰包裝。 - Basic192Rsa15：使用 Aes192 進行訊息加密、Sha1 用於訊息摘要，Rsa15 用於金鑰換行。 - Basic192Sha256：使用 Aes192 進行訊息加密、Sha256 用於訊息摘要，Rsa-oaep-mgf1p 用於金鑰包裝。 - Basic192Sha256Rsa15：使用 Aes192 進行訊息加密、Sha256 用於訊息摘要，Rsa15 用於金鑰包裝。 - Basic256：使用 Aes256 加密、Sha1 進行訊息摘要，Rsa-oaep-mgf1p 用於金鑰包裝。 - Basic256Rsa15：使用 Aes256 進行訊息加密、Sha1 用於訊息摘要，Rsa15 用於金鑰包裝。 - Basic256Sha256：使用 Aes256 進行訊息加密、Sha256 用於訊息摘要，Rsa-oaep-mgf1p 用於金鑰包裝。 - Basic256Sha256Rsa15：使用 Aes256 進行訊息加密、Sha256 用於訊息摘要，Rsa15 用於金鑰包裝。 - TripleDes：使用 TripleDes 加密，Sha1 用於訊息摘要，Rsa-oaep-mgf1p 用於金鑰包裝。 - TripleDesRsa15：使用 TripleDes 加密、Sha1 用於訊息摘要，Rsa15 用於金鑰包裝。 - TripleDesSha256：使用 TripleDes 進行訊息加密、Sha256 用於訊息摘要，以及 Rsa-oaep-mgf1p 用於金鑰包裝。 - TripleDesSha256Rsa15：使用 TripleDes 進行訊息加密、Sha256 用於訊息摘要，Rsa15 用於金鑰包裝。 預設值為 Basic256。
   服務憑證 - 指紋	針對此接收位置指定用戶端用來驗證服務之 X.509 憑證的憑證指紋。 您可以使用 [瀏覽] 按鈕瀏覽至 「目前使用者」 位置的 My 存放區，以選取憑證指紋。 注意： 只有在將上方 的安全性模式 設定為 Message 或 TransportWithMessageCredential時，才必須設定此屬性。 如果您將 [安全性] 模式 設定為 [無 ] 或 [ 傳輸]，則不適用。 注意： 您必須針對裝載此接收位置的接收處理常式，將服務憑證安裝到使用者帳戶的 目前使用者 位置。 最小長度：00 最大長度：40 預設為空字串。
   轉接用戶端驗證類型	指定用於驗證接收訊息之服務匯流排轉接端點的選項。 有效值如下： - 無：不需要驗證。 - RelayAccessToken：指定此選項以使用安全性權杖來授權服務匯流排轉送端點。 預設值為 RelayAccessToken。
   啟用服務探索	選取此核取方塊，指定是否在服務登錄中發佈此服務的行為。 - 顯示名稱 – 指定服務發佈至服務登錄的名稱。 - 探索模式 – 為服務登錄中發佈的服務設定探索模式。 如需詳細資訊，請參閱 DiscoveryType 列舉。
   存取控制服務	適用于 BizTalk Server 2013 R2 和 BizTalk Server 2013。 如果將 [轉接用戶端驗證類型] 設定為 [RelayAccessToke]，請按一下 [編輯] 按鈕並指定下列詳細資料： - 存取控制服務 STS Uri – 將此設定為 https://<Namespace>-sb.accesscontrol.windows.net/ ，其中 < namespace > 是您的服務匯流排命名空間。 - 簽發者名稱 – 指定簽發者名稱。 此值通常設定為擁有者。 - 簽發者金鑰 – 指定簽發者金鑰。
   服務匯流排連線資訊	從 BizTalk Server 2016 開始的新功能。 選擇使用服務匯流排命名空間的共用存取簽章 (SAS) 或存取控制服務 (ACS) 。 選取選項，然後選取 [ 編輯 ] 以輸入金鑰資訊： - 共用存取簽章 ：輸入存取金鑰名稱和存取金鑰。 這兩個值都會列在Azure 入口網站中。 - 存取控制服務：輸入 STS URI () https://<yourNamespace>-sb.accesscontrol.windows.net/ 、簽發者名稱和簽發者金鑰。 使用Windows PowerShell來擷取這些值，如SB-Messaging 配接器中所述。

8. 在 [WCF-BasicHttpRelay 傳輸屬性 ] 對話方塊的 [ 訊息 ] 索引標籤上，指定 SOAP Body 元素的資料選取範圍。

   使用	作法
   Envelope -- 整個 < soap：Envelope>	從內送訊息的整個 SOAP 信封 建立 BizTalk 訊息內文部分。 預設值為清除核取方塊。
   Body -- soap：Body > 元素的內容 <	使用內送訊息的 SOAP Body 元素內容來建立 BizTalk 訊息內文部分。 如果 Body 元素有一個以上的子元素，則只有第一個元素會成為 BizTalk 訊息內文部分。 這是預設值。
   路徑 -- 內容由內文路徑定位	使用 [內文路徑運算式] 文字方塊中的內文路徑運算式，建立 BizTalk 訊息內文部分。 內文路徑運算式會依照內送訊息 SOAP Body 元素的直系子元素來進行評估。 預設值為清除核取方塊。
   [內文路徑運算式]	輸入內文路徑運算式，以識別用來建立 BizTalk 訊息內文部分的內送訊息特定部分。 這個內文路徑運算式會依照內送訊息 SOAP Body 元素的直系子項目來進行評估。 如果此內文路徑運算式傳回一個以上的節點，則只會為 BizTalk 訊息內文部分選擇第一個節點。 如果選取了 [路徑 -- 內容由內文路徑定位] 選項，就需要此屬性。 類型：字串 最小長度：00 最大長度：32767 預設為空字串。
   節點編碼	指定 WCF-BasicHttpRelay 接收配接器用來解碼主體路徑運算式在 [ 本文路徑運算式 ] 文字方塊中識別的節點編碼類型。 如果選取了 [路徑 -- 內容由內文路徑定位] 選項，就需要此屬性。 有效值如下： - Base64：Base64編碼。 - 十六進位：十六進位編碼。 - 字串：文字編碼 - UTF-8 - XML：WCF 配接器會在 [ 本文路徑運算式 ] 文字方塊中，使用主體路徑運算式所選取節點的外部 XML 來建立 BizTalk 訊息本文。 預設值為 XML。
   內文 -- BizTalk 回應訊息內文	使用 BizTalk 訊息內文部分建立外寄回應訊息的 SOAP 內文 元素內容。 此屬性只適用於要求-回應接收位置。 這是預設值。
   範本 -- 由範本指定的內容	使用 [XML] 文字方塊中提供的範本來建立外寄訊息的 SOAP 內文 元素內容。 此屬性只適用於要求-回應接收位置。 預設值為清除核取方塊。
   XML	針對外寄訊息的 SOAP 內文 元素內容，輸入 XML 格式的範本。 如果選取了 [範本 -- BizTalk 回應訊息本文] 選項，就需要此屬性。 此屬性只適用於要求-回應接收位置。 類型：字串 最小長度：00 最大長度：32767 預設值為 <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml">。
   失敗時擱置的要求訊息	指定是否擱置因接收管線失敗或路由失敗而造成輸入處理失敗的要求訊息。 預設值為清除核取方塊。
   錯誤中包含例外狀況詳細資料	指定是否要將在錯誤發生時傳回 SOAP 錯誤以方便偵錯。 預設值為清除核取方塊。

9. 按一下 [確定]。

10. 在 [接收位置屬性] 對話方塊中輸入適當的值，以完成接收位置的組態，然後按一下 [確定] 儲存設定值。 如需 [接收位置屬性] 對話方塊的詳細資訊，請參閱 如何建立接收位置。

建立傳送埠

1. 在 [BizTalk 管理主控台] 中建立新的傳送埠，或按兩下現有的傳送埠進行修改。 請參閱 如何建立傳送埠。 設定所有傳送埠選項，並針對 [一般] 索引標籤的 [傳輸] 區段中的[類型]選項指定WCF-BasicHttpRelay。

2. 在 [ 一般] 索引標籤的 [ 傳輸 ] 區段中，按一下 [ 設定 ] 按鈕。

3. 在 [WCF-BasicHttpRelay 傳輸屬性 ] 對話方塊的 [ 一般 ] 索引標籤上，指定下列專案：

   使用	作法
   位址 (URI)	必要。 指定轉送端點部署在服務匯流排上的 URL。 URL 通常會使用下列格式： https://<namespace>.servicebus.windows.net/
   端點識別	選擇性。 指定端點識別。 這些設定可讓此傳送埠向端點進行驗證。 在端點與傳送埠之間的交握程式中，Windows Communication Foundation (WCF) 基礎結構可確保端點識別符合這個專案的值。 預設值為清除核取方塊。
   動作	指定傳出訊息的 SOAPAction HTTP 標頭欄位。 您也可以透過訊息內容屬性 WCF 來設定這個屬性 。 管線或協調流程中的動作。 您可以透過兩種不同的方式指定此值：單一動作格式和動作對應格式。 如果您以單一動作格式設定此屬性，例如， http://contoso.com/Svc/Op1 傳出訊息的 SOAPAction 標頭一律會設定為此屬性中指定的值。 如果您以動作對應格式設定此屬性，則傳出 SOAPAction 標頭是由 BTS 決定。作業 內容屬性。 例如，如果此屬性設定為下列 XML 格式和BTS。Operation屬性設定為 Op1，WCF 傳送配接器會針對傳出SOAPAction標頭使用 http://contoso.com/Svc/Op1 。 <BtsActionMapping> <Operation Name="Op1" Action="http://contoso.com/Svc/Op1" /> <Operation Name="Op2" Action="http://contoso.com/Svc/Op2" /> </BtsActionMapping> 如果傳出訊息來自協調流程埠，協調流程實例就會動態設定 BTS。具有 埠作業名稱的 Operation 屬性。 如果傳出訊息是以內容為基礎的路由傳送，您可以設定 BTS。 管線元件中的 Operation 屬性。 重要： 服務匯流排會強制在傳送訊息至轉送端點時設定 SOAP 動作。 最小長度：00 最大長度：32767 預設為空字串。

4. 在 [WCF-BasicHttpRelay 傳輸屬性 ] 對話方塊的 [ 系 結] 索引標籤上，設定逾時和編碼屬性。

   使用	作法
   啟用等候逾時 (hh:mmss)	指定時間值，表示可供完成通道開啟作業的時間間隔。 這個值應大於或等於 System.TimeSpan.Zero。 預設值：00:01:00 最大值：23：59：59
   傳送逾時 (hh:mmss)	指定時間值，表示可供完成傳送作業的時間間隔。 這個值應大於或等於 System.TimeSpan.Zero。 如果您使用請求-回應傳送埠，這個值會指定完成整個互動的時間長度，即使服務傳回很大的訊息也是如此。 預設值：00:01:00 最大值：23：59：59
   關閉逾時 (hh:mmss)	指定時間值，表示可供完成通道關閉作業的時間間隔。 此值應大於或等於 System.TimeSpan.Zero。 預設值：00:01:00 最大值：23：59：59
   接收訊息大小上限 (以位元組為單位)	以位元組為單位，指定可在網路上接收的訊息大小上限 (含標頭)。 訊息的大小受限於配置給每個訊息的記憶體數量。 您可以使用這個屬性來限制遭受拒絕服務 (DoS) 攻擊的風險程度。 WCF-BasicHttpRelay 配接器會利用緩衝傳輸模式中的 BasicHttpBinding 類別來與端點通訊。 對於緩衝傳輸模式， BasicHttpBinding.MaxBufferSize 屬性一律等於此屬性的值。 預設值：65536 最大值：2147483647
   訊息編碼	指定用來為 SOAP 訊息編碼的編碼器。 有效值如下： - 文字：使用簡訊編碼器。 - Mtom：使用訊息傳輸組織機制 1.0 (MTOM) 編碼器。 預設值： 文字
   文字編碼	指定當 Message 編碼 屬性設定為 Text時，用於在系結上發出訊息的字元集編碼。 有效值如下： - utf-16BE (unicodeFFFE) ：Unicode BigEndian 編碼。 - utf-16：16 位編碼。 - utf-8：8 位編碼 預設值： utf-8

5. 在 [WCF-BasicHttpRelay 傳輸屬性 ] 對話方塊的 [ 安全性 ] 索引標籤上，定義傳送埠 WCF-BasicHttpRelay 的安全性功能。

   使用	作法
   安全性模式	指定使用的安全性類型。 有效值如下： - 無：傳輸期間不會保護訊息。 - 傳輸：使用 HTTPS 傳輸提供安全性。 使用 HTTPS 來維護 SOAP 訊息的安全。 此服務之 X.509 憑證的 CA 憑證鏈結必須安裝在這部電腦的「信任的根憑證授權單位」憑證存放區中，才可以使用此服務的憑證向傳送埠驗證此服務。 - 訊息：安全性是使用 SOAP 訊息安全性來提供。 根據預設，SOAP Body 元素會加密並簽署。 WCF-BasicHttpRelay 傳送配接器的唯一有效 訊息用戶端認證類型 是 憑證。 這種模式需要使用 HTTP 傳輸。 - TransportWithMessageCredential：HTTPS 傳輸會提供完整性、機密性和服務驗證。 此服務之 X.509 憑證的 CA 憑證鏈結必須安裝在這部電腦的「信任的根憑證授權單位」憑證存放區中，才可以使用此服務的憑證向傳送埠驗證此服務。 傳送埠驗證是由 SOAP 訊息安全性所提供。 預設值為 [無]。
   [憑證]	只有在您將上方的安全性模式設定為 Message 或TransportWithMessageCredential時，才指定訊息層級安全性選項。 有效值如下： - UserName：此傳送埠會使用 UserName 認證向端點進行驗證。 對於 WCF-BasicHttpRelay 傳送配接器，不支援此功能。 - 憑證：此傳送埠會使用透過 用戶端憑證 - 指紋 屬性指定的用戶端憑證，向端點進行驗證。 此外，使用此認證類型時，服務憑證必須透過 服務憑證 - 指紋 屬性提供。 預設值為 UserName。
   演算法套件	指定訊息加密和 Key Wrap 演算法。 這些演算法會對應到安全性原則語言 (WS-SecurityPolicy) 規格中所指定的演算法。 可能的值包括： - 基本128：使用 Aes128 加密、Sha1 用於訊息摘要，Rsa-oaep-mgf1p 用於金鑰包裝。 - Basic128Rsa15：使用 Aes128 進行訊息加密、Sha1 用於訊息摘要，Rsa15 用於金鑰換行。 - Basic128Sha256：使用 Aes256 進行訊息加密、Sha256 用於訊息摘要，Rsa-oaep-mgf1p 用於金鑰包裝。 - Basic128Sha256Rsa15：使用 Aes128 進行訊息加密、Sha256 用於訊息摘要，Rsa15 用於金鑰換行。 - Basic192：使用 Aes192 加密、Sha1 進行訊息摘要，Rsa-oaep-mgf1p 用於金鑰包裝。 - Basic192Rsa15：使用 Aes192 進行訊息加密、Sha1 用於訊息摘要，Rsa15 用於金鑰換行。 - Basic192Sha256：使用 Aes192 進行訊息加密、Sha256 用於訊息摘要，Rsa-oaep-mgf1p 用於金鑰包裝。 - Basic192Sha256Rsa15：使用 Aes192 進行訊息加密、Sha256 用於訊息摘要，Rsa15 用於金鑰包裝。 - Basic256：使用 Aes256 加密、Sha1 進行訊息摘要，Rsa-oaep-mgf1p 用於金鑰包裝。 - Basic256Rsa15：使用 Aes256 進行訊息加密、Sha1 用於訊息摘要，Rsa15 用於金鑰包裝。 - Basic256Sha256：使用 Aes256 進行訊息加密、Sha256 用於訊息摘要，Rsa-oaep-mgf1p 用於金鑰包裝。 - Basic256Sha256Rsa15：使用 Aes256 進行訊息加密、Sha256 用於訊息摘要，Rsa15 用於金鑰包裝。 - TripleDes：使用 TripleDes 加密，Sha1 用於訊息摘要，Rsa-oaep-mgf1p 用於金鑰包裝。 - TripleDesRsa15：使用 TripleDes 加密、Sha1 用於訊息摘要，Rsa15 用於金鑰包裝。 - TripleDesSha256：使用 TripleDes 進行訊息加密、Sha256 用於訊息摘要，以及 Rsa-oaep-mgf1p 用於金鑰包裝。 - TripleDesSha256Rsa15：使用 TripleDes 進行訊息加密、Sha256 用於訊息摘要，Rsa15 用於金鑰包裝。 預設值為 Basic256。
   用戶端憑證 - 指紋	指定 X.509 憑證的指紋，以驗證此傳送埠至端點。 您可以使用 [流覽] 按鈕流覽至[目前使用者位置] 中的[我的商店] 來選取指紋。 附註： 您必須針對裝載此傳送埠的傳送處理常式，將用戶端憑證安裝到使用者帳戶的 目前使用者 位置。 最小長度：00 最大長度：40 預設為空字串。
   服務憑證 - 指紋	指定 X.509 憑證的指紋，用於驗證此傳送埠傳送訊息至其中的端點。 您可以使用 [流覽] 按鈕，選取流覽至 [本機電腦] 位置的 [其他人員存放區] 指紋。 最小長度：00 最大長度：40 預設為空字串。
   使用者名稱認證	指定用來傳送訊息的認證。 您可以按一下 [ 編輯 ] 按鈕來指定 屬性。 如果您選取[訊息用戶端認證類型] 的 [使用者名稱] 選項，則必須設定認證。 預設值為 [不要使用單一登入]。
   使用 ACS 服務識別	適用于 BizTalk Server 2013 R2 和 BizTalk Server 2013。 選取此核取方塊，然後按一下 [ 編輯 ]，並提供下列值以向服務匯流排進行驗證。 - 存取控制服務 STS Uri – 將此設定為 https://<Namespace>-sb.accesscontrol.windows.net/ ，其中 < namespace > 是您的服務匯流排命名空間。 - 簽發者名稱 – 指定簽發者名稱。 此值通常設定為擁有者。 - 簽發者金鑰 – 指定簽發者金鑰。
   服務匯流排連線資訊	從 BizTalk Server 2016 開始的新功能。 選擇使用服務匯流排命名空間的共用存取簽章 (SAS) 或存取控制服務 (ACS) 。 選取選項，然後選取 [ 編輯 ] 以輸入金鑰資訊： - 共用存取簽章 ：輸入存取金鑰名稱和存取金鑰。 這兩個值都會列在Azure 入口網站中。 - 存取控制服務：輸入 STS URI () https://<yourNamespace>-sb.accesscontrol.windows.net/ 、簽發者名稱和簽發者金鑰。 使用Windows PowerShell來擷取這些值，如SB-Messaging 配接器中所述。

6. 在 [WCF-BasicHttpRelay 傳輸屬性 ] 對話方塊的 [ Proxy ] 索引標籤上，設定 WCF-BasicHttpRelay 傳送埠的 Proxy 設定。

   使用	作法
   使用傳送處理常式 Proxy 設定	指定此傳送埠是否要在裝載此傳送埠的傳送處理常式中，使用 Proxy 設定。 這是預設值。
   不使用 Proxy	指出這個傳送埠是否要使用 Proxy 伺服器。 預設值為清除核取方塊。
   使用 Proxy	指出這個傳送埠是否使用 Address 屬性中指定的 Proxy 伺服器。 預設值為清除核取方塊。
   位址	指定 Proxy 伺服器的位址。 視安全性組態而定，請使用 HTTPs 或 HTTP 配置。 這個位址後面可以加上冒號和連接埠編號， 例如： http://127.0.0.1:8080 。 只有在選取 [使用 Proxy ] 時，此屬性才需要值。 類型：字串 最大長度：256 預設為空字串。
   使用者名稱	指定要用於驗證的使用者名稱。 若使用整合式驗證，則使用者名稱會包括網域，即「網域\使用者名稱」。 若使用 [基本] 或 [摘要] 驗證，則使用者名稱不包括「網域\」。 只有在選取 [使用 Proxy ] 時，此屬性才需要值。 附註： WCF-BasicHttpRelay 傳送配接器會使用 Proxy 的基本驗證。 類型：字串 最小長度：00 最大長度：256 預設為空字串。
   密碼	指定要用於驗證的密碼。 只有在選取 [使用 Proxy ] 時，此屬性才需要值。 類型：字串 最小長度：00 最大長度：256 預設為空字串。

7. 在 [WCF-BasicHttpRelay 傳輸屬性 ] 對話方塊的 [ 訊息 ] 索引標籤上，指定 SOAP Body 元素的資料選取範圍。

   使用	作法
   本文 -- BizTalk 要求訊息本文	使用 BizTalk 訊息本文部分，為傳出訊息建立 SOAP Body 元素的內容。 這是預設值。
   範本 -- 由範本指定的內容	使用 [XML] 文字方塊中提供的範本來建立外寄訊息的 SOAP 內文 元素內容。 預設值為清除核取方塊。
   XML	輸入 XML 格式的範本，以取得傳出訊息之 SOAP ody 元素的內容。 如果選取了 [範本 -- BizTalk 回應訊息本文] 選項，就需要此屬性。 類型：字串 最小長度：00 最大長度：32767 預設為 <bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/>。
   Envelope -- 整個 < soap：Envelope>	從內送訊息的整個 SOAP 信封 建立 BizTalk 訊息內文部分。 此屬性只對請求-回應連接埠有效。 預設值為清除核取方塊。
   Body -- soap：Body > 元素的內容 <	使用內送訊息的 SOAP Body 元素內容來建立 BizTalk 訊息內文部分。 如果 Body 元素有一個以上的子元素，則只有第一個元素會成為 BizTalk 訊息內文部分。 此屬性只對請求-回應連接埠有效。 這是預設值。
   路徑 -- 內容由內文路徑定位	使用 [內文路徑運算式] 文字方塊中的內文路徑運算式，建立 BizTalk 訊息內文部分。 內文路徑運算式會依照內送訊息 SOAP Body 元素的直系子元素來進行評估。 此屬性只對請求-回應連接埠有效。 預設值為清除核取方塊。
   [內文路徑運算式]	輸入內文路徑運算式，以識別用來建立 BizTalk 訊息內文部分的內送訊息特定部分。 此本文路徑運算式會根據傳入訊息之 SOAP Body 節點的立即子項目進行評估。 如果此內文路徑運算式傳回一個以上的節點，則只會為 BizTalk 訊息內文部分選擇第一個節點。 如果選取了 [路徑 -- 內容由內文路徑定位] 選項，就需要此屬性。 此屬性只對請求-回應連接埠有效。 類型：字串 最小長度：00 最大長度：32767 預設為空字串。
   節點編碼	指定 WCF-BasicHttpRelay 傳送配接器用來解碼主體路徑運算式在 [ 本文路徑運算式 ] 文字方塊中所識別之節點的編碼類型。 如果選取了 [路徑 -- 內容由內文路徑定位] 選項，就需要此屬性。 此屬性只對請求-回應連接埠有效。 有效值如下： - Base64：Base64編碼。 - 十六進位：十六進位編碼。 - 字串：文字編碼 - UTF-8 - XML：WCF 配接器會在 [ 本文路徑運算式 ] 文字方塊中，使用主體路徑運算式所選取節點的外部 XML 來建立 BizTalk 訊息本文。 預設值為 XML。
   傳播錯誤訊息	選取此核取方塊可將輸出處理失敗的訊息路由至訂閱應用程式 (例如另一個接收埠或協調流程排程)。 清除核取方塊以擱置失敗的訊息，並產生負值通知 (NACK)。 此屬性只對請求-回應連接埠有效。 預設值為選取核取方塊。

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

將 Proxy 新增至傳送處理常式

您可以將 Proxy 新增至傳送埠或傳送處理常式。 如果您要在傳送埠新增 Proxy，請略過本節。

1. 在 BizTalk Server 管理主控台中，依序展開 [BizTalk Server系統管理]、[BizTalk 群組]、[平臺設定] 和 [配接器]。

2. 選取 [WCF-BasicHttpRelay]，然後選取傳送處理常式。

3. 在 [配接器處理常式屬性] 的 [ 一般 ] 索引標籤上，選取 [ 屬性]。

4. 在 [ Proxy] 索引 標籤中，執行下列動作。

   使用	作法
   使用 Proxy	指出這個傳送處理常式是否使用 Proxy 伺服器。 預設值為清除核取方塊。
   位址	指定 Proxy 伺服器的位址。 視安全性組態而定，請使用 HTTPs 或 HTTP 配置。 這個位址後面可以加上冒號和連接埠編號， 例如： http://127.0.0.1:8080 。 只有在選取 [使用 Proxy ] 時，此屬性才需要值。 類型：字串 最大長度：256 預設為空字串。
   使用者名稱	指定要用於驗證的使用者名稱。 若使用整合式或基本驗證，則使用者名稱也包括網域，即「網域\使用者名稱」。 若使用摘要式驗證，則使用者名稱不包括「domain\」。 只有在選取 [使用 Proxy ] 時，此屬性才需要值。 類型：字串 最小長度：00 最大長度：256 預設為空字串。
   密碼	指定要用於驗證的密碼。 只有在選取 [使用 Proxy ] 時，此屬性才需要值。 類型：字串 最小長度：00 最大長度：256 預設為空字串。

5. 按一下 [確定 ]，直到您結束所有對話方塊為止。

另請參閱

SB-Messaging 配接器

使用配接器