HttpListener.UnsafeConnectionNtlmAuthentication プロパティ

.NET Framework クラス ライブラリ リファレンス

HttpListener.UnsafeConnectionNtlmAuthentication プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

NTLM が使用されているときに、同じ TCP (Transmission Control Protocol) 接続を使用した別の要求を認証する必要があるかどうかを制御する Boolean 値を取得または設定します。

名前空間: System.Net
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Property UnsafeConnectionNtlmAuthentication
 As Boolean

Visual Basic (使用法)

Dim instance As HttpListener
Dim value As Boolean

value = instance.UnsafeConnectionNtlmAuthentication

instance.UnsafeConnectionNtlmAuthentication = value

C#

public bool UnsafeConnectionNtlmAuthentication
 { get; set; }

C++

public:
property bool UnsafeConnectionNtlmAuthentication {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_UnsafeConnectionNtlmAuthentication ()

/** @property */
public void set_UnsafeConnectionNtlmAuthentication
 (boolean value)

JScript

public function get UnsafeConnectionNtlmAuthentication
 () : boolean

public function set UnsafeConnectionNtlmAuthentication
 (value : boolean)

プロパティ値
最初の要求の IIdentity が同じ接続で行われる後続の要求に使用される場合は true。それ以外の場合は false。既定値は false です。

例外

例外の種類	条件
ObjectDisposedException	このオブジェクトは閉じられています。

解説

このプロパティが true に設定されていて、特定の TCP 接続経由の最初の要求が NTLM を使用して認証されている場合、同じ TCP 接続上の後続の要求は、最初の要求の認証情報 (IIdentity) を使用して処理されます。

NTLM が認証プロトコルではない場合、このプロパティは無効です。認証プロトコルとしてネゴシエートが指定されている場合、このプロパティは、NTLM が認証に使用される実際のプロトコルである場合にだけ有効です。

メモ
このプロパティを true に設定すると、HttpListener が追加の NTLM 認証チャレンジを送信しないためパフォーマンスが向上しますが、すべての要求に認証情報の提供を要求しないというセキュリティ リスクが存在します。パフォーマンスの向上がリスクよりも重要であるかどうかを判断する必要があります。

使用例

このプロパティを設定するコード例を次に示します。

C#

public static void SimpleListenerWithUnsafeAuthentication(string[]
 prefixes)
{
    // URI prefixes are required,
    // for example "http://contoso.com:8080/index/".
    if (prefixes == null || prefixes.Length
 == 0)
      throw new ArgumentException("prefixes");
    // Set up a listener.
    HttpListener listener = new HttpListener();
    foreach (string s in
 prefixes)
    {
        listener.Prefixes.Add(s);
    }
    listener.Start();
    // Specify Negotiate as the authentication scheme.
    listener.AuthenticationSchemes = AuthenticationSchemes.Negotiate;
    // If NTLM is used, we will allow multiple requests on the same
    // connection to use the authentication information of first request.
    // This improves performance but does reduce the security of your
 
    // application. 
    listener.UnsafeConnectionNtlmAuthentication = true;
    // This listener does not want to receive exceptions 
    // that occur when sending the response to the client.
    listener.IgnoreWriteExceptions = true;
    Console.WriteLine("Listening...");
    // ... process requests here.

    listener.Close();
}

プラットフォーム

Windows 98, Windows Server 2003, Windows XP Media Center Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
HttpListener クラス
HttpListener メンバ
System.Net 名前空間