Condividi tramite

<httpsTransport>

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

<configuration>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <binding>
          <httpsTransport>

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.

Attributes

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

È possibile usare questo attributo quando si interagisce con i servizi Web ASMX che usano i cookie. In questo modo, è possibile assicurarsi che i cookie restituiti dal server vengano copiati automaticamente in tutte le future richieste client per tale servizio.
schema di autenticazione Specifica il protocollo usato per autenticare le richieste client elaborate da un listener HTTP. I valori validi includono quanto segue:

- Digest: specifica l'autenticazione digest.
- Negoziazione: negozia con il client per determinare lo schema di autenticazione. Se sia il client che il server supportano Kerberos, viene usato; in caso contrario, viene utilizzato NTLM.
- Ntlm: specifica l'autenticazione NTLM.
- Basic: specifica l'autenticazione di base.
- Anonimo: specifica l'autenticazione anonima.

Il valore predefinito è Anonymous. Questo attributo è di tipo AuthenticationSchemes. Questo attributo può essere impostato una sola volta.
bypassProxyOnLocal Valore booleano che indica se ignorare il server proxy per gli indirizzi locali. Il valore predefinito è false.

Un indirizzo locale è uno che si trova nella rete LAN locale o intranet.

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

È consigliabile usare il nome host anziché localhost se si vuole che i client usino un proxy quando si comunica con i servizi nello stesso computer.
hostnameComparisonMode Specifica la modalità di confronto dei nomi host HTTP usata per analizzare gli URI. I valori validi sono:

- StrongWildcard: ("+") corrisponde a tutti i nomi host possibili 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 relativo specificati che non sono stati confrontati in modo esplicito o tramite il meccanismo con caratteri jolly sicuri.

Il valore predefinito è StrongWildcard. Questo attributo è di tipo System.ServiceModel.HostnameComparison.
Manualaddressing Valore booleano che consente all'utente di assumere il controllo dell'indirizzamento dei messaggi. Questa proprietà viene in genere utilizzata negli scenari router, in cui l'applicazione determina a quale destinazione inviare un messaggio.

Se impostato su true, il canale presuppone che il messaggio sia già stato risolto e non vi aggiunga altre informazioni. L'utente può quindi indirizzare ogni messaggio singolarmente.

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

Il valore predefinito è false.
maxBufferPoolSize Intero positivo che specifica le dimensioni massime del pool di buffer. Il valore predefinito è 524288.

Molte parti di WCF usano buffer. La creazione e l'eliminazione di buffer ogni volta che vengono usati è costosa e anche l'operazione di Garbage Collection per i buffer è costosa. Con i pool di buffer, è possibile recuperare un buffer dal pool, usarlo e restituirlo al pool al termine dell'operazione. Pertanto, viene evitato il sovraccarico nella creazione e nell'eliminazione dei buffer.
maxBufferSize Intero positivo che specifica la dimensione massima del buffer. Il valore predefinito è 524288
maxReceivedMessageSize Intero positivo che specifica la dimensione massima consentita del messaggio che può essere ricevuta. 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 autenticare le richieste client elaborate da un proxy HTTP. I valori validi includono quanto segue:

- Nessuno: non viene eseguita alcuna autenticazione.
- Digest: specifica l'autenticazione digest.
- Negoziazione: negozia con il client per determinare lo schema di autenticazione. Se sia il client che il server supportano Kerberos, viene usato; in caso contrario, viene utilizzato NTLM.
- Ntlm: specifica l'autenticazione NTLM.
- Basic: specifica l'autenticazione di base.
- Anonimo: specifica l'autenticazione anonima.

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

I server usano aree di autenticazione per partizionare le risorse protette. Ogni partizione può avere un proprio schema di autenticazione e/o un database di autorizzazione. Le aree di autenticazione vengono usate solo per l'autenticazione di base e digest. Dopo l'autenticazione di un client, l'autenticazione è valida per tutte le risorse in un'area di autenticazione specifica. 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 trasmessi o una richiesta o una risposta. I valori validi includono quanto segue:

- Memorizzato nel buffer: i messaggi di richiesta e risposta vengono memorizzati nel buffer.
- Trasmesso: 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 il messaggio di risposta viene trasmesso in streaming.

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

Elementi figli

Nessuno.

Elementi padre

Elemento Description
<rilegatura> Definisce tutte le funzionalità di associazione dell'associazione personalizzata.

Osservazioni:

L'elemento httpsTransport è il punto di partenza per la creazione di un'associazione personalizzata che implementa il protocollo di trasporto HTTPS. HTTPS è il trasporto principale usato a scopo di interoperabilità sicura. HTTPS è supportato da Windows Communication Foundation (WCF) per garantire l'interoperabilità con altri stack di servizi Web.

Vedere anche

  • Last updated on