<transport> de <basicHttpBinding>

Artículo
06/08/2023

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>

Compartir a través de