Condividi tramite


<trasportoHttp>

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

<Configurazione>
  <system.serviceModel>
    <Associazioni>
      <Custombinding>
        <Associazione>
          <trasportoHttp>

Sintassi

<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" />

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo Descrizione
allowCookies Valore booleano che specifica se il client accetta cookie e li propaga alle richieste future. Il valore predefinito è false.

È possibile usare questo attributo quando si interagisce con servizi Web ASMX che usano 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 usato per autenticare le richieste del client elaborate da un listener HTTP. I valori validi sono i seguenti:

- Digest: specifica l'autenticazione del digest.
- Negoziazione: negozia con il client per determinare lo schema di autenticazione. Viene usato se il client e il server supportano entrambi Kerberos; in caso contrario, viene usato NTLM.
- Ntlm: specifica l'autenticazione NTLM.
- Basic: specifica l'autenticazione di base.
- Anonimo: specifica l'autenticazione anonima.

Il valore predefinito è 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 indirizzi locali. Il valore predefinito è 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 http://localhost.

È necessario usare 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 usata per analizzare gli URI. I valori validi sono:

- StrongWildcard: ("+") corrisponde a tutti i possibili nomi host nel contesto dello schema, della porta e dell'URI relativo specificati.
- Esatto: nessun carattere jolly
- WeakWildcard: ("*") corrisponde a tutti i possibili nomi host nel contesto dello schema, della porta e dell'UIR relativi che non sono stati corrispondenti in modo esplicito o tramite il meccanismo con caratteri jolly forti.

L'attributo è di tipo HostNameComparisonMode. Il valore predefinito è StrongWildcard.
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. Il valore predefinito è null.
proxyAuthenticationScheme Specifica il protocollo usato per l'autenticazione delle richieste client elaborate da un proxy HTTP. I valori validi sono i seguenti:

- Nessuna: non viene eseguita alcuna autenticazione.
- Digest: specifica l'autenticazione del digest.
- Negoziazione: negozia con il client per determinare lo schema di autenticazione. Viene usato se il client e il server supportano entrambi Kerberos; in caso contrario, viene usato NTLM.
- Ntlm: specifica l'autenticazione NTLM.
- Basic: specifica l'autenticazione di base.
- Anonimo: specifica l'autenticazione anonima.

Il valore predefinito è Anonymous. L'attributo è di tipo AuthenticationSchemes. Si noti che AuthenticationSchemes.IntegratedWindowsAuthentication non è supportato.
realm Stringa che specifica l'area di autenticazione da usare sul proxy/server. Il valore predefinito è una stringa vuota.

I server usano aree di autenticazione per separare risorse protette. Ogni partizione può avere schema di autenticazione e/o database di autorizzazione propri. Le aree vengono usate 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 di autenticazione, vedere RFC 2617 nel sito Web IETF.
transferMode Specifica se i messaggi vengono memorizzati nel buffer o inviati nel flusso in una richiesta o una risposta. I valori validi sono i seguenti:

- Buffered: i messaggi di richiesta e risposta vengono memorizzati nel buffer.
- Streamed: i messaggi di richiesta e risposta vengono trasmessi.
- StreamedRequest: il messaggio di richiesta viene trasmesso e il messaggio di risposta viene memorizzato nel buffer.
- StreamedResponse: il messaggio di richiesta viene memorizzato nel buffer e viene trasmesso il messaggio di risposta.

L'impostazione predefinita è Buffered. L'attributo è di tipo TransferMode.
unsafeConnectionNtlmAuthentication Valore che specifica se nel server viene attivata la condivisione di connessioni non sicure. Il valore predefinito è false. Se abilitata, l'autenticazione NTLM viene eseguita una volta su ogni connessione TCP.
useDefaultWebProxy Valore booleano che specifica se vengono usate le impostazioni proxy a livello di computer anziché le impostazioni utente specifiche. Il valore predefinito è true.

Elementi figlio

Nessuno

Elementi padre

Elemento Descrizione
<Associazione> Definisce tutte le funzionalità di associazione dell'associazione personalizzata.

Commenti

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 usato per scopi di interoperabilità. Questo trasporto è supportato da Windows Communication Foundation (WCF) per garantire l'interoperabilità con altri stack di servizi Web non WCF.

Vedi anche