<httpsTransport>

Artykuł
04/07/2023

Określa transport HTTPS do przesyłania komunikatów SOAP dla powiązania niestandardowego.

<Konfiguracji>
  <System.servicemodel>
    <Powiązania>
      <Custombinding>
        <Wiązania>
          <httpsTransport>

Składnia

<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" />

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut	Opis
allowCookies	Wartość logiczna określająca, czy klient akceptuje pliki cookie i propaguje je na przyszłych żądaniach. Wartość domyślna to `false`. Tego atrybutu można używać podczas interakcji z usługami sieci Web ASMX korzystającymi z plików cookie. W ten sposób można mieć pewność, że pliki cookie zwrócone z serwera są automatycznie kopiowane do wszystkich przyszłych żądań klientów dla tej usługi.
authenticationScheme	Określa protokół używany do uwierzytelniania żądań klientów przetwarzanych przez odbiornik HTTP. Prawidłowe wartości obejmują następujące wartości: - Szyfruj: określa uwierzytelnianie szyfrowe. - Negocjuj: negocjuje z klientem, aby określić schemat uwierzytelniania. Jeśli zarówno klient, jak i serwer obsługują protokół Kerberos, jest używany; w przeciwnym razie jest używany protokół NTLM. - Ntlm: określa uwierzytelnianie NTLM. - Podstawowe: określa uwierzytelnianie podstawowe. - Anonimowy: określa uwierzytelnianie anonimowe. Wartość domyślna to Anonimowe. Ten atrybut jest typu AuthenticationSchemes. Ten atrybut można ustawić tylko raz.
Bypassproxyonlocal	Wartość logiczna wskazująca, czy pominąć serwer proxy dla adresów lokalnych. Wartość domyślna to `false`. Adres lokalny to adres lokalny, który znajduje się w lokalnej sieci LAN lub intranecie. Program Windows Communication Foundation (WCF) zawsze ignoruje serwer proxy, jeśli adres usługi zaczyna się od `http://localhost`. Należy użyć nazwy hosta, a nie hosta lokalnego, jeśli chcesz, aby klienci przechodzili przez serwer proxy podczas rozmowy z usługami na tym samym komputerze.
Hostnamecomparisonmode	Określa tryb porównania nazwy hosta HTTP używany do analizowania identyfikatorów URI. Prawidłowe wartości to, - StrongWildcard: ("+") pasuje do wszystkich możliwych nazw hostów w kontekście określonego schematu, portu i względnego identyfikatora URI. - Dokładne: brak symboli wieloznacznych - WeakWildcard: ("*") pasuje do wszystkich możliwych nazw hostów w kontekście określonego schematu, portu i względnego identyfikatora UIR, które nie zostały dopasowane jawnie lub za pomocą silnego mechanizmu symboli wieloznacznych. Wartość domyślna to StrongWildcard. Ten atrybut jest typu `System.ServiceModel.HostnameComparison`.
Manualaddressing	Wartość logiczna, która umożliwia użytkownikowi przejęcie kontroli nad adresowanie komunikatów. Ta właściwość jest zwykle używana w scenariuszach routera, w których aplikacja określa, do którego z kilku miejsc docelowych ma być wysyłany komunikat. Po ustawieniu `true`wartości kanał zakłada, że komunikat został już rozwiązany i nie dodaje do niego żadnych dodatkowych informacji. Użytkownik może następnie indywidualnie adresować każdą wiadomość. W przypadku ustawienia wartości `false`domyślny mechanizm adresowania Windows Communication Foundation (WCF) automatycznie tworzy adresy dla wszystkich komunikatów. Wartość domyślna to `false`.
Maxbufferpoolsize	Dodatnia liczba całkowita określająca maksymalny rozmiar puli buforów. Wartość domyślna to 524288. Wiele części programu WCF używa buforów. Tworzenie i niszczenie buforów za każdym razem, gdy są używane, jest kosztowne, a odzyskiwanie pamięci dla buforów jest również kosztowne. W przypadku pul buforów można pobrać bufor z puli, użyć jej i powrócić do puli po zakończeniu. W związku z tym unika się obciążeń związanych z tworzeniem i niszczeniem buforów.
Maxbuffersize	Dodatnia liczba całkowita określająca maksymalny rozmiar buforu. Wartość domyślna to 524288
Maxreceivedmessagesize	Dodatnia liczba całkowita określająca maksymalny dozwolony rozmiar komunikatu, który można odebrać. Wartość domyślna to 65536.
Proxyaddress	Identyfikator URI określający adres serwera proxy HTTP. Jeśli `useSystemWebProxy` ma `true`wartość , to ustawienie musi mieć wartość `null`. Wartość domyślna to `null`.
proxyAuthenticationScheme	Określa protokół używany do uwierzytelniania żądań klientów przetwarzanych przez serwer proxy HTTP. Prawidłowe wartości obejmują następujące wartości: - Brak: nie jest wykonywane uwierzytelnianie. - Szyfruj: określa uwierzytelnianie szyfrowe. - Negocjuj: negocjuje z klientem, aby określić schemat uwierzytelniania. Jeśli zarówno klient, jak i serwer obsługują protokół Kerberos, jest używany; w przeciwnym razie jest używany protokół NTLM. - Ntlm: określa uwierzytelnianie NTLM. - Podstawowe: określa uwierzytelnianie podstawowe. - Anonimowy: określa uwierzytelnianie anonimowe. Wartość domyślna to Anonimowe. Ten atrybut jest typu AuthenticationSchemes. Należy pamiętać, że AuthenticationSchemes.IntegratedWindowsAuthentication nie jest to obsługiwane.
Obszaru	Ciąg określający obszar do użycia na serwerze proxy/serwerze. Wartość domyślna to pusty ciąg. Serwery używają obszaru do partycjonowania chronionych zasobów. Każda partycja może mieć własny schemat uwierzytelniania i/lub bazę danych autoryzacji. Obszary są używane tylko do uwierzytelniania podstawowego i szyfrowego. Po pomyślnym uwierzytelnieniu klienta uwierzytelnianie jest prawidłowe dla wszystkich zasobów w danym obszarze. Aby uzyskać szczegółowy opis obszaru, zobacz RFC 2617 w witrynie internetowej IETF.
requireClientCertificate	Wartość logiczna określająca, czy serwer wymaga od klienta podania certyfikatu klienta w ramach uzgadniania HTTPS. Wartość domyślna to `false`.
Transfermode	Określa, czy komunikaty są buforowane, przesyłane strumieniowo, czy żądanie lub odpowiedź. Prawidłowe wartości obejmują następujące wartości: - Buforowane: komunikaty żądania i odpowiedzi są buforowane. — Przesyłane strumieniowo: komunikaty żądania i odpowiedzi są przesyłane strumieniowo. - StreamedRequest: komunikat żądania jest przesyłany strumieniowo, a komunikat odpowiedzi jest buforowany. - StreamedResponse: komunikat żądania jest buforowany, a komunikat odpowiedzi jest przesyłany strumieniowo. Wartość domyślna to Buforowane. Ten atrybut jest typu TransferMode.
unsafeConnectionNtlmAuthentication	Wartość logiczna określająca, czy na serwerze jest włączone udostępnianie niebezpiecznego połączenia. Wartość domyślna to `false`. Jeśli to ustawienie jest włączone, uwierzytelnianie NTLM jest wykonywane raz na każdym połączeniu TCP.
useDefaultWebProxy	Wartość logiczna określająca, czy ustawienia serwera proxy dla całego komputera są używane, a nie ustawienia specyficzne dla użytkownika. Wartość domyślna to `true`.

Elementy podrzędne

Brak.

Elementy nadrzędne

Element	Opis
<Wiązania>	Definiuje wszystkie możliwości powiązania niestandardowego.

Uwagi

Element httpsTransport jest punktem wyjścia do utworzenia powiązania niestandardowego, które implementuje protokół transportowy HTTPS. PROTOKÓŁ HTTPS to podstawowy transport używany do celów bezpiecznego współdziałania. Protokół HTTPS jest obsługiwany przez program Windows Communication Foundation (WCF) w celu zapewnienia współdziałania z innymi stosami usług sieci Web.

Udostępnij za pośrednictwem