Delen via

<httpTransport>

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

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

Syntaxis

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

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.

Dit kenmerk is van het type HostNameComparisonMode. De standaardwaarde is StrongWildcard.
keepAliveEnabled Een Booleaanse waarde die aangeeft of er een permanente verbinding met de internetresource 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 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.
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 httpTransport element is het startpunt 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-webservicesstacks te garanderen.

Zie ook

  • Last updated on