<> de transporte <de basicHttpBinding ><transport> of <basicHttpBinding>

Define las propiedades que controlan los parámetros de autenticación para el transporte HTTP.Defines properties that control authentication parameters for the HTTP transport.

<configuration> <configuration>
   <> System. serviceModel  <system.serviceModel>
     <> de enlaces    <bindings>
       <> basicHttpBinding      <basicHttpBinding>
         <> de enlace        <binding>
           <> de seguridad          <security>
             <> de transporte            <transport>

SintaxisSyntax

<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 elementosAttributes and Elements

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

AtributoAttribute DESCRIPCIÓNDescription
clientCredentialTypeclientCredentialType : Especifica el tipo de credencial que se va a usar al realizar la autenticación del cliente mediante la autenticación HTTP.- Specifies the type of credential to be used when performing client authentication using HTTP authentication. El valor predeterminado es None.The default is None. Este atributo es del tipo HttpClientCredentialType.This attribute is of type HttpClientCredentialType.
proxyCredentialTypeproxyCredentialType : Especifica el tipo de credencial que se va a usar al realizar la autenticación de cliente desde dentro de un dominio mediante un proxy a través de HTTP.- Specifies the type of credential to be used when performing client authentication from within a domain using a proxy over HTTP. Este atributo solo es aplicable cuando el atributo mode del elemento security primario es Transport o TransportCredentialsOnly.This attribute is applicable only when the mode attribute of the parent security element is Transport or TransportCredentialsOnly. Este atributo es del tipo HttpProxyCredentialType.This attribute is of type HttpProxyCredentialType.
realmrealm 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.A string that specifies the realm that is used by the HTTP authentication scheme for digest or basic authentication. El valor predeterminado es una cadena vacía.The default is an empty string.
policyEnforcementpolicyEnforcement Esta enumeración especifica cuándo se debe aplicar ExtendedProtectionPolicy.This enumeration specifies when the ExtendedProtectionPolicy should be enforced.

1. Never: la directiva nunca se aplica (la protección extendida está deshabilitada).1. Never – The policy is never enforced (Extended Protection is disabled).
2. WhenSupported: la directiva solamente se aplica si el cliente admite la protección extendida.2. WhenSupported – The policy is enforced only if the client supports Extended Protection.
3. Always: la directiva siempre se aplica.3. Always – The policy is always enforced. Los clientes que no admitan la protección extendida no podrán autenticarse.Clients which don’t support Extended Protection will fail to authenticate.
protectionScenarioprotectionScenario Esta enumeración especifica el escenario de protección que exige la directiva.This enumeration specifies the protection scenario enforced by the policy.

Atributo clientCredentialTypeclientCredentialType Attribute

ValorValue DESCRIPCIÓNDescription
NoneNone Los mensajes no se protegen durante la transferencia.Messages are not secured during transfer.
BásicaBasic Especifica la autenticación básica.Specifies basic authentication.
ImplícitaDigest Especifica la autenticación implícita.Specifies digest authentication.
NtlmNtlm Especifica la autenticación NTLM cuando sea posible y si la autenticación de Windows falla.Specifies NTLM authentication when possible, and if Windows authentication fails.
WindowsWindows Especifica la autenticación de Windows integrada.Specifies Windows integrated authentication.

Atributo proxyCredentialTypeproxyCredentialType Attribute

ValorValue DESCRIPCIÓNDescription
NoneNone : Los mensajes no están protegidos durante la transferencia.- Messages are not secured during transfer.
BásicaBasic Especifica la autenticación básica tal y como se define en RFC 2617: autenticación HTTP: Autenticación básica e implícita.Specifies basic authentication as defined by RFC 2617 – HTTP Authentication: Basic and Digest Authentication.
ImplícitaDigest Especifica la autenticación implícita tal y como se define en RFC 2617: autenticación HTTP: Autenticación básica e implícita.Specifies digest authentication as defined by RFC 2617 – HTTP Authentication: Basic and Digest Authentication.
NtlmNtlm Especifica la autenticación NTLM cuando sea posible y si la autenticación de Windows falla.Specifies NTLM authentication when possible, and if Windows authentication fails.
WindowsWindows Especifica la autenticación de Windows integrada.Specifies Windows integrated authentication.
CertificateCertificate Realiza la autenticación del cliente mediante un certificado.Performs client authentication using a certificate. 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.This option works only if the Mode attribute of the parent security element is set to Transport, and will not work if it is set to TransportCredentialOnly.

Elementos secundariosChild Elements

NoneNone

Elementos primariosParent Elements

ElementoElement DESCRIPCIÓNDescription
<security><security> Define las funciones de seguridad para el <> basicHttpBinding.Defines the security capabilities for the <basicHttpBinding>.

EjemploExample

El ejemplo siguiente muestra el uso de seguridad de transporte de SSL con el enlace básico.The following example demonstrates the use of SSL transport security with the basic binding. De forma predeterminada, el enlace básico soporta la comunicación HTTP.By default, the basic binding supports HTTP communication.

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

Vea tambiénSee also