Share via

<httpTransport>

  • Artigo

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

<configuration>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <binding>
          <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 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.

Esse atributo é do tipo HostNameComparisonMode. O padrão é StrongWildcard.
keepAliveEnabled Um valor booliano que especifica se é preciso fazer uma conexão persistente com o recurso da Internet.
maxBufferSize Um inteiro positivo que especifica o tamanho máximo do buffer. O padrão é 524288
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.
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 httpTransport é o ponto de partida para criar uma associação personalizada que implementa o protocolo de transporte HTTP. HTTP é o transporte primário usado para fins de interoperabilidade. Esse transporte tem suporte do WCF (Windows Communication Foundation) para garantir a interoperabilidade com outras pilhas de serviços Web não WCF.

Confira também