<httpTransport>

カスタム バインディングの SOAP メッセージを送信する HTTP トランスポートを指定します。

<system.serviceModel>
  <bindings>
    <customBinding>
      <binding>
        <httpTransport>

<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"
IntegratedWindowsAuthentication: Specifies Windows authentication"
    realm="String"
    transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
        unsafeConnectionNtlmAuthentication="Boolean"
        useDefaultWebProxy="Boolean" />

属性および要素

属性

属性 説明

allowCookies

クライアントが Cookie を受け入れて、それらを今後の要求に反映させるかどうかを指定するブール値です。既定値は false です。

この属性は、Cookie を使用する ASMX Web サービスと対話する場合に使用できます。この方法で、サーバーから返される Cookie を、それ以降のサービスに対するすべてのクライアント要求に自動的にコピーできます。

authenticationScheme

HTTP リスナにより処理されているクライアント要求の認証に使用するプロトコルを指定します。有効な値は次のとおりです。

  • Digest: ダイジェスト認証を指定します。
  • Negotiate: クライアントとネゴシエートし、認証方式を決定します。クライアントとサーバーの両方が Kerberos をサポートする場合は、この方式が使用されます。それ以外の場合は NTLM が使用されます。
  • Ntlm: NTLM 認証を指定します。
  • Basic: 基本認証を指定します。
  • Anonymous: 匿名認証を指定します。

既定は Anonymous です。この属性は AuthenticationSchemes 型です。この属性は 1 回だけ設定できます。

bypassProxyOnLocal

ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。既定値は false です。

ローカル アドレスは、ローカル LAN またはイントラネット上にあるアドレスです。

Windows Communication Foundation (WCF) は、サービス アドレスが https://localhost で始まる場合は常にプロキシを無視します。

クライアントが同じマシン上のサービスと対話するときにプロキシを経由させる場合は、localhost ではなくホスト名を使用する必要があります。

hostnameComparisonMode

URI の解析に使用する HTTP ホスト名比較モードを指定します。有効な値は次のとおりです。

  • StrongWildcard: ("+") は、指定されたスキーム、ポート、および相対 URI のコンテキストで存在するすべてのホスト名に一致します。
  • Exact: ワイルドカードなし。
  • WeakWildcard: ("*") は、StrongWildcard ではっきりとは一致しない、指定されたスキーム、ポート、および相対 URI のコンテキストで存在するすべてのホスト名に一致します。

既定値は StrongWildcard です。この属性は HostnameComparisonMode 型です。

keepAliveEnabled

インターネット リソースへの永続的な接続を行うかどうかを示すブール値。

maxBufferSize

バッファの最大サイズを指定する正の整数です。既定値は 524288 です

proxyAddress

HTTP プロキシのアドレスを指定する URI。useSystemWebProxytrue の場合、この設定を null にする必要があります。既定値は null です。

proxyAuthenticationScheme

HTTP プロキシにより処理されているクライアント要求の認証に使用するプロトコルを指定します。有効な値は次のとおりです。

  • None: 認証は実行されません。
  • Digest: ダイジェスト認証を指定します。
  • Negotiate: クライアントとネゴシエートし、認証方式を決定します。クライアントとサーバーの両方が Kerberos をサポートする場合は、この方式が使用されます。それ以外の場合は NTLM が使用されます。
  • Ntlm: NTLM 認証を指定します。
  • Basic: 基本認証を指定します。
  • Anonymous: 匿名認証を指定します。
  • IntegratedWindowsAuthentication: Windows 認証を指定します。

既定は Anonymous です。この属性は AuthenticationSchemes 型です。

レルム

プロキシおよびサーバーで使用するレルムを指定する文字列です。既定値は空の文字列です。

サーバーは、レルムを使用して、保護されたリソースをパーティションに分割します。パーティションごとに、独自の認証方式と承認データベースの両方、またはそのいずれかを指定できます。レルムは、基本認証およびダイジェスト認証だけに使用されます。クライアントが正常に認証されると、その認証は特定のレルムのすべてのリソースに対して有効となります。レルムの詳細については、http://www.ietf.org の RFC 2617 を参照してください。

transferMode

メッセージが要求や応答をバッファするか、ストリーミングするかを指定します。有効な値は次のとおりです。

  • Buffered: 要求メッセージと応答メッセージをバッファします。
  • Streamed: 要求メッセージと応答メッセージをストリーミングします。
  • StreamedRequest: 要求メッセージをストリーミングし、応答メッセージをバッファします。
  • StreamedResponse: 要求メッセージをバッファし、応答メッセージをストリーミングします。

既定値はバッファです。この属性は TransferMode 型です。

unsafeConnectionNtlmAuthentication

サーバー上で安全ではない接続共有を有効にするかどうかを指定するブール値です。既定値は false です。有効な場合、NTLM 認証は、TCP 接続ごとに 1 回実行されます。

useDefaultWebProxy

ユーザー固有の設定ではなく、コンピュータ全体のプロキシ設定を使用するかどうかを指定するブール値です。既定値は true です。

子要素

なし

親要素

要素 説明

<binding>

カスタム バインディングのすべてのバインディング機能を定義します。

解説

httpTransport 要素は、HTTP トランスポート プロトコルを実装するカスタム バインディングを作成する場合の開始点となります。HTTP は、相互運用性のために使用される主要なトランスポートです。Windows Communication Foundation (WCF) は、他の非 WCF Web サービス スタックとの相互運用性を保証するために、このトランスポートをサポートします。

関連項目

リファレンス

<customBinding>
HttpTransportElement
HttpTransportBindingElement
TransportBindingElement
CustomBinding

その他の技術情報

Transports in Windows Communication Foundation
Choosing a Transport
Windows Communication Foundation Bindings
Extending Bindings
Custom Bindings