Compartilhar via

<httpsTransport>

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

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

Sintaxe

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

Attributes

Attribute Description
allowCookies Um valor booliano que especifica se o cliente aceita cookies e os propaga em solicitações futuras. 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 automaticamente copiados para todas as solicitações futuras do cliente para esse serviço.
esquema de autenticação Especifica o protocolo usado para autenticar solicitações de cliente que estão sendo processadas por um ouvinte HTTP. Os valores válidos incluem o seguinte:

- Resumo: especifica a autenticação digest.
- Negociar: negocia com o cliente para determinar o esquema de autenticação. Se o cliente e o servidor deem suporte ao Kerberos, ele será usado; caso contrário, NTLM será usado.
- Ntlm: especifica a autenticação NTLM.
– Básico: especifica a autenticação básica.
– Anônimo: 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 é aquele que está na LAN ou intranet local.

O WCF (Windows Communication Foundation) sempre ignora o proxy se o endereço de serviço começa com http://localhost.

Você deve usar 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 de 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.
– Exato: sem curingas
- WeakWildcard: ("*") corresponde a todos os nomes de host possíveis no contexto do esquema, da porta e do UIR relativo especificados que não foram correspondidos explicitamente ou por meio do mecanismo 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 enviar uma mensagem.

Quando 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 abordar cada mensagem individualmente.

Quando definido como false, o mecanismo de endereçamento padrão do Windows Communication Foundation (WCF) 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 é 524288.

Muitas partes do WCF usam buffers. Criar e destruir buffers sempre que eles são usados é caro e a coleta de lixo para buffers também é cara. Com 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 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 recebido. O padrão é 65536.
proxyAddress Um URI que especifica o endereço do proxy HTTP. Se useSystemWebProxy for true, essa configuração deve ser null. O padrão é null.
proxyAuthenticationScheme Especifica o protocolo usado para autenticar solicitações de cliente que estão sendo processadas por um proxy HTTP. Os valores válidos incluem o seguinte:

- Nenhum: nenhuma autenticação é executada.
- Resumo: especifica a autenticação digest.
- Negociar: negocia com o cliente para determinar o esquema de autenticação. Se o cliente e o servidor deem suporte ao Kerberos, ele será usado; caso contrário, NTLM será usado.
- Ntlm: especifica a autenticação NTLM.
– Básico: especifica a autenticação básica.
– Anônimo: especifica a autenticação anônima.

O padrão é Anônimo. Esse atributo é do tipo AuthenticationSchemes. Observe que AuthenticationSchemes.IntegratedWindowsAuthentication não há suporte.
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 seu próprio esquema de autenticação e/ou banco de dados de autorização. Os realms são usados apenas para autenticação básica e digest. Depois que um cliente é autenticado com êxito, a autenticação é válida para todos os recursos em um determinado realm. Para obter uma descrição detalhada dos realms, consulte RFC 2617 no site do IETF.
requireClientCertificate Um valor booliano que especifica se o servidor requer que o cliente forneça um certificado de cliente como parte do handshake HTTPS. O padrão é false.
transferMode Especifica se as mensagens são armazenadas em buffer ou transmitidas ou uma solicitação ou resposta. Os valores válidos incluem o seguinte:

- Buffer: as mensagens de solicitação e resposta são armazenadas em buffer.
– Transmitido: 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 é Buffer. Esse atributo é do tipo TransferMode.
unsafeConnectionNtlmAuthentication Um valor booliano que especifica se o Compartilhamento de Conexão Não Seguro está habilitado no servidor. O padrão é false. Se habilitada, 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 em todo o computador são usadas em vez das configurações específicas do usuário. O padrão é true.

Elementos filho

Nenhum.

Elementos pai

Elemento Description
<ligação> Define todos os recursos de associação da associação personalizada.

Observações

O httpsTransport elemento é 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 seguros de interoperabilidade. O HTTPS tem suporte do WCF (Windows Communication Foundation) para garantir a interoperabilidade com outras pilhas de serviços Web.

Consulte também

  • Last updated on