Параметры конфигурации для XML-веб-служб, созданных с помощью ASP.NET

Этот раздел посвящен технологии прежних версий. Веб-службы XML и клиенты веб-служб XML должны создаваться с использованием Windows Communication Foundation.

Конфигурация веб-служб следует модели, используемой всеми веб-приложениями ASP.NET. Конфигурация ASP.NET представляет собой текстовый файл описания архитектуры конфигурации на основе XML, обеспечивающий широкие возможности и расширяемость. Файл конфигурации — это просто набор элементов XML, представляющих параметры конфигурации для конкретных технических функций платформы Microsoft .NET Framework. В случае веб-служб параметры конфигурации содержатся в элементе XML webServices файла конфигурации. Полный список параметров конфигурации, доступных для веб-служб, см. в разделе Элемент <webServices>.

Настройка протоколов обмена сообщениями и страницы справки службы

Протоколы обмена сообщениями и страница справки службы для веб-служб настраиваются в элементе XML Элемент <protocols> элемента Элемент <webServices> файлов конфигурации. Настройка конфигурации выполняется путем добавления элементов Элемент <add> для элемента <protocols> и Элемент <remove> для элемента <protocols> для каждого параметра, которые задают, доступен ли параметр в рамках файла конфигурации. Элемент add явно добавляет поддержку соответствующего параметра в рамках файла конфигурации, а элемент remove удаляет поддержку, добавленную выше по иерархии конфигурации. Например, параметр протокола может быть добавлен на уровне компьютера с помощью элемента add в файле Machine.config, а затем удален для веб-приложения в элементе remove в файле Web.config. Ниже приведен синтаксис элементов add и remove:

<{add|remove} name="protocol name" />

Атрибут name элементов add и remove может принимать следующие значения:

Параметр	Описание
HttpSoap	Управляет поддержкой протокола SOAP через HTTP для веб-служб. Установка добавляет поддержку по умолчанию.
HttpGet	Управляет поддержкой протокола HTTP-GET для веб-служб. Установка не добавляет поддержку по умолчанию.
HttpPost	Управляет поддержкой протокола HTTP-POST для веб-служб независимо от источника запроса. Установка не добавляет поддержку по умолчанию.
HttpPostLocalhost	Управляет поддержкой протокола HTTP-POST для веб-служб, когда запрос исходит от локального компьютера. Если в текущую конфигурацию добавлен протокол HttpPost, этот параметр не оказывает никакого влияния. Установка добавляет поддержку по умолчанию.
Documentation	Задает, отображается ли страница справки службы, когда пользователь переходит на URL-адрес веб-службы без указания каких-либо параметров в браузере. Установка добавляет поддержку по умолчанию. Настройка протокола Documentation рассматривается далее в этом разделе.

Примечание
Платформа .NET Framework версии 1.0 поддерживает параметры HttpSoap, HttpGet, HttpPost и Documentation, и все они по умолчанию включены на уровне компьютера.

Настройка протокола Documentation

Переход на URL-адрес веб-службы без указания каких-либо параметров в веб-браузере позволяет клиенту просмотреть страницу справки веб-службы, если в этой службе задана такая настройка. По умолчанию страница справки веб-службы содержит пригодную для восприятия человеком информацию о порядке взаимодействия с веб-службой и о методах, предоставляемых этой веб-службой.

Так как страница справки службы является просто веб-формой ASP.NET, ее можно заменить или изменить, добавив такие элементы, как логотип компании. Имя файла для страницы справки службы указывается в элементе Элемент <wsdlHelpGenerator> файла конфигурации со значением по умолчанию DefaultWsdlHelpGenerator.aspx, заданным в файле Machine.config.

Страница справки службы отображается для веб-служб только в области действия файла конфигурации, в котором протокол Documentation задан в элементе Элемент <protocols>. По умолчанию протокол Documentation задан в файле Machine.config. См. раздел "Практическое руководство. Отключение страницы справки службы для веб-службы".

Безопасность

Перед включением протокола HTTP-GET или HTTP-POST для веб-службы необходимо помнить, что это может сделать ее доступной для непреднамеренного вызова. Например, ничего не подозревающий пользователь может получить письмо со ссылкой, при выборе которой веб-служба запускается от имени этого пользователя с параметрами, указанными в письме. Перед включением протокола HTTP-GET или HTTP-POST необходимо проверить, не могут ли такие вызовы причинить вред.

См. также

Задачи

Как отключить поддержку протоколов для веб-служб
Как отключить страницы справки службы для веб-службы
Как включить обнаружение XML-веб-служб

Основные понятия

Развертывание XML-веб-служб

Другие ресурсы

Построение XML-веб-служб с помощью ASP.NET