<httpTransport>

  • [アーティクル]

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

configuration
  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"
               realm="String"
               transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
               unsafeConnectionNtlmAuthentication="Boolean"
               useDefaultWebProxy="Boolean" />

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

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

この属性はクッキーを使用する ASMX Web サービスと対話する場合に使用できます。 この方法で、サーバーから返されるクッキーを、それ以降のサービスに対するすべてのクライアント要求に自動的にコピーできます。
authenticationScheme HTTP リスナーにより処理されているクライアント要求の認証に使用するプロトコルを指定します。 有効な値は次のとおりです。

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

既定は Anonymous です。 この属性は AuthenticationSchemes 型です。 この属性は 1 回だけ設定できます。
bypassProxyOnLocal ローカル アドレスでプロキシ サーバーをバイパスするかどうかを示すブール値。 既定値は、false です。

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

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

クライアントが同じマシン上のサービスと対話するときにプロキシを経由させる場合は、localhost ではなくホスト名を使用する必要があります。
hostnameComparisonMode URI の解析に使用する HTTP ホスト名比較モードを指定します。 有効な値は次のとおりです。

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

この属性は HostNameComparisonMode 型です。 既定では、 StrongWildcardです。
keepAliveEnabled インターネット リソースへの永続的な接続を行うかどうかを示すブール値。
maxBufferSize バッファーの最大サイズを指定する正の整数です。 既定値は 524288 です
proxyAddress HTTP プロキシのアドレスを指定する URI。 useSystemWebProxy が true の場合、この設定を null にする必要があります。 既定では、 nullです。
proxyAuthenticationScheme HTTP プロキシにより処理されているクライアント要求の認証に使用するプロトコルを指定します。 有効な値は次のとおりです。

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

既定は Anonymous です。 この属性は AuthenticationSchemes 型です。 AuthenticationSchemes.IntegratedWindowsAuthentication はサポートされていないことにご注意ください。
realm プロキシおよびサーバーで使用するレルムを指定する文字列です。 既定値は空の文字列です。

サーバーは、レルムを使用して、保護されたリソースをパーティションに分割します。 パーティションごとに、独自の認証方式と承認データベースの両方、またはそのいずれかを指定できます。 レルムは、基本認証およびダイジェスト認証だけに使用されます。 クライアントが正常に認証されると、その認証は特定のレルムのすべてのリソースに対して有効となります。 レルムの詳細については、IETF Web サイトで RFC 2617 をご覧ください。
transferMode メッセージが要求や応答をバッファーするか、ストリーミングするかを指定します。 有効な値は次のとおりです。

- Buffered: 要求メッセージと応答メッセージをバッファーします。
- Streamed: 要求メッセージと応答メッセージをストリーム配信します。
- StreamedRequest: 要求メッセージをストリーム配信し、応答メッセージをバッファーします。
- StreamedResponse: 要求メッセージがバッファリングされ、応答メッセージがストリーム配信されます。

既定値はバッファーです。 この属性は TransferMode 型です。
unsafeConnectionNtlmAuthentication サーバー上で安全ではない接続共有を有効にするかどうかを指定するブール値です。 既定値は、false です。 有効な場合、NTLM 認証は、TCP 接続ごとに 1 回実行されます。
useDefaultWebProxy ユーザー固有の設定ではなく、コンピューター全体のプロキシ設定を使用するかどうかを指定するブール値です。 既定では、 trueです。

子要素

なし

親要素

要素 説明
<binding> カスタム バインドのすべてのバインド機能を定義します。

解説

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

関連項目