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