Compartilhar via


<httpTransport>

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

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

Sintaxe

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

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.

Esse atributo é do tipo HostNameComparisonMode. O padrão é StrongWildcard.
keepAliveEnabled Um valor booliano que especifica se é necessário fazer uma conexão persistente com o recurso de 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 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.
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

None

Elementos pai

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

Observações

O httpTransport elemento é o ponto de partida para a criação de 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.

Consulte também