<httpTransport>

  • Статья

Задает транспорт HTTP для передачи сообщений протокола SOAP для пользовательской привязки.

<Конфигурации>
  <system.serviceModel>
    <Привязки>
      <Custombinding>
        <Привязки>
          <httpTransport>

Синтаксис

<httpTransport allowCookies="Boolean"
               authenticationScheme="Digest/Negotiate/Ntlm/Basic/Anonymous"
               bypassProxyOnLocal="Boolean"
               hostnameComparisonMode="StrongWildcard/Exact/WeakWildcard"
               keepAliveEnabled="Boolean"
               maxBufferSize="Integer"
               proxyAddress="Uri"
               proxyAuthenticationScheme="None/Digest/Negotiate/Ntlm/Basic/Anonymous"
               realm="String"
               transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
               unsafeConnectionNtlmAuthentication="Boolean"
               useDefaultWebProxy="Boolean" />

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут Описание
allowCookies Логическое значение, указывающее, принимает ли клиент файлы cookie и распространяет ли он их на будущие запросы. Значение по умолчанию — false.

Этот атрибут можно использовать при взаимодействии с веб-службами ASMX, которые используют файлы Cookie. В этом случае можно быть уверенным, что файлы cookie, возвращаемые с сервера, автоматически копируются во все последующие клиентские запросы к этой службе.
authenticationScheme Задает протокол, используемый для проверки подлинности клиентских запросов, обрабатываемых прослушивателем HTTP. Допустимые значения.

— Дайджест: указывает дайджест-проверку подлинности.
— Согласование: согласовывает с клиентом схему проверки подлинности. Если и клиент, и сервер поддерживают Kerberos, используется именно этот протокол; в противном случае используется NTLM.
— Ntlm: указывает проверку подлинности NTLM.
— Базовый: указывает обычную проверку подлинности.
— Анонимный: указывает анонимную проверку подлинности.

Значение по умолчанию - Anonymous. Это атрибут типа AuthenticationSchemes. Этот атрибут может быть задан лишь один раз.
bypassProxyOnLocal Логическое значение, определяющее, будет ли выполняться обход прокси-сервера для локальных адресов. Значение по умолчанию — false.

Локальный адрес — это адрес, находящийся в локальной сети или в интрасети.

Windows Communication Foundation (WCF) всегда игнорирует прокси-сервер, если адрес службы начинается с http://localhost.

Следует использовать имя узла (а не localhost), если необходимо, чтобы клиенты проходили через прокси при взаимодействии со службами на том же компьютере.
hostnameComparisonMode Задает режим сравнения имен узлов HTTP для анализа универсальных кодов ресурсов (URI). Допустимы следующие значения:

— StrongWildcard: ("+") соответствует всем возможным именам узлов в контексте указанной схемы, порта и относительного URI.
— Точно: подстановочные знаки отсутствуют.
- WeakWildcard: ("*") соответствует всем возможным именам узлов в контексте указанной схемы, порта и относительного UIR, которые не были сопоставлены явным образом или с помощью механизма строгих подстановочных знаков.

Это атрибут типа HostNameComparisonMode. Значение по умолчанию — StrongWildcard.
keepAliveEnabled Логическое значение, указывающее, следует ли устанавливать постоянное подключение к интернет-ресурсу.
maxBufferSize Положительное целое число, указывающее максимальный размер буфера. Значение по умолчанию - 524 288
proxyAddress Универсальный код ресурса (URI), задающий адрес прокси-сервера HTTP. Если параметр useSystemWebProxy имеет значение true, данный параметр должен иметь значение null. Значение по умолчанию — null.
proxyAuthenticationScheme Задает протокол, используемый для проверки подлинности клиентских запросов, обрабатываемых прокси-сервером HTTP. Допустимые значения.

— Нет: проверка подлинности не выполняется.
— Дайджест: указывает дайджест-проверку подлинности.
— Согласование: согласовывает с клиентом схему проверки подлинности. Если и клиент, и сервер поддерживают Kerberos, используется именно этот протокол; в противном случае используется NTLM.
— Ntlm: указывает проверку подлинности NTLM.
— Базовый: указывает обычную проверку подлинности.
— Анонимный: указывает анонимную проверку подлинности.

Значение по умолчанию - Anonymous. Это атрибут типа AuthenticationSchemes. Обратите внимание, что AuthenticationSchemes.IntegratedWindowsAuthentication не поддерживается.
realm Строка, задающая область для использования на прокси-сервере. Значением по умолчанию является пустая строка.

Серверы используют области для разделения защищенных ресурсов. Каждый раздел может иметь свою собственную схему проверки подлинности и/или базу данных авторизации. Области используются только для обычной проверки подлинности и дайджест-проверки подлинности. После успешного прохождения клиентом проверки подлинности ее результаты действительны для всех ресурсов в данной области. Подробное описание областей см. в документе RFC 2617 на веб-сайте IETF.
transferMode Указывает, следует ли буферизировать сообщения или передавать их потоком по запросу или ответу. Допустимые значения.

— Буферизация: сообщения запросов и ответов помещаются в буфер.
— Потоковая передача: сообщения запросов и ответов передаются в потоковую передачу.
— StreamedRequest: сообщение запроса передается в поток, а ответное сообщение помещается в буфер.
— StreamedResponse: сообщение запроса помещается в буфер, а ответное сообщение передается в потоковую передачу.

Значение по умолчанию - Buffered. Это атрибут типа TransferMode.
unsafeConnectionNtlmAuthentication Логическое значение, указывающее, разрешено ли на сервере совместное использование небезопасных подключений. Значение по умолчанию — false. Если оно разрешено, проверка подлинности NTLM выполняется один раз для каждого подключения по протоколу TCP.
useDefaultWebProxy Логическое значение, указывающее, используются ли настройки прокси-сервера компьютера или пользователя. Значение по умолчанию — true.

Дочерние элементы

Нет

Родительские элементы

Элемент Описание
<Привязки> Определяет все возможности пользовательской привязки.

Комментарии

Элемент httpTransport является начальной точкой для создания пользовательской привязки, реализующей транспортный протокол HTTP. Протокол HTTP является основным транспортом, используемым в целях взаимодействия. Этот транспорт поддерживается Windows Communication Foundation (WCF) для обеспечения взаимодействия с другими стеками веб-служб, не относящихся к WCF.

См. также раздел