<Přenos https>

Článek
06/08/2023

Určuje přenos HTTPS pro přenos zpráv SOAP pro vlastní vazbu.

<Konfigurace>
  <System.servicemodel>
    <Vazby>
      <vlastní vazby>
        <Vazba>
          <Přenos https>

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

Atributy a elementy

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Atributy

Atribut	Popis
allowCookies	Logická hodnota, která určuje, jestli klient přijímá soubory cookie a šíří je v budoucích požadavcích. Výchozí formát je `false`. Tento atribut můžete použít při interakci s webovými službami ASMX, které používají soubory cookie. Tímto způsobem si můžete být jistí, že se soubory cookie vrácené ze serveru automaticky zkopírují do všech budoucích požadavků klientů pro tuto službu.
authenticationScheme	Určuje protokol používaný k ověřování požadavků klientů zpracovávaných naslouchacím procesem HTTP. Mezi platné hodnoty patří: - Digest: Určuje ověřování hodnotou hash. - Vyjednat: Vyjedná s klientem o určení schématu ověřování. Pokud klient i server podporují Protokol Kerberos, používá se; jinak se použije protokol NTLM. – Ntlm: Určuje ověřování protokolem NTLM. – Základní: Určuje základní ověřování. - Anonymní: Určuje anonymní ověřování. Výchozí hodnota je Anonymní. Tento atribut je typu AuthenticationSchemes. Tento atribut lze nastavit pouze jednou.
Bypassproxyonlocal	Logická hodnota, která určuje, jestli se má obejít proxy server pro místní adresy. Výchozí formát je `false`. Místní adresa je adresa, která se nachází v místní síti LAN nebo intranetu. Windows Communication Foundation (WCF) proxy server vždy ignoruje, pokud adresa služby začíná na `http://localhost`. Pokud chcete, aby klienti při komunikaci se službami na stejném počítači procházeli proxy serverem, měli byste místo localhost použít název hostitele.
Hostnamecomparisonmode	Určuje režim porovnání názvů hostitelů HTTP, který se použije k parsování identifikátorů URI. Platné hodnoty jsou: – StrongWildcard: ("+") odpovídá všem možným názvům hostitelů v kontextu zadaného schématu, portu a relativního identifikátoru URI. - Přesné: bez zástupných znaků - WeakWildcard: (*) odpovídá všem možným názvům hostitele v kontextu zadaného schématu, portu a relativního identifikátoru UIR, které nebyly spárovány explicitně nebo prostřednictvím mechanismu silného zástupného znaku. Výchozí hodnota je StrongWildcard. Tento atribut je typu `System.ServiceModel.HostnameComparison`.
ruční adresování	Logická hodnota, která uživateli umožňuje převzít kontrolu nad adresování zpráv. Tato vlastnost se obvykle používá ve scénářích směrovačů, kdy aplikace určí, na který z několika cílů se má zpráva odeslat. Pokud je nastavená na `true`, kanál předpokládá, že zpráva už byla vyřešena, a nepřidá k ní žádné další informace. Uživatel pak může adresovat každou zprávu zvlášť. Pokud je nastavená hodnota `false`, výchozí mechanismus adresování WCF (Windows Communication Foundation) automaticky vytvoří adresy pro všechny zprávy. Výchozí formát je `false`.
Maxbufferpoolsize	Kladné celé číslo, které určuje maximální velikost fondu vyrovnávacích pamětí. Výchozí hodnota je 524288. Mnoho částí WCF používá vyrovnávací paměti. Vytváření a ničení vyrovnávacích pamětí při každém jejich použití je nákladné a uvolňování paměti pro vyrovnávací paměti je také nákladné. Pomocí fondů vyrovnávacích pamětí můžete z fondu vzít vyrovnávací paměť, použít ji a po dokončení ji vrátit do fondu. Tím se vyhnete režijní režii při vytváření a ničení vyrovnávacích pamětí.
Maxbuffersize	Kladné celé číslo, které určuje maximální velikost vyrovnávací paměti. Výchozí hodnota je 524288
Maxreceivedmessagesize	Kladné celé číslo, které určuje maximální povolenou velikost zprávy, která může být přijata. Výchozí hodnota je 65536.
Proxyaddress	Identifikátor URI, který určuje adresu proxy serveru HTTP. Pokud `useSystemWebProxy` je `true`, toto nastavení musí být `null`. Výchozí formát je `null`.
proxyAuthenticationScheme	Určuje protokol používaný k ověřování požadavků klientů zpracovávaných proxy serverem HTTP. Mezi platné hodnoty patří: – Žádné: Neprovádí se žádné ověřování. - Digest: Určuje ověřování hodnotou hash. - Vyjednat: Vyjedná s klientem o určení schématu ověřování. Pokud klient i server podporují Protokol Kerberos, používá se; jinak se použije protokol NTLM. – Ntlm: Určuje ověřování protokolem NTLM. – Základní: Určuje základní ověřování. - Anonymní: Určuje anonymní ověřování. Výchozí hodnota je Anonymní. Tento atribut je typu AuthenticationSchemes. Upozorňujeme, že AuthenticationSchemes.IntegratedWindowsAuthentication se nepodporuje.
Sféry	Řetězec, který určuje sféru, která se má použít na proxy serveru nebo serveru. Výchozí hodnota je prázdný řetězec. Servery používají k dělení chráněných prostředků sféry. Každý oddíl může mít vlastní schéma ověřování nebo autorizační databázi. Sféry se používají pouze pro základní ověřování a ověřování hodnotou hash. Po úspěšném ověření klienta je ověřování platné pro všechny prostředky v dané sférě. Podrobný popis sfér najdete v dokumentu RFC 2617 na webu IETF.
requireClientCertificate	Logická hodnota, která určuje, jestli server vyžaduje, aby klient v rámci metody handshake HTTPS poskytl klientský certifikát. Výchozí formát je `false`.
Transfermode	Určuje, jestli se mají zprávy ukládat do vyrovnávací paměti, streamovat nebo jestli se mají vyžadovat nebo odpovědět. Mezi platné hodnoty patří: – Ve vyrovnávací paměti: Zprávy požadavků a odpovědí se ukládají do vyrovnávací paměti. - Streamované: Zprávy požadavků a odpovědí se streamují. – StreamedRequest: Zpráva požadavku se streamuje a odpověď se zasadí do vyrovnávací paměti. – StreamedResponse: Zpráva požadavku je uložena do vyrovnávací paměti a zpráva odpovědi se streamuje. Výchozí hodnota je Uložená do vyrovnávací paměti. Tento atribut je typu TransferMode.
unsafeConnectionNtlmAuthentication	Logická hodnota, která určuje, jestli je na serveru povolené nebezpečné sdílení připojení. Výchozí formát je `false`. Pokud je povoleno, ověřování protokolem NTLM se provádí u každého připojení TCP jednou.
useDefaultWebProxy	Logická hodnota, která určuje, jestli se místo nastavení specifického uživatele použijí nastavení proxy serveru pro celý počítač. Výchozí formát je `true`.

Podřízené elementy

Žádné

Nadřazené elementy

Element	Popis
<Vazba>	Definuje všechny možnosti vazby vlastní vazby.

Poznámky

Element httpsTransport je výchozím bodem pro vytvoření vlastní vazby, která implementuje přenosový protokol HTTPS. HTTPS je primární přenos, který se používá pro účely zabezpečené interoperability. Protokol HTTPS podporuje technologie WCF (Windows Communication Foundation), aby byla zajištěna interoperabilita s dalšími zásobníky webových služeb.

Sdílet prostřednictvím