<trasportoHttps>

Articolo
04/07/2023

Specifica un trasporto HTTPS per trasmettere messaggi SOAP per un'associazione personalizzata.

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

Sintassi

<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"
                realm="String"
                requireClientCertificate="Boolean"
                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'impostazione predefinita è StrongWildcard. L'attributo è di tipo `System.ServiceModel.HostnameComparison`.
manualAddressing	Valore booleano che consente all'utente di assumere il controllo dell'indirizzamento dei messaggi. Questa proprietà viene usata 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. Il valore predefinito è `false`.
maxBufferPoolSize	Numero intero positivo che specifica la dimensione massima del pool di buffer. Il valore predefinito è 524288. Molte parti di WCF usano buffer. La creazione e l'eliminazione definitiva dei buffer a ogni uso sono operazioni onerose, analogamente a quelle di Garbage Collection dei buffer. Quando si usa un pool di buffer è possibile prelevare un buffer dal pool, usarlo e, al termine delle operazioni, riporlo nel pool. In questo modo è possibile evitare il sovraccarico dovuto alla creazione e all'eliminazione definitiva 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. Il valore predefinito è 65536.
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.
requireClientCertificate	Valore booleano che specifica se il server richiede al client di fornire un certificato client come parte dell'handshake HTTPS. Il valore predefinito è `false`.
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 httpsTransport rappresenta il punto iniziale per la creazione di un'associazione personalizzata che implementa il protocollo di trasporto HTTPS. HTTPS è il trasporto primario usato a fini di interoperabilità protetta. HTTPS è supportato da Windows Communication Foundation (WCF) per garantire l'interoperabilità con altri stack di servizi Web.

Condividi tramite