Partilhar via

<httpsTransport>

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

<configuração>
   <system.serviceModel>
     <Encadernações>
       <customBinding>
         <Encadernação>
           <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 booleano que especifica se o cliente aceita cookies e os propaga em pedidos futuros. A predefinição é false.

Pode usar este atributo quando interagir com serviços Web ASMX que utilizam cookies. Desta forma, pode ter a certeza de que os cookies devolvidos pelo servidor são automaticamente copiados para todos os pedidos futuros dos clientes para esse serviço.
esquema de autenticação Especifica o protocolo usado para autenticar pedidos de cliente processados por um ouvinte HTTP. Os valores válidos incluem os seguintes:

- Digest: Especifica a autenticação do digest.
- Negociar: Negocia com o cliente para determinar o esquema de autenticação. Se tanto o cliente como o servidor suportarem Kerberos, é utilizado; caso contrário, utiliza-se NTLM.
- Ntlm: Especifica a autenticação NTLM.
- Básico: Especifica autenticação básica.
- Anónimo: Especifica autenticação anónima.

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

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

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

Deves usar o nome de host em vez de localhost se quiseres que os clientes passem por um proxy ao falar com serviços na mesma máquina.
Modo de Comparação Nome do Host Especifica o modo de comparação de nomes 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 especificado, porta e URI relativa.
- Exato: sem curingas
- WeakWildcard: ("*") corresponde a todos os nomes de host possíveis no contexto do esquema especificado, porta e UIR relativo que não foram explicitamente correspondidos ou através do mecanismo forte de wildcard.

O padrão é StrongWildcard. Este atributo é do tipo System.ServiceModel.HostnameComparison.
Manual Endereçamento Um valor booleano que permite ao utilizador assumir o controlo do endereçamento da mensagem. Esta propriedade é geralmente usada em cenários de router, onde a aplicação determina para qual dos vários destinos enviar uma mensagem.

Quando definido para true, o canal assume que a mensagem já foi endereçada e não acrescenta qualquer informação adicional a ela. O utilizador pode então endereçar cada mensagem individualmente.

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

A predefinição é false.
maxBufferPoolSize Um inteiro positivo que especifica o tamanho máximo do pool de buffer. O padrão é 524288.

Muitas partes do WCF usam buffers. Criar e destruir buffers sempre que são usados é caro, e a recolha de lixo para buffers também é dispendiosa. Com os buffer pools, podes pegar num buffer do pool, usá-lo e devolvê-lo ao pool quando terminares. Assim, evita-se a sobrecarga na criação e destruição de tampões.
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.
Proxy Address Um URI que especifica o endereço do proxy HTTP. Se useSystemWebProxy for true, esta definição deve ser null. A predefinição é null.
proxy AuthenticationScheme Especifica o protocolo usado para autenticar pedidos de cliente processados por um proxy HTTP. Os valores válidos incluem os seguintes:

- Nenhum: Não é realizada autenticação.
- Digest: Especifica a autenticação do digest.
- Negociar: Negocia com o cliente para determinar o esquema de autenticação. Se tanto o cliente como o servidor suportarem Kerberos, é utilizado; caso contrário, utiliza-se NTLM.
- Ntlm: Especifica a autenticação NTLM.
- Básico: Especifica autenticação básica.
- Anónimo: Especifica autenticação anónima.

O padrão é Anónimo. Este atributo é do tipo AuthenticationSchemes. Note que AuthenticationSchemes.IntegratedWindowsAuthentication isso não é suportado.
reino Uma string que especifica o reino a usar no proxy/servidor. O padrão é uma cadeia de caracteres vazia.

Os servidores usam reinos para particionar recursos protegidos. Cada partição pode ter o seu próprio esquema de autenticação e/ou base de dados de autorização. Os reinos são usados apenas para autenticação básica e digestiva. Depois de um cliente autenticar com sucesso, a autenticação torna-se válida para todos os recursos num determinado reino. Para uma descrição detalhada dos reinos, consulte o RFC 2617 no site da IETF.
requireClientCertificate Um valor booleano que especifica se o servidor exige 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 armazenadas em buffer, transmitidas em streaming, ou se são um pedido ou resposta. Os valores válidos incluem os seguintes:

- Em buffer: As mensagens de pedido e resposta são armazenadas em buffer.
- Transmitida: As mensagens de pedido e resposta são transmitidas em streaming.
- StreamedRequest: A mensagem de pedido é transmitida em streaming e a mensagem de resposta é armazenada em buffer.
- StreamedResponse: A mensagem de pedido é armazenada em buffer e a mensagem de resposta é transmitida.

O padrão é Buffered. Este atributo é do tipo TransferMode.
unsafeConnectionNtlmAuthentication Um valor booleano que especifica se a Partilha de Ligação Insegura está ativada no servidor. A predefinição é false. Se ativada, a autenticação NTLM é realizada uma vez em cada ligação TCP.
useDefaultWebProxy Um valor booleano que especifica se as definições do proxy a nível da máquina são usadas em vez das definições específicas do utilizador. A predefinição é true.

Elementos filho

Nenhum.

Elementos Principais

Elemento Description
<Encadernação> Define todas as capacidades de ligação da ligação personalizada.

Observações

O httpsTransport elemento é o ponto de partida para criar uma ligação personalizada que implementa o protocolo de transporte HTTPS. O HTTPS é o principal transporte utilizado para fins de interoperabilidade segura. O HTTPS é suportado pela Windows Communication Foundation (WCF) para garantir interoperabilidade com outras pilhas de serviços Web.

Consulte também

  • Last updated on