<httpsTransport>

  • Artigo

Especifica um transporte HTTPS para transmitir mensagens SOAP para um enlace personalizado.

<configuração>
  <system.serviceModel>
    <enlaces>
      <customBinding>
        <enlace>
          <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 secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo Descrição
allowCookies Um valor booleano que especifica se o cliente aceita cookies e os propaga em pedidos futuros. A predefinição é false.

Pode utilizar este atributo quando interage com serviços Web ASMX que utilizam cookies. Desta forma, pode certificar-se de que os cookies devolvidos a partir do servidor são automaticamente copiados para todos os futuros pedidos de cliente para esse serviço.
authenticationScheme Especifica o protocolo utilizado para autenticar pedidos de cliente que estão a ser processados por um serviço de escuta HTTP. Os valores válidos incluem o seguinte:

- Resumo: especifica a autenticação digestiva.
- Negociar: negoceia com o cliente para determinar o esquema de autenticação. Se o cliente e o servidor suportarem o Kerberos, é utilizado; caso contrário, é utilizado NTLM.
- Ntlm: especifica a autenticação NTLM.
- Básico: especifica a autenticação básica.
- Anónimo: especifica a autenticação anónima.

A predefinição é Anónimo. Este atributo é do tipo AuthenticationSchemes. Este atributo só pode ser definido uma vez.
bypassProxyOnLocal Um valor booleano que indica se deve ignorar o servidor proxy para endereços locais. A predefinição é false.

Um endereço local é um endereço que está na LAN ou intranet local.

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

Deve utilizar o nome do anfitrião em vez de localhost se pretender que os clientes utilizem um proxy ao falar com serviços no mesmo computador.
hostnameComparisonMode Especifica o modo de comparação de nome de anfitrião HTTP utilizado para analisar URIs. Os valores válidos são,

- StrongWildcard: ("+") corresponde a todos os nomes de anfitrião possíveis no contexto do esquema especificado, porta e URI relativo.
- Exato: sem carateres universais
- WeakWildcard: ("*") corresponde a todo o nome de anfitrião possível no contexto do esquema especificado, porta e UIR relativo que não foram explicitamente correspondidos ou através do mecanismo universal forte.

A predefinição é StrongWildcard. Este atributo é do tipo System.ServiceModel.HostnameComparison.
manualAddressing Um valor booleano que permite ao utilizador assumir o controlo do endereçamento de mensagens. Normalmente, esta propriedade é utilizada em cenários de router, onde a aplicação determina qual dos vários destinos para onde enviar uma mensagem.

Quando definido como true, o canal assume que a mensagem já foi endereçada e não adiciona informações adicionais à mesma. Em seguida, o utilizador pode abordar cada mensagem individualmente.

Quando definido como false, o mecanismo de endereçamento predefinido do Windows Communication Foundation (WCF) cria automaticamente endereços para todas as mensagens.

A predefinição é false.
maxBufferPoolSize Um número inteiro positivo que especifica o tamanho máximo do conjunto de memória intermédia. A predefinição é 524288.

Muitas partes do WCF utilizam memórias intermédias. A criação e destruição de memórias intermédias sempre que são utilizadas é dispendiosa e a recolha de lixo para memória intermédia também é dispendiosa. Com os conjuntos de memória intermédia, pode tirar uma memória intermédia do conjunto, utilizá-la e devolvê-la ao conjunto assim que terminar. Assim, evita-se a sobrecarga na criação e destruição de memórias intermédias.
maxBufferSize Um número inteiro positivo que especifica o tamanho máximo da memória intermédia. A predefinição é 524288
maxReceivedMessageSize Um número inteiro positivo que especifica o tamanho máximo de mensagem permitido que pode ser recebido. A predefinição é 65536.
proxyAddress Um URI que especifica o endereço do proxy HTTP. Se useSystemWebProxy for true, esta definição tem de ser null. A predefinição é null.
proxyAuthenticationScheme Especifica o protocolo utilizado para autenticar pedidos de cliente que estão a ser processados por um proxy HTTP. Os valores válidos incluem o seguinte:

- Nenhum: não é efetuada nenhuma autenticação.
- Resumo: especifica a autenticação digestiva.
- Negociar: negoceia com o cliente para determinar o esquema de autenticação. Se o cliente e o servidor suportarem o Kerberos, é utilizado; caso contrário, é utilizado NTLM.
- Ntlm: especifica a autenticação NTLM.
- Básico: especifica a autenticação básica.
- Anónimo: especifica a autenticação anónima.

A predefinição é Anónimo. Este atributo é do tipo AuthenticationSchemes. Tenha em atenção que AuthenticationSchemes.IntegratedWindowsAuthentication não é suportado.
realm Uma cadeia que especifica o reino a utilizar no proxy/servidor. A predefinição é uma cadeia vazia.

Os servidores utilizam realms para criar partições de recursos protegidos. Cada partição pode ter o seu próprio esquema de autenticação e/ou base de dados de autorização. Os realms são utilizados apenas para autenticação básica e digestiva. Depois de um cliente autenticar com êxito, a autenticação é válida para todos os recursos num determinado domínio. Para obter uma descrição detalhada dos reinos, consulte RFC 2617 no site do IETF.
requireClientCertificate Um valor booleano que especifica se o servidor requer que o cliente forneça um certificado de cliente como parte do handshake HTTPS. A predefinição é false.
transferMode Especifica se as mensagens são transmitidas em memória intermédia ou transmitidas em fluxo ou um pedido ou resposta. Os valores válidos incluem o seguinte:

- Em memória intermédia: as mensagens de pedido e resposta estão em memória intermédia.
- Transmitido em fluxo: as mensagens de pedido e resposta são transmitidas em fluxo.
- StreamedRequest: a mensagem de pedido é transmitida em fluxo e a mensagem de resposta é colocada em memória intermédia.
- StreamedResponse: a mensagem do pedido está em memória intermédia e a mensagem de resposta é transmitida em fluxo.

A predefinição é Memória Intermédia. Este atributo é do tipo TransferMode.
unsafeConnectionNtlmAuthentication Um valor booleano que especifica se a Partilha de Ligação Não Segura está ativada no servidor. A predefinição é false. Se estiver ativada, a autenticação NTLM é efetuada uma vez em cada ligação TCP.
useDefaultWebProxy Um valor booleano que especifica se as definições de proxy ao nível do computador são utilizadas em vez das definições específicas do utilizador. A predefinição é true.

Elementos Subordinados

Nenhum.

Elementos Principais

Elemento Descrição
<enlace> Define todas as capacidades de enlace do enlace personalizado.

Observações

O httpsTransport elemento é o ponto de partida para criar um enlace personalizado que implementa o protocolo de transporte HTTPS. O HTTPS é o transporte principal utilizado para fins de interoperabilidade segura. O HTTPS é suportado pelo Windows Communication Foundation (WCF) para garantir a interoperabilidade com outras pilhas de serviços Web.

Ver também