Freigeben über

<httpsTransport>

Gibt einen HTTPS-Transport für die Übertragung von SOAP-Nachrichten für eine benutzerdefinierte Bindung an.

<Konfiguration>
   <system.serviceModel>
     <Einbände>
       <Custombinding>
         <verbindlich>
           <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" />

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Merkmal Description
allowCookies Ein boolescher Wert, der angibt, ob der Client Cookies akzeptiert und an zukünftige Anforderungen weitergibt. Der Standardwert lautet false.

Sie können dieses Attribut verwenden, wenn Sie mit ASMX-Webdiensten interagieren, die Cookies verwenden. Auf diese Weise können Sie sicher sein, dass die vom Server zurückgegebenen Cookies automatisch in alle zukünftigen Clientanforderungen für diesen Dienst kopiert werden.
Authentifizierungsschema Gibt das Protokoll an, das zum Authentifizieren von Clientanforderungen verwendet wird, die von einem HTTP-Listener verarbeitet werden. Gültige Werte umfassen Folgendes:

- Digest: Gibt die Digestauthentifizierung an.
- Aushandeln: Verhandelt mit dem Client, um das Authentifizierungsschema zu bestimmen. Wenn sowohl Client als auch Server Kerberos unterstützen, wird sie verwendet; andernfalls wird NTLM verwendet.
- Ntlm: Gibt die NTLM-Authentifizierung an.
- Standard: Gibt die Standardauthentifizierung an.
- Anonym: Gibt die anonyme Authentifizierung an.

Der Standardwert ist "Anonym". Dieses Attribut ist vom Typ AuthenticationSchemes. Dieses Attribut kann nur einmal festgelegt werden.
Bypassproxyonlocal Ein boolescher Wert, der angibt, ob der Proxyserver für lokale Adressen umgangen werden soll. Der Standardwert lautet false.

Eine lokale Adresse ist eine Adresse, die sich im lokalen LAN oder Intranet befindet.

Windows Communication Foundation (WCF) ignoriert immer den Proxy, wenn die Dienstadresse mit http://localhost.

Sie sollten den Hostnamen anstelle von localhost verwenden, wenn Clients einen Proxy durchlaufen sollen, wenn Sie mit Diensten auf demselben Computer sprechen.
hostnameComparisonMode Gibt den Vergleichsmodus des HTTP-Hostnamens an, der zum Analysieren von URIs verwendet wird. Gültige Werte sind:

- StrongWildcard: ("+") gleicht alle möglichen Hostnamen im Kontext des angegebenen Schemas, des Ports und des relativen URI ab.
- Genau: keine Wildcards
- WeakWildcard: ("*") entspricht allen möglichen Hostnamen im Kontext des angegebenen Schemas, portieren und relativen UIR, die nicht explizit oder über den starken Wildcardmechanismus abgeglichen wurden.

Der Standardwert ist StrongWildcard. Dieses Attribut ist vom Typ System.ServiceModel.HostnameComparison.
manualAddressing Ein boolescher Wert, mit dem der Benutzer die Kontrolle über die Nachrichtenadressierung übernehmen kann. Diese Eigenschaft wird in der Regel in Routerszenarien verwendet, in denen die Anwendung bestimmt, an welche von mehreren Zielen eine Nachricht gesendet werden soll.

Wenn dieser Wert festgelegt ist true, geht der Kanal davon aus, dass die Nachricht bereits adressiert wurde, und fügt ihr keine zusätzlichen Informationen hinzu. Der Benutzer kann dann jede Nachricht einzeln adressen.

Bei Festlegung auf false, erstellt der Standardmäßige Windows Communication Foundation (WCF)-Adressierungsmechanismus automatisch Adressen für alle Nachrichten.

Der Standardwert lautet false.
maxBufferPoolSize Eine positive ganze Zahl, die die maximale Größe des Pufferpools angibt. Der Standardwert ist 524288.

