Dela via

<httpsTransport>

Anger en HTTPS-transport för överföring av SOAP-meddelanden för en anpassad bindning.

<configuration>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <binding>
          <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" />

Attribut och element

I följande avsnitt beskrivs attribut, underordnade element och överordnade element.

Attributes

Attribute Description
allowCookies Ett booleskt värde som anger om klienten accepterar cookies och sprider dem på framtida begäranden. Standardvärdet är false.

Du kan använda det här attributet när du interagerar med ASMX-webbtjänster som använder cookies. På så sätt kan du vara säker på att de cookies som returneras från servern automatiskt kopieras till alla framtida klientbegäranden för den tjänsten.
autentiseringsschema Anger det protokoll som används för att autentisera klientbegäranden som bearbetas av en HTTP-lyssnare. Giltiga värden innehåller följande:

– Sammanfattad: Anger sammanfattad autentisering.
– Förhandla: Förhandlar med klienten för att fastställa autentiseringsschemat. Om både klient och server stöder Kerberos används det. annars används NTLM.
– Ntlm: Anger NTLM-autentisering.
– Grundläggande: Anger grundläggande autentisering.
– Anonym: Anger anonym autentisering.

Standardvärdet är Anonym. Det här attributet är av typen AuthenticationSchemes. Det här attributet kan bara anges en gång.
bypassProxyOnLocal Ett booleskt värde som anger om proxyservern ska kringgås för lokala adresser. Standardvärdet är false.

En lokal adress är en adress som finns på det lokala LAN-nätverket eller intranätet.

Windows Communication Foundation (WCF) ignorerar alltid proxyn om tjänstadressen börjar med http://localhost.

Du bör använda värdnamnet i stället för localhost om du vill att klienter ska gå igenom en proxy när de pratar med tjänster på samma dator.
hostnameComparisonMode Anger det HTTP-värdnamnsjämförelseläge som används för att parsa URI:er. Giltiga värden är,

– StrongWildcard: ("+") matchar alla möjliga värdnamn i kontexten för det angivna schemat, porten och den relativa URI:n.
- Exakt: inga jokertecken
– WeakWildcard: ("*") matchar alla möjliga värdnamn i kontexten för det angivna schemat, porten och relativa UIR som inte uttryckligen har matchats eller via den starka jokerteckenmekanismen.

Standardvärdet är StrongWildcard. Det här attributet är av typen System.ServiceModel.HostnameComparison.
Manualaddressing Ett booleskt värde som gör att användaren kan ta kontroll över meddelande adressering. Den här egenskapen används vanligtvis i routerscenarier, där programmet avgör vilken av flera mål som ett meddelande ska skickas till.

När det är inställt på förutsätter kanalen att truemeddelandet redan har åtgärdats och lägger inte till någon ytterligare information i det. Användaren kan sedan adressera varje meddelande individuellt.

När inställningen är inställd falsepå skapar standardlösningsmekanismen för Windows Communication Foundation (WCF) automatiskt adresser för alla meddelanden.

Standardvärdet är false.
maxBufferPoolSize Ett positivt heltal som anger den maximala storleken på buffertpoolen. Standardvärdet är 524288.

Många delar av WCF använder buffertar. Att skapa och förstöra buffertar varje gång de används är dyrt, och skräpinsamling för buffertar är också dyrt. Med buffertpooler kan du ta en buffert från poolen, använda den och returnera den till poolen när du är klar. Därmed undviks kostnaderna för att skapa och förstöra buffertar.
maxBufferSize Ett positivt heltal som anger buffertens maximala storlek. Standardvärdet är 524288
maxReceivedMessageSize Ett positivt heltal som anger den maximala tillåtna meddelandestorleken som kan tas emot. Standardvärdet är 65536.
proxyAddress En URI som anger adressen till HTTP-proxyn. Om useSystemWebProxy är truemåste den här inställningen vara null. Standardvärdet är null.
proxyAuthenticationScheme Anger det protokoll som används för att autentisera klientbegäranden som bearbetas av en HTTP-proxy. Giltiga värden innehåller följande:

– Ingen: Ingen autentisering utförs.
– Sammanfattad: Anger sammanfattad autentisering.
– Förhandla: Förhandlar med klienten för att fastställa autentiseringsschemat. Om både klient och server stöder Kerberos används det. annars används NTLM.
– Ntlm: Anger NTLM-autentisering.
– Grundläggande: Anger grundläggande autentisering.
– Anonym: Anger anonym autentisering.

Standardvärdet är Anonym. Det här attributet är av typen AuthenticationSchemes. Observera att det AuthenticationSchemes.IntegratedWindowsAuthentication inte stöds.
domän En sträng som anger sfären som ska användas på proxyn/servern. Standardvärdet är en tom sträng.

Servrar använder sfärer för att partitionering av skyddade resurser. Varje partition kan ha ett eget autentiseringsschema och/eller en auktoriseringsdatabas. Sfärer används endast för grundläggande och sammanfattad autentisering. När en klient har autentiserats är autentiseringen giltig för alla resurser i en viss sfär. En detaljerad beskrivning av sfärer finns i RFC 2617 på IETF:s webbplats.
requireClientCertificate Ett booleskt värde som anger om servern kräver att klienten tillhandahåller ett klientcertifikat som en del av HTTPS-handskakningen. Standardvärdet är false.
transferMode Anger om meddelanden buffrats eller strömmats eller en begäran eller ett svar. Giltiga värden innehåller följande:

– Buffrad: Begärande- och svarsmeddelandena buffrade.
– Strömmad: Begärande- och svarsmeddelandena strömmas.
– StreamedRequest: Begärandemeddelandet strömmas och svarsmeddelandet buffrad.
– StreamedResponse: Begärandemeddelandet buffrades och svarsmeddelandet strömmas.

Standardvärdet är Buffrat. Det här attributet är av typen TransferMode.
unsafeConnectionNtlmAuthentication Ett booleskt värde som anger om osäker anslutningsdelning är aktiverat på servern. Standardvärdet är false. Om det är aktiverat utförs NTLM-autentisering en gång på varje TCP-anslutning.
useDefaultWebProxy Ett booleskt värde som anger om de datoromfattande proxyinställningarna används i stället för de användarspecifika inställningarna. Standardvärdet är true.

Underordnade element

Ingen.

Överordnade element

Komponent Description
<bindande> Definierar alla bindningsfunktioner i den anpassade bindningen.

Anmärkningar

Elementet httpsTransport är startpunkten för att skapa en anpassad bindning som implementerar HTTPS-transportprotokollet. HTTPS är den primära transporten som används för säker samverkan. HTTPS stöds av Windows Communication Foundation (WCF) för att säkerställa samverkan med andra webbtjänststackar.

Se även

  • Last updated on