<httpsTransport>

Artículo
02/27/2011

Especifica un transporte HTTP para transmitir los mensajes SOAP para un enlace personalizado.

Jerarquía del esquema

<<system.serviceModel>>
  <enlaces>
    <customBinding>
      <binding>
        <httpsTransport>

Sintaxis

<httpsTransport
    allowCookies=Boolean"
    authenticationScheme="Digest/Negotiate/Ntlm/Basic/Anonymous"
    bypassProxyOnLocal=Boolean"
    hostnameComparisonMode="StrongWildcard/Exact/WeakWildcard"
    manualAddressing="Boolean"
    maxBufferPoolSize="Integer"
    maxBufferSize="Integer"
    maxReceivedMessageSize="Integer"
    proxyAddress="Uri"
    proxyAuthenticationScheme="None/Digest/Negotiate/Ntlm/Basic/Anonymous"
IntegratedWindowsAuthentication: Specifies Windows authentication"
    realm="String"
    requireClientCertificate=Boolean"
    transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
        unsafeConnectionNtlmAuthentication="Boolean"
....useDefaultWebProxy="Boolean"
/>

Atributos y elementos

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

Atributos

Atributo	Descripción
allowCookies	Un valor booleano que especifica si el cliente acepta las cookies y las propaga en solicitudes futuras. El valor predeterminado es false. Puede usar este atributo al interactuar con los servicios Web de ASMX que utilizan cookies. De esta manera, puede estar seguro de que las cookies devueltas del servidor se copian automáticamente en todas las solicitudes de cliente futuras para ese servicio.
authenticationScheme	Especifica el protocolo utilizado para autenticar solicitudes de cliente que son procesadas por un agente de escucha HTTP. Los valores válidos son los siguientes: Digest: especifica la autenticación implícita. Negotiate: negocia con el cliente para determinar el esquema de autenticación. Si cliente y el servidor son compatibles con Kerberos, se utiliza; de lo contrario, se utiliza NTLM. Ntlm: especifica la autenticación NTLM. Basic: especifica la autenticación básica. Anonymous: especifica la autenticación anónima. El valor predeterminado es anónimo. Este atributo es del tipo AuthenticationSchemes. Se puede establecer este atributo sólo una vez.
bypassProxyOnLocal	Un valor booleano que indica si se omitirá el servidor proxy para las direcciones locales. El valor predeterminado es false. Una dirección local es la que está en la LAN local o intranet. Windows Communication Foundation (WCF) siempre omite el proxy si la dirección de servicio comienza con https://localhost. Debería utilizar el nombre del host en lugar del localhost si desea que los clientes pasen por un proxy al comunicarse con los servicios en el mismo equipo.
hostnameComparisonMode	Especifica el modo de comparación de nombres de host HTTP usado para analizar los URI. Los valores válidos son StrongWildcard: ("+") coincide con todos los posibles nombres del host en el contexto del esquema especificado, puerto y URI relativo. Exact: ningún carácter comodín WeakWildcard: ("*") coincide con todo posible nombre del host en el contexto del esquema especificado, puerto y URI relativo con los que no se han coincidido explícitamente o a través del mecanismo del carácter comodín fuerte. El valor predeterminado es StrongWildcard. Este atributo es del tipo HostnameComparisonMode.
manualAddressing	Un valor booleano que permite al usuario tomar el control del direccionamiento del mensaje. Esta propiedad normalmente se usa en escenarios del enrutador, donde la aplicación determina a cuál de los destinos va a enviar un mensaje. Si se establece en true, el canal supone que el mensaje ya se ha direccionado y no le agrega ninguna información adicional. El usuario puede direccionar a continuación individualmente cada mensaje. Cuando se establece en false, la Windows Communication Foundation predeterminada (WCF) que direcciona el mecanismo crea automáticamente las direcciones para todos los mensajes. El valor predeterminado es false.
maxBufferPoolSize	Un entero positivo que especifica el tamaño máximo del grupo de búferes. El valor predeterminado es 524288. Muchas partes de los búferes de uso WCF. Crear y destruir búferes cada vez que se usan es caro, y la recolección de elementos no utilizados para los búferes también es cara. Con grupos de búferes, puede tomar un búfer del grupo, usarlo y devolverlo al grupo una vez haya terminado. Así se evitan los gastos generales al crear y destruir búferes.
maxBufferSize	Un entero positivo que especifica el tamaño máximo del búfer. El valor predeterminado es 524288.
maxReceivedMessageSize	Un entero positivo que especifica el tamaño del mensaje permitido máximo que se puede recibir. El valor predeterminado es 65536.
proxyAddress	Un URI que especifica la dirección del proxy HTTP. Si useSystemWebProxy es true, este valor debe ser null. El valor predeterminado es null.
proxyAuthenticationScheme	Especifica el protocolo utilizado para autenticar solicitudes de cliente que son procesadas por un proxy HTTP. Los valores válidos son los siguientes: None: no se lleva a cabo ninguna autenticación. Digest: especifica la autenticación implícita. Negotiate: negocia con el cliente para determinar el esquema de autenticación. Si cliente y el servidor son compatibles con Kerberos, se utiliza; de lo contrario, se utiliza NTLM. Ntlm: especifica la autenticación NTLM. Basic: especifica la autenticación básica. Anonymous: especifica la autenticación anónima. IntegratedWindowsAuthentication: especifica la autenticación de Windows. El valor predeterminado es Anonymous. Este atributo es del tipo AuthenticationSchemes.
realm	Una cadena que especifica el dominio kerberos que se utilizará en el proxy/servidor. El valor predeterminado es una cadena vacía. Los servidores usan los dominios para particionar recursos protegidos. Cada partición puede tener su propio esquema de autenticación y/o base de datos de autorización. Los dominios sólo se utilizan para la autenticación básica e implícita. Cuando un cliente se autentica correctamente, la autenticación es válida para todos los recursos de un territorio determinado. Para obtener una descripción detallada de los dominios, consulte RFC 2617, disponible en http://www.ietf.org.
requireClientCertificate	Un valor booleano que especifica si el servidor necesita que el cliente proporcione un certificado de cliente como parte del protocolo de enlace HTTPS. El valor predeterminado es false.
transferMode	Especifica si los mensajes se almacenan en búfer, se transmiten o si son una solicitud o una respuesta. Los valores válidos son los siguientes: Buffered: los mensajes de respuesta y solicitud están almacenados en búfer. Streamed: se transmiten los mensajes de solicitud y respuesta. StreamedRequest: se transmite el mensaje de solicitud y el mensaje de respuesta está almacenado en búfer. StreamedResponse: se transmite el mensaje de respuesta y el mensaje de solicitud está almacenado en búfer. El valor predeterminado es Buffered. Este atributo es del tipo TransferMode.
unsafeConnectionNtlmAuthentication	Un valor booleano que especifica si la conexión compartida no segura está habilitada en el servidor. El valor predeterminado es false. Si está habilitado, la autenticación NTLM se realiza una vez en cada conexión TCP.
useDefaultWebProxy	Un valor que especifica si se utiliza la configuración del proxy del equipo en lugar de la configuración específica del usuario. El valor predeterminado es true.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
<binding>	Define todas las funciones de enlace del enlace personalizado.

Notas

El elemento httpsTransport es el punto inicial para crear un enlace personalizado que implementa el protocolo de transporte HTTPS. HTTPS es el transporte primario utilizado para fines de interoperabilidad segura. Windows Communication Foundation (WCF) admite HTTPS para asegurarse la interoperabilidad con otras pilas de servicios Web.

Vea también

Referencia

<customBinding>
HttpsTransportElement
HttpsTransportBindingElement
TransportBindingElement
CustomBinding

Otros recursos

Transports in Windows Communication Foundation
Choosing a Transport
Windows Communication Foundation Bindings
Extending Bindings
Custom Bindings

Compartir a través de