Vytvoření konfigurací přenosu Microsoft .NET

Konfiguraci přenosu Microsoft .NET, která bude popisovat nastavení přenosu pro požadavky na službu používající protokol Windows Communication Foundation (WCF), můžete nastavit ručně.

Než začnete

Pokud používáte zabezpečení SOAP, ujistěte se, že prostředí má nakonfigurované správné knihovny a konfigurační soubory.

Certifikáty a knihovny požadované serverem proxy klienta Microsoft musí být nainstalované na počítači, a to včetně knihoven Microsoft .NET.

Musíte propojit upravenou verzi konfiguračního souboru serveru proxy klienta Microsoft služby WCF (standardně soubor client.exe.config) s konfigurací přenosu Microsoft .NET. Soubor musíte přejmenovat na soaclient.exe.config a upravit ho dle instrukcí v následující proceduře.

Tip: Konfiguraci přenosu Microsoft .NET můžete vytvořit automaticky importem souboru WSDL přenosu Microsoft .NET. I v tomto případě musíte ručně upravit konfiguraci přenosu Microsoft .NET tak, aby ukazovala na upravený soubor soaclient.exe.config, jak popisuje následující procedura. Další informace viz Odeslání požadavků na službu pomocí souborů WSDL

Informace o této úloze

Produkt podporuje testovací služby WCF, které používají tyto vazby:
Poznámka: Nepodporují se tyto služby WCF:
  • Transakce a rozsahy.
  • Požadavky duplexního režimu, jako např. zpětná volání nebo obousměrné služby vycházející z přenosu Microsoft Message Queuing (MS-MQ).
Chcete-li používat generického klienta služby s produktem IBM Appscan k testování aplikace WCF, přidejte následující kód do konfiguračního souboru 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>
Produkt IBM Appscan očekává pouze požadavky HTTP v WCF. Podporovány jsou následující vazby HTTP:
  • BasicHttpBinding.
  • Custombinding above standard httpTransport.
  • WsHttpBinding.
  • WsFederationHttpBinding.
  • WS2007FederationHttpBinding.
Podporovány jsou rovněž následující vzory:
  • Hodnota akce (povinné).
  • Hodnota akce Odpovědět (povinné).
  • Úroveň ochrany.

Postup

  1. Vytvořte upravený soubor soaclient.exe.config takto:
    1. Vytvořte kopii souboru client.exe.config (nebo název_serveru_proxy_klienta.config) z projektu Microsoft .NET a přejmenujte tuto kopii na soaclient.exe.config.
    2. Upravte soubor soaclient.exe.config tak, aby používal verzi Microsoft .NET podporovanou produktem, jak uvádí následující řádek:
      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/>
    3. Upravte soubor soaclient.exe.config tak, aby koncové body z konfiguračního souboru ukazovaly na klientskou smlouvu produktu, jak uvádí následující řádek:
      contract="IBM.ServiceModel.Soa.Extension.Stub.IStubTest"
    4. Naimportujte upravený soubor soaclient.exe.config do pracovního prostoru.
    Po vytvoření souboru soaclient.exe.config můžete následující kroky přeskočit a naimportovat soubor WSDL, a automaticky tak vytvořit konfiguraci přenosu Microsoft .NET na základě informací poskytnutých WSDL. Další informace viz Odeslání požadavků na službu pomocí souborů WSDL.
  2. Klepněte na tlačítko panelu nástrojů Generický klient služby (Otevřít generického klienta služby), otevřete generického klienta služby a klepněte na kartu Přenos.
  3. Na stránce Konfigurace přenosu klepněte na volbu Vytvořit konfiguraci Microsoft .NET.
  4. Zadejte název nové konfigurace přenosu a tyto volby:
    Umístění souboru soaclient.exe.config
    Zadejte umístění souboru soaclient.exe.config. Tento soubor musíte vytvořit ručně zkopírováním a úpravou souboru client.exe.config ze služby Microsoft .NET.
    Ověření uživatele
    Pokud služba vyžaduje ověření, vyberte volbu Ověření uživatele a zadejte jméno uživatele a heslo pro přístup ke službě.
    Ochrana koncového bodu
    Ve výchozím nastavení se při konfiguraci přenosu uplatňuje úroveň ochrany koncového bodu dle popisu v souboru soaclient.exe.config. Pomocí tohoto nastavení zadejte jinou Úroveň ochrany:
    • Podpis: Tuto volbu vyberte, chcete-li digitálně podepisovat požadavky.
    • Šifrování a podpis: Tuto volbu vyberte, chcete-li digitálně podepisovat a šifrovat požadavky.
    Rozšířené vlastnosti
    Do této tabulky uveďte žádosti a odezvy na akce v pořadí metod v souboru WSDL. Klepnutím na volbu Přidat určíte název a hodnotu akcí žádosti a odezvy, které jsou vyžadované službou. Tato tabulka se generuje automaticky při importu souboru WSDL produktu Microsoft .NET.
  5. Klepnutím na tlačítko OK vytvořte novou konfiguraci přenosu.

Jak pokračovat dále

Po vytvoření konfigurace jí můžete používat v libovolném volání služby, které používá přenosový protokol Microsoft .NET. Pomocí seznamu Konfigurace v generickém klientu služby můžete upravit existující konfigurace nebo vytvořit duplicitní konfigurace.

Váš názor