<trasportoHttps>

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

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

<httpsTransport
    allowCookies=Boolean"
    authenticationScheme="Digest/Negotiate/Ntlm/Basic/Anonymous"
    bypassProxyOnLocal=Boolean"
    hostnameComparisonMode="StrongWildcard/Exact/WeakWildcard"
    manualAddressing="Boolean"
    maxBufferPoolSize="Integer"
    maxBufferSize="Integer"
    maxReceivedMessageSize="Integer"
    proxyAddress="Uri"
    proxyAuthenticationScheme="None/Digest/Negotiate/Ntlm/Basic/Anonymous"
IntegratedWindowsAuthentication: Specifies Windows authentication"
    realm="String"
    requireClientCertificate=Boolean"
    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.

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

manualAddressing

Valore booleano che consente all'utente di assumere il controllo dell'indirizzamento dei messaggi. Questa proprietà viene utilizzata in genere in scenari di router, in cui è l'applicazione a determinare a quale delle tante destinazioni inviare un messaggio.

Quando è impostato su true, il canale presuppone che il messaggio sia già stato indirizzato e non aggiunge ulteriori informazioni. L'utente può indirizzare quindi individualmente ogni messaggio.

Quando è impostato su false, il meccanismo di indirizzamento predefinito di Windows Communication Foundation (WCF) crea automaticamente indirizzi per tutti i messaggi.

L'impostazione predefinita è false.

maxBufferPoolSize

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

Molte parti di WCF utilizzano buffer. La creazione e l'eliminazione dei buffer a ogni relativo utilizzo sono operazioni onerose, analogamente a quelle di Garbage Collection dei buffer. Quando si utilizza un pool di buffer è possibile prelevare un buffer dal pool, utilizzarlo e, al termine delle operazioni, riporlo nel pool. In questo modo è possibile evitare il sovraccarico dovuto alla creazione e all'eliminazione dei buffer.

maxBufferSize

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

maxReceivedMessageSize

Numero intero positivo che specifica la dimensione massima consentita del messaggio che può essere ricevuto. L'impostazione predefinita è 65.536.

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 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. Il valore predefinito è una stringa vuota.

I server utilizzano aree di autenticazione per separare risorse protette. Ogni partizione può avere schema di autenticazione e/o database di autorizzazione propri. 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.

requireClientCertificate

Valore booleano che specifica se il server richiede al client di fornire un certificato client come parte dell'handshake HTTPS. L'impostazione predefinita è false.

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 ogni 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 httpsTransport rappresenta il punto iniziale per la creazione di un'associazione personalizzata che implementa il protocollo di trasporto HTTPS. HTTPS è il trasporto primario utilizzato a fini di interoperabilità protetta. HTTPS è supportato da Windows Communication Foundation (WCF) per assicurare l'interoperabilità con altri stack dei servizi Web.

Vedere anche

Riferimenti

<associazionePersonalizzata>
HttpsTransportElement
HttpsTransportBindingElement
TransportBindingElement
CustomBinding

Altre risorse

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