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

<httpsTransport>

  • Статья

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

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

<system.serviceModel>
  <bindings>
    <customBinding>
      <binding>
        <httpsTransport>

Синтаксис

<httpsTransport
    allowCookies=Boolean"
    authenticationScheme="Digest/Negotiate/Ntlm/Basic/Anonymous"
    bypassProxyOnLocal=Boolean"
    hostnameComparisonMode="StrongWildcard/Exact/WeakWildcard"
    manualAddressing="Boolean"
    maxBufferPoolSize="Integer"
    maxBufferSize="Integer"
    maxReceivedMessageSize="Integer"
    proxyAddress="Uri"
    proxyAuthenticationScheme="None/Digest/Negotiate/Ntlm/Basic/Anonymous"
IntegratedWindowsAuthentication: Specifies Windows authentication"
    realm="String"
    requireClientCertificate=Boolean"
    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.

manualAddressing

Логическое значение, позволяющее пользователю взять на себя управление адресацией сообщений. Это свойство обычно используется в сценариях с маршрутизаторами, в которых приложение определяет, в какое из нескольких назначений должно быть отправлено сообщение.

Если атрибут имеет значение true, канал предполагает, что для сообщения уже задан адрес, и не добавляет к нему никаких дополнительных сведений. После этого пользователь может адресовать каждое сообщение по отдельности.

Если атрибут имеет значение false, используемый по умолчанию механизм адресации Windows Communication Foundation (WCF) автоматически создает адреса для всех сообщений.

Значение по умолчанию — false.

maxBufferPoolSize

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

Многие элементы WCF используют буферы. При создании буферов и их уничтожении после каждого использования расходуется слишком много ресурсов; при сборке мусора для буферов также расходуется слишком много ресурсов. Буферные пулы позволяют брать буфер из пула, использовать его, а затем возвращать обратно, когда он больше не требуется. Это позволяет избежать излишней нагрузки, связанной с созданием и уничтожением буферов.

maxBufferSize

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

maxReceivedMessageSize

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

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.

requireClientCertificate

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

transferMode

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

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

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

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

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

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

unsafeConnectionNtlmAuthentication

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

useDefaultWebProxy

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

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

Нет.

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

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

<binding>

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

Замечания

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

См. также

Справочник

<customBinding>
HttpsTransportElement
HttpsTransportBindingElement
TransportBindingElement
CustomBinding

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

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