<trasportoHttp>

  • Articolo

Specifica un trasporto HTTP per la trasmissione di messaggi SOAP per un'associazione personalizzata.

<system.serviceModel>
  <bindings>
    <associazionePersonalizzata>
      <associazione>
        <trasportoHttp>

<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"
IntegratedWindowsAuthentication: Specifies Windows authentication"
    realm="String"
    transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
        unsafeConnectionNtlmAuthentication="Boolean"
        useDefaultWebProxy="Boolean" />

Attributi ed elementi

Attributi

Attributo Descrizione

allowCookies

Valore booleano che specifica se il client accetta cookie e li propaga alle richieste future. L'impostazione predefinita è false.

È possibile utilizzare questo attributo quando si interagisce con servizi Web ASMX che utilizzano cookie. In questo modo i cookie restituiti dal server vengono copiati automaticamente in tutte le richieste client future per quel servizio.

authenticationScheme

Specifica il protocollo utilizzato per autenticare le richieste del client elaborate da un listener HTTP. Di seguito vengono elencati i valori validi:

  • Digest: specifica l'autenticazione digest.
  • Negotiate: negozia con il client per determinare lo schema di autenticazione. Viene utilizzato se il client e il server supportano entrambi Kerberos; in caso contrario, viene utilizzato NTLM.
  • Ntlm: specifica l'autenticazione NTLM.
  • Basic: specifica l'autenticazione di base.
  • Anonymous: specifica l'autenticazione anonima.

L'impostazione predefinita è Anonymous. L'attributo è di tipo AuthenticationSchemes. Questo attributo può essere impostato solo una volta.

bypassProxyOnLocal

Valore booleano che indica se ignorare il server proxy per gli indirizzi locali. L'impostazione predefinita è false.

Un indirizzo locale corrisponde a un indirizzo che si trova nella rete LAN o nell'Intranet locale.

Windows Communication Foundation (WCF) ignora sempre il proxy se l'indirizzo del servizio inizia con https://localhost.

È necessario utilizzare il nome host invece di localhost se si desidera che i client passino da un proxy quando comunicano con servizi nello stesso computer.

hostnameComparisonMode

Specifica la modalità di confronto del nome host HTTP utilizzata per analizzare gli URI. I valori validi sono:

  • StrongWildcard: ("+") corrisponde tutti i possibili nomi host nel contesto dello schema, porta e relativo URI specificati.
  • Exact: caratteri jolly non utilizzati
  • WeakWildcard: ("*") corrisponde a qualsiasi nome host possibile nel contesto dello schema, porta e relativo UIR specificati che non ha trovato una corrispondenza esplicita o tramite il meccanismo sicuro dei caratteri jolly.

L'impostazione predefinita è StrongWildcard. L'attributo è di tipo HostnameComparisonMode.

keepAliveEnabled

Valore booleano che specifica se eseguire una connessione permanente alla risorsa Internet.

maxBufferSize

Numero intero positivo che specifica la dimensione massima del buffer. L'impostazione predefinita è 524288.

proxyAddress

URI che specifica l'indirizzo del proxy HTTP. Se useSystemWebProxy è true, questa impostazione deve essere null. L'impostazione predefinita è null.

proxyAuthenticationScheme

Specifica il protocollo utilizzato per l'autenticazione delle richieste client elaborate da un proxy HTTP. Di seguito vengono elencati i valori validi:

  • None: non viene eseguita alcuna autenticazione.
  • Digest: specifica l'autenticazione digest.
  • Negotiate: negozia con il client per determinare lo schema di autenticazione. Viene utilizzato se il client e il server supportano entrambi Kerberos; in caso contrario, viene utilizzato NTLM.
  • Ntlm: specifica l'autenticazione NTLM.
  • Basic: specifica l'autenticazione di base.
  • Anonymous: specifica l'autenticazione anonima.
  • IntegratedWindowsAuthentication: specifica l'autenticazione di Windows.

Il valore predefinito è Anonymous. L'attributo è di tipo AuthenticationSchemes.

realm

Stringa che specifica l'area di autenticazione da utilizzare sul proxy/server. L'impostazione predefinita è una stringa vuota.

I server utilizzano aree di autenticazione per separare risorse protette. Ciascun partizione può prevedere un proprio schema di autenticazione e/o database di autorizzazione. Le aree vengono utilizzate solo per l'autenticazione di base e classificata. Se un client viene autenticato correttamente, l'autenticazione è valida per tutte le risorse in una determinata area. Per una descrizione dettagliata delle aree, vedere RFC 2617 all'indirizzo http://www.ietf.org.

transferMode

Specifica se i messaggi vengono memorizzati nel buffer o inviati nel flusso in una richiesta o una risposta. Di seguito vengono elencati i valori validi:

  • Buffered: i messaggi di richiesta e risposta vengono memorizzati nel buffer.
  • Streamed: i messaggi di richiesta e risposta vengono inviati nel flusso.
  • StreamedRequest: il messaggio di richiesta viene inviato nel flusso e quello di risposta viene memorizzato nel buffer.
  • StreamedResponse: il messaggio di richiesta viene memorizzato nel buffer e quello di risposta viene inviato nel flusso.

L'impostazione predefinita è Buffered. L'attributo è di tipo TransferMode.

unsafeConnectionNtlmAuthentication

Valore che specifica se nel server viene attivata la condivisione di connessioni non sicure. L'impostazione predefinita è false. Se attivata, l'autenticazione NTLM viene eseguita una volta su ciascuna connessione TCP.

useDefaultWebProxy

Valore booleano che specifica se vengono utilizzate le impostazioni proxy a livello di computer anziché le impostazioni utente specifiche. L'impostazione predefinita è true.

Elementi figlio

Nessuno

Elementi padre

Elemento Descrizione

<associazione>

Definisce tutte le funzionalità di associazione dell'associazione personalizzata.

Osservazioni

L'elemento httpTransport rappresenta il punto iniziale per la creazione di un'associazione personalizzata che implementa il protocollo di trasporto HTTP. Quest'ultimo è il principale trasporto utilizzato per scopi di interoperabilità. Questo trasporto è supportato da Windows Communication Foundation (WCF) per assicurare l'interoperabilità con altri stack di servizi Web diversi da WCF.

Vedere anche

Riferimenti

<associazionePersonalizzata>
HttpTransportElement
HttpTransportBindingElement
TransportBindingElement
CustomBinding

Altre risorse

Transports in Windows Communication Foundation
Choosing a Transport
Windows Communication Foundation Bindings
Extending Bindings
Custom Bindings