<přenos http>

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

<Konfigurace>
  <System.servicemodel>
    <Vazby>
      <vlastní vazby>
        <Vazba>
          <přenos http>

Syntax

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

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.

Tento atribut je typu HostNameComparisonMode. Výchozí formát je StrongWildcard.
keepAliveEnabled Logická hodnota, která určuje, jestli se má vytvořit trvalé připojení k internetovému prostředku.
Maxbuffersize Kladné celé číslo, které určuje maximální velikost vyrovnávací paměti. Výchozí hodnota je 524288
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.
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 httpTransport je výchozím bodem pro vytvoření vlastní vazby, která implementuje přenosový protokol HTTP. HTTP je primární přenos používaný pro účely interoperability. Tento přenos podporuje Windows Communication Foundation (WCF), aby se zajistila interoperabilita s dalšími zásobníky webových služeb, které nejsou WCF.

Viz také