<httpsTransport>

Artigo
04/07/2023

Especifica um transporte HTTPS para transmitir mensagens SOAP para uma associação personalizada.

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

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo	Descrição
allowCookies	Um valor booliano que especifica se o cliente aceita cookies e os propaga em futuras solicitações. O padrão é `false`. Você pode usar esse atributo ao interagir com os serviços Web ASMX que usam cookies. Dessa forma, você pode ter certeza de que os cookies retornados do servidor são copiados automaticamente para todas as solicitações futuras do cliente para esse serviço.
authenticationScheme	Especifica o protocolo usado para autenticar solicitações de cliente sendo processadas por um ouvinte HTTP. Os valores válidos incluem os seguintes: – Hash: especifica a autenticação por hash. – Negotiate: negocia com o cliente para determinar o esquema de autenticação. Se o cliente e o servidor oferecem suporte ao Kerberos, ele é usado; caso contrário, o NTLM é usado. – Ntlm: especifica a autenticação NTLM. – Basic: especifica a autenticação básica. – Anonymous: especifica a autenticação anônima. O padrão é Anônimo. Esse atributo é do tipo AuthenticationSchemes. Esse atributo só pode ser definido uma vez.
bypassProxyOnLocal	Um valor booliano que indica se o servidor proxy deve ser ignorado para endereços locais. O padrão é `false`. Um endereço local é um que está na LAN local ou na intranet. O WCF (Windows Communication Foundation) sempre ignora o proxy se o endereço de serviço começa com `http://localhost`. Use o nome do host em vez de localhost se quiser que os clientes passem por um proxy ao falar com serviços no mesmo computador.
hostnameComparisonMode	Especifica o modo de comparação de nome do host HTTP usado para analisar URIs. Os valores válidos são: – StrongWildcard: ("+") corresponde a todos os nomes de host possíveis no contexto do esquema, da porta e do URI relativo especificados. – Exact: sem caracteres curinga – WeakWildcard: ("*") corresponde a todos os nomes de host possíveis no contexto do esquema especificado, porta e UIR relativo que não tiveram correspondência explícita ou por meio do mecanismo de curinga forte. O padrão é StrongWildcard. Esse atributo é do tipo `System.ServiceModel.HostnameComparison`.
manualAddressing	Um valor booliano que permite que o usuário assuma o controle do endereçamento de mensagens. Essa propriedade geralmente é usada em cenários de roteador, em que o aplicativo determina para qual dos vários destinos ele enviará uma mensagem. Quando ele está definido como `true`, o canal pressupõe que a mensagem já foi endereçada e não adiciona nenhuma informação adicional a ela. Em seguida, o usuário pode endereçar cada mensagem individualmente. Quando ele está definido como `false`, o mecanismo de endereçamento padrão do WCF (Windows Communication Foundation) cria automaticamente endereços para todas as mensagens. O padrão é `false`.
maxBufferPoolSize	Um inteiro positivo que especifica o tamanho máximo do pool de buffers. O padrão é 524.288. Muitas partes do WCF usam buffers. Criar e destruir buffers cada vez que eles são usados é caro, e a coleta de lixo para buffers também é cara. Com os pools de buffers, você pode pegar um buffer do pool, usá-lo e devolvê-lo ao pool assim que terminar. Portanto, a sobrecarga na criação e na destruição de buffers é evitada.
maxBufferSize	Um inteiro positivo que especifica o tamanho máximo do buffer. O padrão é 524288
maxReceivedMessageSize	Um inteiro positivo que especifica o tamanho máximo permitido da mensagem que pode ser recebida. O padrão é 65536.
proxyAddress	Um URI que especifica o endereço do proxy HTTP. Se `useSystemWebProxy` for `true`, essa configuração precisará ser `null`. O padrão é `null`.
proxyAuthenticationScheme	Especifica o protocolo usado para autenticar solicitações de cliente sendo processadas por um proxy HTTP. Os valores válidos incluem os seguintes: – None: nenhuma autenticação é executada. – Hash: especifica a autenticação por hash. – Negotiate: negocia com o cliente para determinar o esquema de autenticação. Se o cliente e o servidor oferecem suporte ao Kerberos, ele é usado; caso contrário, o NTLM é usado. – Ntlm: especifica a autenticação NTLM. – Basic: especifica a autenticação básica. – Anonymous: especifica a autenticação anônima. O padrão é Anônimo. Esse atributo é do tipo AuthenticationSchemes. Observe que não há suporte para AuthenticationSchemes.IntegratedWindowsAuthentication.
realm	Uma cadeia de caracteres que especifica o realm a ser usado no proxy/servidor. O padrão é uma cadeia de caracteres vazia. Os servidores usam realms para particionar recursos protegidos. Cada partição pode ter um esquema de autenticação e/ou banco de dados de autorização próprio. Os realms são usados apenas para autenticação básica e de hash. Depois que um cliente é autenticado com êxito, a autenticação é válida para todos os recursos em um determinado realm. Para uma descrição detalhada de realms, confira RFC 2617 no site do IETF.
requireClientCertificate	Um valor booliano que especifica se o servidor precisa que o cliente forneça um certificado do cliente como parte do handshake HTTPS. O padrão é `false`.
transferMode	Especifica se as mensagens são armazenadas em buffer ou transmitidas em fluxo contínuo ou um solicitação ou resposta. Os valores válidos incluem os seguintes: – Buffered: as mensagens de solicitação e resposta são armazenadas em buffer. – Streamed: as mensagens de solicitação e resposta são transmitidas. – StreamedRequest: a mensagem de solicitação é transmitida e a mensagem de resposta é armazenada em buffer. – StreamedResponse: a mensagem de solicitação é armazenada em buffer e a mensagem de resposta é transmitida. O padrão é Buffered. Esse atributo é do tipo TransferMode.
unsafeConnectionNtlmAuthentication	Um valor booliano que especifica se Compartilhamento de Conexão Não Segura está habilitado no servidor. O padrão é `false`. Se estiver habilitado, a autenticação NTLM será executada uma vez em cada conexão TCP.
useDefaultWebProxy	Um valor booliano que especifica se as configurações de proxy de todo o computador são usados, em vez de configurações específicas de usuários. O padrão é `true`.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
<binding>	Define todas as funcionalidades de associação da associação personalizada.

Comentários

O elemento httpsTransport é o ponto de partida para criar uma associação personalizada que implementa o protocolo de transporte HTTPS. HTTPS é o transporte primário usado para fins de interoperabilidade segura. O HTTPS tem suporte do WCF (Windows Communication Foundation) para garantir a interoperabilidade com outras pilhas de serviços Web.

Compartilhar via