<<транспорт> basicHttpBinding>

Статья
06/08/2023

Определяет свойства, которые управляют параметрами проверки подлинности для транспорта HTTP.

<Конфигурации>
  <system.serviceModel>
    <Привязки>
      <basicHttpBinding>
        <Привязки>
          <Безопасности>
            <Транспорта>

Синтаксис

<basicHttpBinding>
  <binding>
    <security mode="None|Transport|Message|TransportWithMessageCredential|TransportCredentialOnly">
      <transport clientCredentialType="None|Basic|Digest|Ntlm|Windows"
                 proxyCredentialType="None|Basic|Digest|Ntlm|Windows"
                 realm="String">
        <extendedProtectionPolicy policyEnforcement="Never|WhenSupported|Always"
                                  protectionScenario="TransportSelected|TrustedProxy">
          <customServiceNames>
          </customServiceNames>
        </extendedProtectionPolicy>
      </transport>
    </security>
  </binding>
</basicHttpBinding>

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

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

Атрибуты

Атрибут	Описание
clientCredentialType	— указывает тип учетных данных, используемых при проверке подлинности клиента с использованием проверки подлинности HTTP. Значение по умолчанию — `None`. Это атрибут типа HttpClientCredentialType.
proxyCredentialType	— указывает тип учетных данных, используемых при проверке подлинности клиента из домена с помощью прокси-сервера по протоколу HTTP. Этот атрибут применим, только если атрибут `mode` родительского элемента `security` имеет значение `Transport` или `TransportCredentialsOnly`. Это атрибут типа HttpProxyCredentialType.
realm	Строка, указывающая область, используемую схемой проверки подлинности HTTP для обычной проверки подлинности или дайджест-проверки подлинности. Значением по умолчанию является пустая строка.
policyEnforcement	Это перечисление указывает, когда следует применять ExtendedProtectionPolicy. 1. Никогда — политика никогда не применяется (расширенная защита отключена). 2. WhenSupported — политика применяется только в том случае, если клиент поддерживает расширенную защиту. 3. Всегда — политика всегда применяется. Клиенты, которые не поддерживают расширенную защиту, не смогут пройти проверку подлинности.
protectionScenario	Это перечисление указывает сценарий защиты, регламентированный политикой.

Атрибут clientCredentialType

Значение	Описание
Нет	Во время передачи сообщения не защищены.
Basic	Задает обычную проверку подлинности.
Digest (дайджест)	Задает дайджест-проверку подлинности.
Ntlm	Задает проверку подлинности NTLM, если это возможно и если не удается выполнить проверку подлинности Windows.
Windows	Задает встроенную проверку подлинности Windows.

Атрибут proxyCredentialType

Значение	Описание
Нет	— Сообщения не защищены во время передачи.
Basic	Задает обычную проверку подлинности, как определено документом RFC 2617, который посвящен проверке подлинности HTTP, обычной проверке и дайджест-проверке подлинности.
Digest (дайджест)	Задает дайджест-проверку подлинности, как определено документом RFC 2617, который посвящен проверке подлинности HTTP, обычной проверке и дайджест-проверке подлинности.
Ntlm	Задает проверку подлинности NTLM, если это возможно и если не удается выполнить проверку подлинности Windows.
Windows	Задает встроенную проверку подлинности Windows.
Сертификат	Выполняет проверку подлинности клиента с использованием сертификата. Такая возможность действует, только если атрибут `Mode` родительского элемента `security` имеет значение Transport, и не действует, если этот атрибут имеет значение TransportCredentialOnly.

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

Нет

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

Элемент	Описание
<Безопасности>	Определяет возможности безопасности для <basicHttpBinding>.

Пример

В следующем примере демонстрируется использование безопасности транспорта SSL с использованием основной привязки. По умолчанию основная привязка поддерживает взаимодействие по протоколу HTTP.

<system.serviceModel>
  <services>
    <service type="Microsoft.ServiceModel.Samples.CalculatorService"
             behaviorConfiguration="CalculatorServiceBehavior">
      <endpoint address=""
                binding="basicHttpBinding"
                bindingConfiguration="Binding1"
                contract="Microsoft.ServiceModel.Samples.ICalculator" />
    </service>
  </services>
  <bindings>
    <basicHttpBinding>
      <!-- Configure basicHttpBinding with Transport security -->
      <!-- mode and clientCredentialType set to None. -->
      <binding name="Binding1">
        <security mode="Transport">
          <transport clientCredentialType="None"
                     proxyCredentialType="None">
            <extendedProtectionPolicy policyEnforcement="WhenSupported"
                                      protectionScenario="TransportSelected">
              <customServiceNames>
              </customServiceNames>
            </extendedProtectionPolicy>
          </transport>
        </security>
      </binding>
    </basicHttpBinding>
  </bindings>
</system.serviceModel>

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