Compartir a través de

<httpsTransport>

Especifica un transporte HTTPS para transmitir mensajes SOAP para un enlace personalizado.

<configuration>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <binding>
          <httpsTransport>

Syntax

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

Attributes

Atributo Description
allowCookies Valor booleano que especifica si el cliente acepta cookies y los propaga en solicitudes futuras. El valor predeterminado es false.

Puede usar este atributo cuando interactúe con los servicios web ASMX que usan cookies. De este modo, puede asegurarse de que las cookies devueltas desde el servidor se copian automáticamente en todas las solicitudes futuras de cliente para ese servicio.
esquemaDeAutenticación Especifica el protocolo usado para autenticar las solicitudes de cliente que procesa un agente de escucha HTTP. Entre los valores válidos se incluyen los siguientes:

- Resumen: especifica la autenticación implícita.
- Negociar: negocia con el cliente para determinar el esquema de autenticación. Si tanto el cliente como el servidor admiten Kerberos, se usa; De lo contrario, se usa NTLM.
- Ntlm: especifica la autenticación NTLM.
- Básico: especifica la autenticación básica.
- Anónimo: especifica la autenticación anónima.

El valor predeterminado es Anónimo. Este atributo es de tipo AuthenticationSchemes. Este atributo solo se puede establecer una vez.
bypassProxyOnLocal Valor booleano que indica si se debe omitir el servidor proxy para las direcciones locales. El valor predeterminado es false.

Una dirección local es una que se encuentra en la LAN local o en la intranet.

Windows Communication Foundation (WCF) siempre omite el proxy si la dirección del servicio comienza por http://localhost.

Debe usar el nombre de host en lugar de localhost si desea que los clientes pasen por un proxy al comunicarse con los servicios en la misma máquina.
hostnameComparisonMode Especifica el modo de comparación de nombres de host HTTP que se usa para analizar los URI. Los valores válidos son,

- StrongWildcard: ("+") coincide con todos los nombres de host posibles en el contexto del esquema, puerto y URI relativo especificado.
- Exacto: sin caracteres comodín
- WeakWildcard: ("*") coincide con todo el nombre de host posible en el contexto del esquema, puerto y UIR relativo especificado que no se han coinciden explícitamente o a través del mecanismo de caracteres comodín seguro.

El valor predeterminado es StrongWildcard. Este atributo es de tipo System.ServiceModel.HostnameComparison.
manualAddressing Valor booleano que permite al usuario tomar el control de direccionamiento de mensajes. Esta propiedad se usa normalmente en escenarios de enrutador, donde la aplicación determina a qué uno de varios destinos enviar un mensaje.

Cuando se establece trueen , el canal supone que el mensaje ya se ha solucionado y no agrega información adicional a él. A continuación, el usuario puede dirigir cada mensaje individualmente.

Cuando se establece en false, el mecanismo de direccionamiento predeterminado de Windows Communication Foundation (WCF) crea automáticamente direcciones para todos los mensajes.

El valor predeterminado es false.
maxBufferPoolSize Entero positivo que especifica el tamaño máximo del grupo de búferes. El valor predeterminado es 524288.

Muchas partes de WCF usan búferes. La creación y destrucción de búferes cada vez que se usan es costosa y la recolección de elementos no utilizados para los búferes también es costosa. Con los grupos de búferes, puede tomar un búfer del grupo, usarlo y devolverlo al grupo una vez que haya terminado. Por lo tanto, se evita la sobrecarga en la creación y destrucción de búferes.
maxBufferSize Entero positivo que especifica el tamaño máximo del búfer. El valor predeterminado es 524288
maxReceivedMessageSize Entero positivo que especifica el tamaño máximo permitido del mensaje que se puede recibir. El valor predeterminado es 65536.
proxyAddress URI que especifica la dirección del proxy HTTP. Si useSystemWebProxy es true, esta configuración debe ser null. El valor predeterminado es null.
proxyAuthenticationScheme Especifica el protocolo utilizado para autenticar las solicitudes de cliente que procesa un proxy HTTP. Entre los valores válidos se incluyen los siguientes:

- Ninguno: no se realiza ninguna autenticación.
- Resumen: especifica la autenticación implícita.
- Negociar: negocia con el cliente para determinar el esquema de autenticación. Si tanto el cliente como el servidor admiten Kerberos, se usa; De lo contrario, se usa NTLM.
- Ntlm: especifica la autenticación NTLM.
- Básico: especifica la autenticación básica.
- Anónimo: especifica la autenticación anónima.

El valor predeterminado es Anónimo. Este atributo es de tipo AuthenticationSchemes. Tenga en cuenta que AuthenticationSchemes.IntegratedWindowsAuthentication no se admite.
reino Cadena que especifica el dominio kerberos que se va a usar en el proxy o servidor. El valor predeterminado es una cadena vacía.

Los servidores usan dominios para crear particiones de recursos protegidos. Cada partición puede tener su propio esquema de autenticación o base de datos de autorización. Los dominios solo se usan para la autenticación básica y implícita. Una vez que un cliente se autentica correctamente, la autenticación es válida para todos los recursos de un dominio determinado. Para obtener una descripción detallada de los dominios, consulte RFC 2617 en el sitio web de IETF.
requireClientCertificate Valor booleano que especifica si el servidor requiere 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 o se transmiten o una solicitud o respuesta. Entre los valores válidos se incluyen los siguientes:

- Almacenado en búfer: los mensajes de solicitud y respuesta se almacenan en búfer.
- Transmitido: los mensajes de solicitud y respuesta se transmiten.
- StreamedRequest: el mensaje de solicitud se transmite y el mensaje de respuesta se almacena en búfer.
- StreamedResponse: el mensaje de solicitud se almacena en búfer y se transmite el mensaje de respuesta.

El valor predeterminado es Buffered. Este atributo es de tipo TransferMode.
unsafeConnectionNtlmAuthentication Valor booleano que especifica si el uso compartido de conexiones no seguras está habilitado en el servidor. El valor predeterminado es false. Si está habilitada, la autenticación NTLM se realiza una vez en cada conexión TCP.
useDefaultWebProxy Valor booleano que especifica si se usa la configuración de proxy de toda la máquina en lugar de la configuración específica del usuario. El valor predeterminado es true.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento Description
<encuadernación> Define todas las funcionalidades de enlace del enlace personalizado.

Observaciones

El httpsTransport elemento es el punto de partida para crear un enlace personalizado que implementa el protocolo de transporte HTTPS. HTTPS es el transporte principal que se usa con 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

  • Last updated on