<httpTransport>

Artikel
06/08/2023

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

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

Syntax

<httpTransport allowCookies="Boolean"
               authenticationScheme="Digest/Negotiate/Ntlm/Basic/Anonymous"
               bypassProxyOnLocal="Boolean"
               hostnameComparisonMode="StrongWildcard/Exact/WeakWildcard"
               keepAliveEnabled="Boolean"
               maxBufferSize="Integer"
               proxyAddress="Uri"
               proxyAuthenticationScheme="None/Digest/Negotiate/Ntlm/Basic/Anonymous"
               realm="String"
               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 bij 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 om clientaanvragen te verifiëren die worden verwerkt door een HTTP-listener. Geldige waarden zijn onder andere: - Samenvatting: hiermee geeft u verificatiesamenvating op. - Onderhandelen: onderhandelt met de client om het verificatieschema te bepalen. Als zowel client als 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 op het lokale LAN of intranet bevindt. Windows Communication Foundation (WCF) negeert de proxy altijd als het serviceadres begint met `http://localhost`. Gebruik de hostnaam in plaats van localhost als u wilt dat clients via een proxy gaan wanneer u met services op dezelfde computer praat.
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, de poort en de relatieve UIR die niet expliciet zijn vergeleken of via het sterke jokertekenmechanisme. Dit kenmerk is van het type HostNameComparisonMode. De standaardwaarde is StrongWildcard.
keepAliveEnabled	Een Booleaanse waarde die aangeeft of er een permanente verbinding met de internetbron moet worden tot stand gebracht.
Maxbuffersize	Een positief geheel getal dat de maximale grootte van de buffer aangeeft. De standaardwaarde is 524288
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 verificatiesamenvating op. - Onderhandelen: onderhandelt met de client om het verificatieschema te bepalen. Als zowel client als 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 website van IETF voor een gedetailleerde beschrijving van realms.
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 .
unsafeConnectionNtlmAuthentication	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`.

Onderliggende elementen

Geen

Bovenliggende elementen

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

Opmerkingen

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

Delen via