Compartir a través de

<httpsTransport>

  • Artículo

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

<configuration>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <enlace>
          <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"
                realm="String"
                requireClientCertificate="Boolean"
                transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
                unsafeConnectionNtlmAuthentication="Boolean"
                useDefaultWebProxy="Boolean" />

Atributos y elementos

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

Atributos

Atributo Descripción
allowCookies Un valor booleano que especifica si el cliente acepta las cookies y las propaga en solicitudes futuras. De manera predeterminada, es false.

Puede usar este atributo al interactuar con los servicios Web 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 incluyen los siguientes:

- Resumen: 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 Anonymous. Este atributo es del tipo AuthenticationSchemes. Se puede establecer este atributo sólo una vez.
bypassProxyOnLocal Valor de tipo booleano que indica si se omitirá el servidor proxy para las direcciones locales. De manera predeterminada, es false.

Una dirección local es la que está en la LAN local o intranet.

Windows Communication Foundation (WCF) siempre ignora el proxy si la dirección del servicio empieza por http://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 System.ServiceModel.HostnameComparison.
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 evita la sobrecarga 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 incluyen los siguientes:

- None: no se lleva a cabo ninguna autenticación.
- Resumen: 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 Anonymous. Este atributo es del tipo AuthenticationSchemes. Ten en cuenta que AuthenticationSchemes.IntegratedWindowsAuthentication no es compatible.
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 dominio kerberos determinado. Para obtener una descripción detallada de los dominios, consulte RFC 2617, disponible enel sitio web de IETF.
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 incluyen 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. De manera predeterminada, 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 funcionalidades de enlace del enlace personalizado.

Comentarios

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. HTTPS es compatible con Windows Communication Foundation (WCF) para garantizar la interoperabilidad con otras pilas de servicios web.

Consulte también