Создание конфигураций транспортных протоколов Microsoft .NET

Конфигурацию транспортного протокола Microsoft .NET можно создать вручную, описав тем самым параметры запросов служб на основе протокола Windows Communication Foundation (WCF).

Прежде чем начать

В случае применения защиты SOAP убедитесь, что в среде настроены правильные библиотеки и файлы конфигурации.

В системе должны быть установлены сертификаты и библиотеки, необходимые для прокси-сервера клиента Microsoft, включая библиотеки Microsoft .NET.

Измененная версия файла конфигурации прокси-сервера клиента Microsoft службы WCF (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

Для тестирования приложения WCF с помощью универсального клиента служб в IBM Appscan добавьте следующий код в файл конфигурации 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 ожидает только запросы HTTP в WCF. Поддерживаются следующие привязки HTTP:

BasicHttpBinding
Custombinding на основе httpTransport
WsHttpBinding
WsFederationHttpBinding
WS2007FederationHttpBinding

Кроме того, поддерживаются следующие шаблоны:

Значение Действие ( обязательно )
Значение Ответное действие ( обязательно )
Уровень защиты

Процедура

Создайте измененный файл soaclient.exe.config. Для этого выполните следующие действия:
1. Создайте копию файла client.exe.config (или имя-клиента.config) из проекта Microsoft .NET, присвоив ему имя 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 с целью автоматического создания конфигурации транспортного протокола Microsoft .NET на основе данных из файла WSDL. Дополнительная информация приведена в разделе Отправка запросов служб с помощью файлов WSDL.
Щелкните на значке Общий клиент служб () на панели инструментов, чтобы открыть общий клиент служб, и перейдите на вкладку Транспортный протокол.
На странице Конфигурации транспортных протоколов выберите Создать конфигурацию Microsoft .NET.
Введите имя новой конфигурации транспортного протокола и укажите следующие параметры:
Расположение soaclient.exe.config

Укажите расположение файла soaclient.exe.config. Это файл необходимо создать вручную; для этого скопируйте и отредактируйте файл client.exe.config из службы Microsoft .NET.

Идентификация пользователя

Если служба применяет идентификацию, выберите Идентификация пользователя и введите идентификационные данные пользователя, необходимые для обращения к службе.

Защита конечной точки
По умолчанию в конфигурации транспортного протокола используется уровень защиты конечной точки, указанный в файле soaclient.exe.config. Этот параметр позволяет указать другой уровень защиты:
- Подпись : Позволяет разрешить добавление цифровых подписей в запросы.
- Подпись и шифрование: Позволяет включить цифровые подписи и шифрование для запросов.
Дополнительные свойства

В этой таблице указываются действия запросов и ответов в порядке, в котором указаны методы в файле WSDL. Нажмите кнопку Добавить, чтобы указать имя и значение требуемых для службы действий запроса и ответа. Эта таблица создается автоматически во время импорта файла WSDL Microsoft .NET.
Нажмите кнопку OK, чтобы создать конфигурацию транспортного протокола.

Дальнейшие действия

Созданную конфигурацию можно использовать в вызовах служб с помощью транспортного протокола Microsoft .NET. В списке Конфигурации в общем клиенте служб можно внести изменения в существующие конфигурации или дублировать их.

Комментарии