<transporte> de <netHttpBinding>

Artigo
06/08/2023

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

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

Syntax

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

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 reino que é 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. WhenSupported – 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 digestiva.
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 Digest.
Resumo	Especifica a autenticação digestiva conforme definido por RFC 2617 – Autenticação HTTP: Autenticação Básica e Digest.
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 netHttpBinding<>.

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="netHttpBinding"
                bindingConfiguration="Binding1"
                contract="Microsoft.ServiceModel.Samples.ICalculator" />
    </service>
  </services>
  <bindings>
    <netHttpBinding>
      <!-- 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>
    </netHttpBinding>
  </bindings>
</system.serviceModel>

Partilhar via