Tworzenie konfiguracji transportu Microsoft .NET

Możliwe jest ręczne utworzenie konfiguracji transportu Microsoft.net w celu opisania ustawień transportu dla żądań usług, które używają protokołu Windows Communication Foundation (WCF).

Zanim rozpoczniesz

Jeśli są używane zabezpieczenia SOAP, należy skonfigurować środowisko z użyciem poprawnych bibliotek i plików konfiguracyjnych.

Na komputerze należy zainstalować certyfikaty i biblioteki wymagane przez proxy klienta Microsoft, w tym biblioteki platformy Microsoft .NET.

Należy powiązać zmodyfikowaną wersję pliku konfiguracyjnego proxy klienta Microsoft usługi WCF (domyślnie jest to plik client.exe.config) z konfiguracją transportu Microsoft .NET. W tym celu trzeba zmienić nazwę pliku na soaclient.exe.config i przeprowadzić jego edycję, tak jak to opisano w poniższej procedurze.

Wskazówka: Konfigurację transportu Microsoft .NET można utworzyć automatycznie, importując plik WSDL platformy Microsoft .NET. W tym przypadku należy ręcznie zmienić konfigurację transportu Microsoft.net w taki sposób, aby wskazywała zmodyfikowany plik soaclient.exe.config (tak jak to opisano w poniższej procedurze). Więcej informacji można znaleźć w sekcji Wysyłanie żądań usług przy użyciu plików WSDL.

O tym zadaniu

Produkt obsługuje testowanie usług WCF, które używają następujących powiązań:

BasicHttpBinding
WsHttpBinding
NetMsMqBinding, tylko dla połączeń jednokierunkowych
WSFederationHttpBinding
WS2007FederationHttpBinding
NetTcpBinding
Powiązania niestandardowe, które nie integrują niestandardowych rozszerzeń w kanale, przekształcania komunikatów do postaci szeregowej, transportu i zabezpieczeń

Uwaga: Następujące usługi WCF nie są obsługiwane:

Transakcja i zasięgi
Żądania w trybie dupleks, takie jak wywołania zwrotne i usługi dwukierunkowe oparte na transporcie Microsoft Message Queuing (MS-MQ)

Tylko dla użytkowników produktu IBM AppScan

Aby można było używać programu Generic Service Client z produktem IBM Appscan do testowania aplikacji WCF, należy dodać do pliku konfiguracyjnego aplikacji WCF następujący kod:

<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 oczekuje tylko żądań HTTP w usłudze WCF. Obsługiwane są następujące powiązania HTTP:

BasicHttpBinding
Custombinding powyżej standardu httpTransport
WsHttpBinding
WsFederationHttpBinding
WS2007FederationHttpBinding

Ponadto obsługiwane są następujące wzorce:

Wartość działania (obowiązkowa)
Wartość działania Odpowiedź (obowiązkowa)
Poziom zabezpieczenia

Procedura

Utwórz zmodyfikowany plik soaclient.exe.config, wykonując następujące kroki:
1. Utwórz kopię pliku client.exe.config (lub nazwa_klienta_proxy.config) z projektu Microsoft .NET i zmień nazwę kopii na soaclient.exe.config.
2. Zmodyfikuj plik soaclient.exe.config zgodnie z informacjami podanymi w poniższym wierszu), aby była używana wersja transportu Microsoft .NET, która jest obsługiwana przez produkt:
```
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.0"/>
```
3. Zmodyfikuj plik soaclient.exe.config zgodnie z informacjami podanymi w poniższym wierszu, aby punkty końcowe w pliku konfiguracyjnym wskazywały na kontrakt klienta produktu:
```
contract="IBM.ServiceModel.Soa.Extension.Stub.IStubTest"
```
4. Zaimportuj zmodyfikowany plik soaclient.exe.config do obszaru roboczego.
Po utworzeniu pliku soaclient.exe.config można pominąć następujące kroki i zaimportować plik WSDL, aby automatycznie utworzyć konfigurację transportu Microsoft.NET na podstawie informacji udostępnionych w pliku WSDL. Więcej informacji na ten temat zawiera sekcja Wysyłanie żądań usług przy użyciu plików WSDL.
Kliknij przycisk paska narzędzi Ogólny klient usług (), aby otworzyć ogólny klient usług, a następnie kliknij kartę Transport.
Na stronie Konfiguracje transportu kliknij opcję Utwórz konfigurację Microsoft .NET.
Wpisz nazwę nowej konfiguracji transportu i podaj następujące opcje:
Położenie pliku soaclient.exe.config

Należy podać położenie pliku soaclient.exe.config. Ten plik należy utworzyć ręcznie, kopiując i modyfikując plik client.exe.config usługi Microsoft .NET.

Uwierzytelnianie użytkownika

Jeśli usługa wymaga uwierzytelniania, należy zaznaczyć pole wyboru Uwierzytelnianie użytkownika oraz wpisać nazwę użytkownika i hasło służące do uzyskiwania dostępu do usługi.

Zabezpieczenie punktu końcowego
Domyślnie w konfiguracji transportu jest używane zabezpieczenie na poziomie punktu końcowego (zgodnie z opisem podanym w pliku soaclient.exe.config. To ustawienie umożliwia wybranie innej opcji w polu Poziom zabezpieczenia:
- Podpis: należy wybrać tę opcję, aby żądania podpisywać cyfrowo.
- Podpis i szyfrowanie: należy wybrać tę opcję, aby żądania podpisywać cyfrowo i szyfrować.
Właściwości zaawansowane

Ta tabela zawiera listę działań związanych z żądaniem i odpowiedzią w kolejności zgodnej z kolejnością metod w pliku WSDL. Należy kliknąć przycisk Dodaj, aby podać nazwę i wartość działań żądania i odpowiedzi, które są wymagane przez tę usługę. Ta tabela jest generowana automatycznie po zaimportowaniu pliku WSDL środowiska Microsoft .NET.
Kliknij przycisk OK, aby utworzyć konfigurację transportu.

Co dalej

Po utworzeniu konfiguracji można jej używać z dowolnym wywołaniem usługi, które używa protokołu transportu Microsoft .NET. Za pomocą listy Konfiguracje w ogólnym kliencie usług można edytować istniejące konfiguracje lub tworzyć zduplikowane konfiguracje.

Opinia