<transporte> do <basicHttpBinding>

  • Artigo

Define propriedades que controlam os parâmetros de autenticação para o transporte HTTP.

<configuração>
  <system.serviceModel>
    <enlaces>
      <basicHttpBinding>
        <enlace>
          <segurança>
            <transporte>

Syntax

<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>

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo Descrição
clientCredentialType - Especifica o tipo de credencial a utilizar ao efetuar a autenticação de cliente com a autenticação HTTP. A predefinição é None. Este atributo é do tipo HttpClientCredentialType.
proxyCredentialType - Especifica o tipo de credencial a utilizar ao efetuar a autenticação de cliente a partir de um domínio através de um proxy através de HTTP. Este atributo só é aplicável quando o mode atributo do elemento principal security é Transport ou TransportCredentialsOnly. Este atributo é do tipo HttpProxyCredentialType.
realm Uma cadeia que especifica o realm utilizado pelo esquema de autenticação HTTP para digestão ou autenticação básica. A predefinição é uma cadeia vazia.
policyEnforcement Esta enumeração especifica quando o ExtendedProtectionPolicy deve ser imposto.

1. Nunca – a política nunca é imposta (a Proteção Alargada está desativada).
2. Quando Suportado – a política só é imposta se o cliente suportar a Proteção Expandida.
3. Sempre – a política é sempre imposta. Os clientes que não suportam a Proteção Expandida não serão autenticados.
protectionScenario Esta enumeração especifica o cenário de proteção imposto pela política.

Atributo clientCredentialType

Valor Descrição
Nenhum As mensagens não são protegidas durante a transferência.
Básica Especifica a autenticação básica.
Resumo Especifica a autenticação resumida.
Ntlm Especifica a autenticação NTLM sempre que possível e se a autenticação do Windows falhar.
Windows Especifica a autenticação integrada do Windows.

Atributo proxyCredentialType

Valor Descrição
Nenhum - As mensagens não são protegidas durante a transferência.
Básica Especifica a autenticação básica conforme definido por RFC 2617 – Autenticação HTTP: Autenticação Básica e Resumida.
Resumo Especifica a autenticação resumida conforme definido por RFC 2617 – Autenticação HTTP: Autenticação Básica e Resumida.
Ntlm Especifica a autenticação NTLM sempre que possível e se a autenticação do Windows falhar.
Windows Especifica a autenticação integrada do Windows.
Certificado Efetua a autenticação de cliente com um certificado. Esta opção só funciona se o Mode atributo do elemento principal security estiver definido como Transporte e não funcionar se estiver definido como TransportCredentialOnly.

Elementos Subordinados

Nenhuma

Elementos Principais

Elemento Descrição
<segurança> Define as capacidades de segurança para o <basicHttpBinding>.

Exemplo

O exemplo seguinte demonstra a utilização da segurança de transporte SSL com o enlace básico. Por predefinição, o enlace básico suporta a comunicação 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>

Ver também