Delen via

<httpsTransport>

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

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

Syntaxis

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

Attributes

Attribute Description
allowCookies Een Booleaanse waarde die aangeeft of de client cookies accepteert en deze op toekomstige aanvragen doorgeeft. De standaardwaarde is false.

U kunt dit kenmerk gebruiken wanneer u communiceert met ASMX-webservices die cookies gebruiken. Op deze manier kunt u ervoor zorgen dat de cookies die van de server worden geretourneerd, automatisch worden gekopieerd naar alle toekomstige clientaanvragen voor die service.
authenticatieschema 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:

- Digest: Hiermee geeft u digest-verificatie op.
- Onderhandelen: onderhandelt met de client om het verificatieschema te bepalen. Als zowel client als server Kerberos ondersteunen, wordt deze gebruikt; anders wordt NTLM gebruikt.
- Ntlm: Hiermee geeft u NTLM-verificatie op.
- Basis: 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 op het lokale LAN of intranet bevindt.

Windows Communication Foundation (WCF) negeert altijd de proxy als het serviceadres begint met http://localhost.

Gebruik de hostnaam in plaats van localhost als u wilt dat clients een proxy doorlopen wanneer u met services op dezelfde computer praat.
hostnameComparisonMode Hiermee geeft u de http-hostnaamvergelijkingsmodus op die wordt gebruikt om URI's te parseren. 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, de poort en het relatieve UIR die niet expliciet of via het sterke jokertekenmechanisme zijn vergeleken.

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 deze optie is ingesteld true, wordt ervan uitgegaan dat het bericht al is geadresseerd en er geen aanvullende informatie aan wordt toegevoegd. De gebruiker kan vervolgens elk bericht afzonderlijk adressen.

Als dit is ingesteld falseop, maakt het standaard WCF-adresseringsmechanisme (Windows Communication Foundation) 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 maken gebruik van buffers. Het maken en vernietigen van buffers telkens wanneer ze worden gebruikt, is duur en garbagecollection voor buffers is ook duur. Met buffergroepen kunt u een buffer uit de pool nemen, deze gebruiken en teruggaan naar de pool zodra u klaar bent. De overhead bij het maken en vernietigen van buffers wordt dus 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 dat het 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.
- Digest: Hiermee geeft u digest-verificatie op.
- Onderhandelen: onderhandelt met de client om het verificatieschema te bepalen. Als zowel client als server Kerberos ondersteunen, wordt deze gebruikt; anders wordt NTLM gebruikt.
- Ntlm: Hiermee geeft u NTLM-verificatie op.
- Basis: 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 dit niet wordt ondersteund.
gebied Een tekenreeks die aangeeft welke realm 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 Gebufferd. Dit kenmerk is van het type TransferMode.
onveiligConnectionNtlmAuthentication Een Booleaanse waarde die aangeeft of onveilig delen van verbindingen is ingeschakeld op de server. De standaardwaarde is false. Indien 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.

Kind-elementen

Geen.

Bovenliggende elementen

Onderdeel Description
<bindend> Definieert alle bindingsmogelijkheden van de aangepaste binding.

Opmerkingen

Het httpsTransport element is het startpunt 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 wcf (Windows Communication Foundation) om interoperabiliteit met andere webservicesstacks te garanderen.

Zie ook

  • Last updated on