Viele Teile von WCF verwenden Puffer. Das Erstellen und Zerstören von Puffern jedes Mal, wenn sie verwendet werden, ist teuer, und die Garbage Collection für Puffer ist ebenfalls teuer. Mit Pufferpools können Sie einen Puffer aus dem Pool übernehmen, ihn verwenden und nach Abschluss an den Pool zurückgeben. So wird der Aufwand beim Erstellen und Zerstören von Puffern vermieden.
maxBufferSize Eine positive ganze Zahl, die die maximale Größe des Puffers angibt. Der Standardwert ist 524288
maxReceivedMessageSize Eine positive ganze Zahl, die die maximal zulässige Nachrichtengröße angibt, die empfangen werden kann. Der Standardwert ist 65536.
proxyAddress Ein URI, der die Adresse des HTTP-Proxys angibt. Ist useSystemWebProxy dies der Fall true, muss diese Einstellung sein null. Der Standardwert lautet null.
proxyAuthenticationScheme Gibt das Protokoll an, das für die Authentifizierung von Clientanforderungen verwendet wird, die von einem HTTP-Proxy verarbeitet werden. Gültige Werte umfassen Folgendes:

- Keine: Es wird keine Authentifizierung ausgeführt.
- Digest: Gibt die Digestauthentifizierung an.
- Aushandeln: Verhandelt mit dem Client, um das Authentifizierungsschema zu bestimmen. Wenn sowohl Client als auch Server Kerberos unterstützen, wird sie verwendet; andernfalls wird NTLM verwendet.
- Ntlm: Gibt die NTLM-Authentifizierung an.
- Standard: Gibt die Standardauthentifizierung an.
- Anonym: Gibt die anonyme Authentifizierung an.

Der Standardwert ist "Anonym". Dieses Attribut ist vom Typ AuthenticationSchemes. Beachten Sie, dass AuthenticationSchemes.IntegratedWindowsAuthentication dies nicht unterstützt wird.
realm Eine Zeichenfolge, die den Bereich angibt, der auf dem Proxy/Server verwendet werden soll. Der Standardwert ist eine leere Zeichenfolge.

Server verwenden Bereiche, um geschützte Ressourcen zu partitionieren. Jede Partition kann über ein eigenes Authentifizierungsschema und/oder eine Autorisierungsdatenbank verfügen. Bereiche werden nur für die Standard- und Digestauthentifizierung verwendet. Nachdem ein Client erfolgreich authentifiziert wurde, ist die Authentifizierung für alle Ressourcen in einem bestimmten Bereich gültig. Eine detaillierte Beschreibung der Bereiche finden Sie unter RFC 2617 auf der IETF-Website.
requireClientCertificate Ein boolescher Wert, der angibt, ob der Client ein Clientzertifikat als Teil des HTTPS-Handshake bereitstellen muss. Der Standardwert lautet false.
transferMode Gibt an, ob Nachrichten gepuffert oder gestreamt oder eine Anforderung oder Antwort sind. Gültige Werte umfassen Folgendes:

- Gepuffert: Die Anforderungs- und Antwortmeldungen werden gepuffert.
- Gestreamt: Die Anforderungs- und Antwortnachrichten werden gestreamt.
- StreamedRequest: Die Anforderungsnachricht wird gestreamt, und die Antwortnachricht wird gepuffert.
- StreamedResponse: Die Anforderungsnachricht wird gepuffert, und die Antwortnachricht wird gestreamt.

Der Standardwert ist "Puffer". Dieses Attribut ist vom Typ TransferMode.
unsafeConnectionNtlmAuthentication Ein boolescher Wert, der angibt, ob die unsichere Verbindungsfreigabe auf dem Server aktiviert ist. Der Standardwert lautet false. Wenn diese Option aktiviert ist, wird die NTLM-Authentifizierung einmal für jede TCP-Verbindung ausgeführt.
useDefaultWebProxy Ein boolescher Wert, der angibt, ob die computerweiten Proxyeinstellungen anstelle der benutzerspezifischen Einstellungen verwendet werden. Der Standardwert lautet true.

Untergeordnete Elemente

Keiner.

Übergeordnete Elemente

Element Description
<verbindlich> Definiert alle Bindungsfunktionen der benutzerdefinierten Bindung.

Bemerkungen

Das httpsTransport Element ist der Ausgangspunkt zum Erstellen einer benutzerdefinierten Bindung, die das HTTPS-Transportprotokoll implementiert. HTTPS ist der primäre Transport, der für sichere Interoperabilitätszwecke verwendet wird. HTTPS wird von der Windows Communication Foundation (WCF) unterstützt, um die Interoperabilität mit anderen Webdienststapeln sicherzustellen.

Siehe auch

  • Last updated on