<httpsTransport>

  • [アーティクル]

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

configuration
  system.serviceModel
    <bindings>
      <customBinding>
        <binding>
          <httpsTransport>

構文

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

属性および要素

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

属性

属性 説明
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 のコンテキストで存在するすべてのホスト名に一致します。

既定値は StrongWildcard です。 この属性は System.ServiceModel.HostnameComparison 型です。
manualAddressing ユーザーによるメッセージのアドレス指定の管理を有効にするブール値です。 このプロパティは、通常、アプリケーションが複数の宛先のどれにメッセージを送信するかを決定するルーターのシナリオで使用されます。

true に設定されている場合、チャネルではメッセージが既にアドレス指定されていると見なされ、他の情報は追加されません。 この場合、ユーザーはすべてのメッセージを別個にアドレス指定できます。

false に設定されている場合、既定の Windows Communication Foundation (WCF) アドレス指定機構により、すべてのメッセージのアドレスが自動的に作成されます。

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

WCF の多くの部分でバッファーが使用されます。 使用するたびに毎回バッファーを作成および破壊すると負荷が高くなります。バッファーのガベージ コレクションも同様です。 バッファー プールを使用すると、バッファーをプールから取得して使用し、作業が終わったらプールに戻すことができます。 これで、バッファーの作成と破棄のオーバーヘッドを回避できます。
maxBufferSize バッファーの最大サイズを指定する正の整数です。 既定値は 524288 です
maxReceivedMessageSize 受信できるメッセージの最大サイズを指定する正の整数。 既定値は 65536 です。
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 をご覧ください。
requireClientCertificate サーバーがクライアントに HTTPS ハンドシェイクの一部としてクライアント証明書の提供を要求するかどうかを指定するブール値。 既定では、 falseです。
transferMode メッセージが要求や応答をバッファーするか、ストリーミングするかを指定します。 有効な値は次のとおりです。

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

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

子要素

なし。

親要素

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

解説

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

関連項目