Поделиться через

<httpTransport>

  • Статья

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

Иерархия схемы

<system.serviceModel>
  <bindings>
    <customBinding>
      <binding>
        <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"
IntegratedWindowsAuthentication: Specifies Windows authentication"
    realm="String"
    transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
        unsafeConnectionNtlmAuthentication="Boolean"
        useDefaultWebProxy="Boolean" />

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

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

Атрибуты

Атрибут Описание

allowCookies

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

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

authenticationScheme

Задает протокол, используемый для проверки подлинности клиентских запросов, обрабатываемых прослушивателем HTTP. Допустимы следующие значения:

  • Digest: задает дайджест-проверку подлинности.

  • Negotiate: проводит согласование с клиентом для определения схемы проверки подлинности. Если и клиент, и сервер поддерживают Kerberos, используется именно этот протокол; в противном случае используется NTLM.

  • Ntlm: задает проверку подлинности NTLM.

  • Basic: задает обычную проверку подлинности.

  • Anonymous: задает анонимную проверку подлинности.

Значение по умолчанию — Anonymous. Это атрибут типа AuthenticationSchemes. Этот атрибут может быть задан лишь один раз.

bypassProxyOnLocal

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

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

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

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

hostnameComparisonMode

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

  • StrongWildcard: (+) соответствует всем возможным именам узлов в контексте заданной схемы, порта и относительного универсального кода ресурса (URI).

  • Exact: подстановочные знаки отсутствуют

  • WeakWildcard: (*) соответствует всем возможным именам узлов в контексте заданной схемы, порта и относительного универсального кода ресурса (URI), которые не соответствовали явным образом или посредством строгого механизма подстановочных знаков.

Значение по умолчанию — StrongWildcard. Это атрибут типа HostnameComparisonMode.

keepAliveEnabled

Логическое значение, указывающее, следует ли устанавливать постоянное подключение к интернет-ресурсу.

maxBufferSize

Положительное целое число, указывающее максимальный размер буфера. Значение по умолчанию — 524 288

proxyAddress

Универсальный код ресурса (URI), задающий адрес прокси-сервера HTTP. Если параметр useSystemWebProxy имеет значение true, данный параметр должен иметь значение null. Значение по умолчанию — null.

proxyAuthenticationScheme

Задает протокол, используемый для проверки подлинности клиентских запросов, обрабатываемых прокси-сервером HTTP. Допустимы следующие значения:

  • None: проверка подлинности не выполняется.

  • Digest: задает дайджест-проверку подлинности.

  • Negotiate: проводит согласование с клиентом для определения схемы проверки подлинности. Если и клиент, и сервер поддерживают Kerberos, используется именно этот протокол; в противном случае используется NTLM.

  • Ntlm: задает проверку подлинности NTLM.

  • Basic: задает обычную проверку подлинности.

  • Anonymous: задает анонимную проверку подлинности.

  • IntegratedWindowsAuthentication: задает проверку подлинности Windows.

Значение по умолчанию — Anonymous. Это атрибут типа AuthenticationSchemes.

realm

Строка, задающая область для использования на прокси-сервере. Значение по умолчанию — пустая строка.

Серверы используют области для разделения защищенных ресурсов. Каждый раздел может иметь свою собственную схему проверки подлинности и/или базу данных авторизации. Области используются только для обычной проверки подлинности и дайджест-проверки подлинности. После успешного прохождения клиентом проверки подлинности ее результаты действительны для всех ресурсов в данной области. Подробное описание областей см. в документе RFC 2617 по адресу http://www.ietf.org.

transferMode

Указывает, следует ли буферизировать сообщения или передавать их потоком по запросу или ответу. Допустимы следующие значения:

  • Buffered: сообщения запроса и ответа буферизируются.

  • Streamed: сообщения запроса и ответа передаются потоком.

  • StreamedRequest: сообщение запроса передается потоком, а сообщение ответа буферизируется.

  • StreamedResponse: сообщение запроса буферизируется, а сообщение ответа передается потоком.

Значение по умолчанию — Buffered. Это атрибут типа TransferMode.

unsafeConnectionNtlmAuthentication

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

useDefaultWebProxy

Логическое значение, указывающее, используются ли настройки прокси-сервера компьютера или пользователя. Значение по умолчанию — true.

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

Нет.

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

Элемент Описание

<binding>

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

Замечания

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

См. также

Справочник

<customBinding>
HttpTransportElement
HttpTransportBindingElement
TransportBindingElement
CustomBinding

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

Transports in Windows Communication Foundation
Choosing a Transport
Windows Communication Foundation Bindings
Extending Bindings
Custom Bindings