建立 Microsoft .NET 傳輸配置

您可以手動建立 Microsoft .NET 傳輸配置，來說明使用 Windows Communication Foundation (WCF) 通訊協定之服務要求的傳輸設定。

開始之前

如果您使用 SOAP 安全，請確定您已為環境配置正確的程式庫和配置檔。

Microsoft 用戶端 Proxy 所需的憑證和程式庫（包括 Microsoft .NET 程式庫），必須安裝在電腦上。

您必須將 WCF 服務之 Microsoft 用戶端 Proxy 配置檔的已修改版本（依預設是 client.exe.config），鏈結至 Microsoft .NET 傳輸配置。您必須將檔案重新命名為 soaclient.exe.config，並按照下列程序的說明來編輯它。

提示：您可以匯入 Microsoft .NET WSDL 檔，來自動建立 Microsoft .NET 傳輸配置。在此情況下，您仍然必須按照下列程序的說明，手動編輯 Microsoft .NET 傳輸配置，使其指向修改後的 soaclient.exe.config 檔。如需相關資訊，請參閱傳送使用 WSDL 檔的服務要求

關於這項作業

產品支援測試使用下列連結的 WCF 服務：

BasicHttpBinding
WsHttpBinding
NetMsMqBinding（僅適用於單向呼叫）
WSFederationHttpBinding
WS2007FederationHttpBinding
NetTcpBinding
自訂的連結，沒有整合通道、訊息序列化、傳輸和安全中的自訂延伸

註：不支援下列的 WCF 服務：

交易和範圍
雙工模式要求，例如：以 Microsoft Message Queuing (MS-MQ) 傳輸為基礎的回呼或雙向服務

僅針對 IBM AppScan 使用者

如果要將「通用服務用戶端」與 IBM Appscan 一起用來測試 WCF 應用程式，請將下列程式碼新增至 WCF 配置檔：

<system.diagnostics>    <trace autoflush="true" />   
      <sources>      <source name="System.Net"
      maxdatasize="1048576"><listeners><add
    name="System.Net"/></listeners></source>      <source
      name="System.Net.Cache"><listeners><add
      name="System.Net"/></listeners></source>      <source
      name="System.Net.Http"><listeners><add name="System.Net
      "/></listeners></source>      <source
      name="System.Net.Sockets"><listeners><add
      name="System.Net"/></listeners></source>      <source
      name="System.Net.WebSockets"><listeners><add
      name="System.Net"/></listeners></source>    </sources>   
      <sharedListeners>      <add
    name="System.Net"          
      type="IBM.ServiceModel.Soa.Extension.tools.TrafficTraceListener,
      Soa-Behavior-Library"          
    initializeData=""       />   
    </sharedListeners>    <switches>      <add name="System.Net"
      value="All"/>      <add name="System.Net.Cache"
    value="All"/>      <add name="System.Net.Http"
    value="All"/>      <add name="System.Net.Sockets"
    value="All"/>      <add name="System.Net.WebSockets"
    value="All"/>    </switches></system.diagnostics>

IBM Appscan 在 WCF 中只接受 HTTP 要求。支援下列 HTTP 連結：

BasicHttpBinding
標準 httpTransport 以外的 Custombinding
WsHttpBinding
WsFederationHttpBinding
WS2007FederationHttpBinding

另外也支援下列型樣：

動作值（必要）
回覆動作值（必要）
保護等級

程序

完成下列步驟，來建立經過修改的 soaclient.exe.config 檔：
1. 從 Microsoft .NET 專案建立 client.exe.config（或 proxy_client_name.config）檔的副本，並將副本重新命名為 soaclient.exe.config。
2. 依照下列字行的指定，編輯 soaclient.exe.config 檔，以便使用產品支援的 Microsoft .NET 版本：
```
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/>
```
3. 依照下列字行的指定，編輯 soaclient.exe.config 檔，讓配置檔中的端點指向產品的用戶端合約：
```
contract="IBM.ServiceModel.Soa.Extension.Stub.IStubTest"
```
4. 將修改後的 soaclient.exe.config 檔匯入至工作區。
建立 soaclient.exe.config 檔之後，您可以跳過下列步驟，並匯入 WSDL 檔，以根據 WSDL 提供的資訊，自動建立 Microsoft .NET 傳輸配置。如需相關資訊，請參閱傳送使用 WSDL 檔的服務要求。
按一下通用服務用戶端工具列按鈕 ()，來開啟通用服務用戶端，然後按一下傳輸標籤。
在「傳輸配置」頁面上，按一下建立 Microsoft .NET 配置。
輸入新傳輸配置的名稱，並且指定下列選項：
soaclient.exe.config 的位置

指定 soaclient.exe.config 檔的位置。您必須複製及編輯 Microsoft .NET 服務中的 client.exe.config 檔，以手動建立這個檔案。

使用者鑑別

如果服務需要鑑別，請選取使用者鑑別，再輸入使用者名稱和密碼，以存取服務。

端點保護
依預設，傳輸配置會使用 soaclient.exe.config 檔中所說明的端點保護等級。請利用這項設定來指定不同的保護等級：
- 簽章：選取這個選項時，會以數位方式來簽署要求。
- 加密和簽章：選取這個選項時，會以數位方式簽署及加密要求。
進階內容

利用這個表格，可按照 WSDL 檔中的方法順序，來列出要求和回應動作。請按一下新增，來指定服務所需之要求和回應動作的名稱和值。當您匯入 Microsoft .NET WSDL 檔時，會自動產生此表格。
按一下確定，以建立傳輸配置。

下一步

建立配置之後，該配置就可以與使用 Microsoft .NET 傳輸通訊協定的任何服務呼叫搭配使用。您可以利用通用服務用戶端中的配置清單，來編輯現有的配置，或是建立重複的配置。

意見