<httpTransport>

Artigo
06/08/2023

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

<configuração>
  <system.serviceModel>
    <enlaces>
      <customBinding>
        <enlace>
          <httpTransport>

Syntax

<httpTransport allowCookies="Boolean"
               authenticationScheme="Digest/Negotiate/Ntlm/Basic/Anonymous"
               bypassProxyOnLocal="Boolean"
               hostnameComparisonMode="StrongWildcard/Exact/WeakWildcard"
               keepAliveEnabled="Boolean"
               maxBufferSize="Integer"
               proxyAddress="Uri"
               proxyAuthenticationScheme="None/Digest/Negotiate/Ntlm/Basic/Anonymous"
               realm="String"
               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 do servidor são copiados automaticamente 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 resumida. - Negociar: negoceia com o cliente para determinar o esquema de autenticação. Se o cliente e o servidor suportarem o Kerberos, será 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 nomes 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, da porta e do URI relativo. - Exato: sem carateres universais - WeakWildcard: ("*") corresponde a todos os nomes de anfitrião possíveis no contexto do esquema especificado, porta e UIR relativo que não tenham sido correspondidos explicitamente ou através do mecanismo de caráter universal forte. Este atributo é do tipo HostNameComparisonMode. A predefinição é StrongWildcard.
keepAliveEnabled	Um valor booleano que especifica se pretende fazer uma ligação persistente ao recurso da Internet.
maxBufferSize	Um número inteiro positivo que especifica o tamanho máximo da memória intermédia. A predefinição é 524288
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 qualquer autenticação. - Resumo: especifica a autenticação resumida. - Negociar: negoceia com o cliente para determinar o esquema de autenticação. Se o cliente e o servidor suportarem o Kerberos, será 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 realm 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 reinos são utilizados apenas para autenticação básica e resumida. Após a autenticação com êxito de um cliente, 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.
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: - Memória intermédia: as mensagens de pedido e resposta são colocados na memória intermédia. - Transmitido em fluxo: as mensagens de pedido e resposta são transmitidas em fluxo. - StreamedRequest: a mensagem do pedido é transmitida em fluxo e a mensagem de resposta é colocada na 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

Nenhuma

Elementos Principais

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

Observações

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

Partilhar via