<httpsTransport>

Artikel
04/07/2023

Hiermee geeft u een HTTPS-transport voor het verzenden van SOAP-berichten voor een aangepaste binding.

<Configuratie>
  <system.serviceModel>
    <Bindings>
      <customBinding>
        <Bindend>
          <httpsTransport>

Syntax

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

Kenmerken en elementen

In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven.

Kenmerken

Kenmerk	Beschrijving
allowCookies	Een Booleaanse waarde die aangeeft of de client cookies accepteert en doorgeeft op toekomstige aanvragen. De standaardwaarde is `false`. U kunt dit kenmerk gebruiken wanneer u communiceert met ASMX-webservices die gebruikmaken van cookies. Op deze manier kunt u er zeker van zijn dat de cookies die van de server worden geretourneerd, automatisch worden gekopieerd naar alle toekomstige clientaanvragen voor die service.
authenticationScheme	Hiermee geeft u het protocol op dat wordt gebruikt voor het verifiëren van clientaanvragen die worden verwerkt door een HTTP-listener. Geldige waarden zijn onder andere: - Samenvatting: hiermee geeft u verificatiesamenvatting op. - Onderhandelen: onderhandelt met de client om het verificatieschema te bepalen. Als zowel de client als de server Kerberos ondersteunen, wordt dit gebruikt; anders wordt NTLM gebruikt. - Ntlm: hiermee geeft u NTLM-verificatie op. - Basic: hiermee geeft u basisverificatie op. - Anoniem: hiermee geeft u anonieme verificatie op. De standaardwaarde is Anoniem. Dit kenmerk is van het type AuthenticationSchemes. Dit kenmerk kan slechts eenmaal worden ingesteld.
bypassProxyOnLocal	Een Booleaanse waarde die aangeeft of de proxyserver voor lokale adressen moet worden overgeslagen. De standaardwaarde is `false`. Een lokaal adres is een adres dat zich in het lokale LAN of intranet bevindt. Windows Communication Foundation (WCF) negeert de proxy altijd als het serviceadres begint met `http://localhost`. U moet de hostnaam in plaats van localhost gebruiken als u wilt dat clients via een proxy gaan wanneer ze met services op dezelfde computer praten.
hostnaamComparisonMode	Hiermee geeft u de http-hostnaamvergelijkingsmodus op die wordt gebruikt voor het parseren van URI's. Geldige waarden zijn, - StrongWildcard: ("+") komt overeen met alle mogelijke hostnamen in de context van het opgegeven schema, de poort en de relatieve URI. - Exact: geen jokertekens - WeakWildcard: ("*") komt overeen met alle mogelijke hostnaam in de context van het opgegeven schema, poort en relatieve UIR die niet expliciet zijn vergeleken of via het sterke jokertekenmechanisme. De standaardwaarde is StrongWildcard. Dit kenmerk is van het type `System.ServiceModel.HostnameComparison`.
manualAddressing	Een Booleaanse waarde waarmee de gebruiker de controle over berichtadressering kan overnemen. Deze eigenschap wordt meestal gebruikt in routerscenario's, waarbij de toepassing bepaalt naar welke van de verschillende bestemmingen een bericht moet worden verzonden. Als dit is ingesteld op `true`, wordt ervan uitgegaan dat het bericht al is geadresseerd en wordt er geen aanvullende informatie aan toegevoegd. De gebruiker kan vervolgens elk bericht afzonderlijk beantwoorden. Als dit is ingesteld op `false`, maakt het standaardadresseringsmechanisme van Windows Communication Foundation (WCF) automatisch adressen voor alle berichten. De standaardwaarde is `false`.
maxBufferPoolSize	Een positief geheel getal dat de maximale grootte van de buffergroep aangeeft. De standaardwaarde is 524288. Veel onderdelen van WCF gebruiken buffers. Het maken en vernietigen van buffers elke keer dat ze worden gebruikt, is duur en garbagecollection voor buffers is ook duur. Met bufferpools kunt u een buffer uit de pool nemen, deze gebruiken en teruggaan naar de pool wanneer u klaar bent. Zo wordt de overhead bij het maken en vernietigen van buffers vermeden.
Maxbuffersize	Een positief geheel getal dat de maximale grootte van de buffer aangeeft. De standaardwaarde is 524288
maxReceivedMessageSize	Een positief geheel getal dat de maximaal toegestane berichtgrootte aangeeft die kan worden ontvangen. De standaardwaarde is 65536.
proxyAddress	Een URI die het adres van de HTTP-proxy aangeeft. Als `useSystemWebProxy` is `true`, moet deze instelling zijn `null`. De standaardwaarde is `null`.
proxyAuthenticationScheme	Hiermee geeft u het protocol op dat wordt gebruikt voor het verifiëren van clientaanvragen die worden verwerkt door een HTTP-proxy. Geldige waarden zijn onder andere: - Geen: er wordt geen verificatie uitgevoerd. - Samenvatting: hiermee geeft u verificatiesamenvatting op. - Onderhandelen: onderhandelt met de client om het verificatieschema te bepalen. Als zowel de client als de server Kerberos ondersteunen, wordt dit gebruikt; anders wordt NTLM gebruikt. - Ntlm: hiermee geeft u NTLM-verificatie op. - Basic: hiermee geeft u basisverificatie op. - Anoniem: hiermee geeft u anonieme verificatie op. De standaardwaarde is Anoniem. Dit kenmerk is van het type AuthenticationSchemes. Houd er rekening mee dat AuthenticationSchemes.IntegratedWindowsAuthentication niet wordt ondersteund.
Realm	Een tekenreeks die de realm aangeeft die moet worden gebruikt op de proxy/server. De standaardwaarde is een lege tekenreeks. Servers gebruiken realms om beveiligde resources te partitioneren. Elke partitie kan een eigen verificatieschema en/of autorisatiedatabase hebben. Realms worden alleen gebruikt voor basis- en digest-verificatie. Nadat een client is geverifieerd, is de verificatie geldig voor alle resources in een bepaalde realm. Zie RFC 2617 op de IETF-website voor een gedetailleerde beschrijving van realms.
requireClientCertificate	Een Booleaanse waarde die aangeeft of de server vereist dat de client een clientcertificaat opgeeft als onderdeel van de HTTPS-handshake. De standaardwaarde is `false`.
transferMode	Hiermee geeft u op of berichten worden gebufferd of gestreamd, of een aanvraag of antwoord. Geldige waarden zijn onder andere: - Gebufferd: de aanvraag- en antwoordberichten worden gebufferd. - Gestreamd: de aanvraag- en antwoordberichten worden gestreamd. - StreamedRequest: het aanvraagbericht wordt gestreamd en het antwoordbericht wordt gebufferd. - StreamedResponse: het aanvraagbericht wordt gebufferd en het antwoordbericht wordt gestreamd. De standaardwaarde is Buffered. Dit kenmerk is van het type TransferMode.
unsafeConnectionNtlmAuthentication	Een Booleaanse waarde die aangeeft of Onveilig delen van verbindingen is ingeschakeld op de server. De standaardwaarde is `false`. Als deze optie is ingeschakeld, wordt NTLM-verificatie eenmaal uitgevoerd op elke TCP-verbinding.
useDefaultWebProxy	Een Booleaanse waarde die aangeeft of de proxy-instellingen voor de hele machine worden gebruikt in plaats van de gebruikersspecifieke instellingen. De standaardwaarde is `true`.

Onderliggende elementen

Geen.

Bovenliggende elementen

Element	Beschrijving
<Bindend>	Definieert alle bindingsmogelijkheden van de aangepaste binding.

Opmerkingen

Het httpsTransport -element is het uitgangspunt voor het maken van een aangepaste binding waarmee het HTTPS-transportprotocol wordt geïmplementeerd. HTTPS is het primaire transport dat wordt gebruikt voor veilige interoperabiliteitsdoeleinden. HTTPS wordt ondersteund door de Windows Communication Foundation (WCF) om interoperabiliteit met andere webservicestacks te garanderen.

Delen via