<transport> de <basicHttpBinding>

  • Artículo

Define las propiedades que controlan los parámetros de autenticación para el transporte HTTP.

<configuration>
  <system.serviceModel>
    <bindings>
      <basicHttpBinding>
        <binding>
          <security>
            <transporte>

Sintaxis

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

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo Descripción
clientCredentialType - Especifica el tipo de credencial que se va a utilizar al realizar la autenticación del cliente mediante la autenticación de HTTP. El valor predeterminado es None. Este atributo es del tipo HttpClientCredentialType.
proxyCredentialType - Especifica el tipo de credencial que se va a utilizar al realizar la autenticación del cliente desde un dominio utilizando un proxy sobre HTTP. Este atributo solo es aplicable cuando el atributo mode del elemento security primario es Transport o TransportCredentialsOnly. Este atributo es del tipo HttpProxyCredentialType.
realm Una cadena que especifica el dominio kerberos utilizado por el esquema de autenticación de HTTP para la autenticación básica o implícita. El valor predeterminado es una cadena vacía.
policyEnforcement Esta enumeración especifica cuándo se debe aplicar ExtendedProtectionPolicy.

1. Never: la directiva nunca se aplica (la protección extendida está deshabilitada).
2. WhenSupported: la directiva solamente se aplica si el cliente admite la protección extendida.
3. Always: la directiva siempre se aplica. Los clientes que no admitan la protección extendida no podrán autenticarse.
protectionScenario Esta enumeración especifica el escenario de protección que exige la directiva.

Atributo clientCredentialType

Valor Descripción
None Los mensajes no se protegen durante la transferencia.
Básico Especifica la autenticación básica.
Digest Especifica la autenticación implícita.
Ntlm Especifica la autenticación NTLM cuando sea posible y si la autenticación de Windows falla.
Windows Especifica la autenticación de Windows integrada.

Atributo proxyCredentialType

Valor Descripción
None - Los mensajes no se protegen durante la transferencia.
Básico Especifica la autenticación básica como se define en la autenticación RFC 2617 de HTTP: Autenticación básica e implícita.
Digest Especifica la autenticación implícita como se define en la autenticación RFC 2617 de HTTP: Autenticación básica e implícita
Ntlm Especifica la autenticación NTLM cuando sea posible y si la autenticación de Windows falla.
Windows Especifica la autenticación de Windows integrada.
Certificado Realiza la autenticación del cliente mediante un certificado. Esta opción solo funciona si el atributo Mode del elemento security primario se establece como Transport, y no funciona si está establecido como TransportCredentialOnly.

Elementos secundarios

Ninguno

Elementos primarios

Elemento Descripción
<security> Define las funciones de seguridad de <basicHttpBinding>.

Ejemplo

El ejemplo siguiente muestra el uso de seguridad de transporte de SSL con el enlace básico. De forma predeterminada, el enlace básico soporta la comunicación 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>

Consulte también