HttpListener.AuthenticationSchemeSelectorDelegate プロパティ

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

HttpListener.AuthenticationSchemeSelectorDelegate プロパティ

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

クライアントの認証に使用するプロトコルを確認するために呼び出されるデリゲートを取得または設定します。

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

Visual Basic (宣言)

Public Property AuthenticationSchemeSelectorDelegate
 As AuthenticationSchemeSelector

Visual Basic (使用法)

Dim instance As HttpListener
Dim value As AuthenticationSchemeSelector

value = instance.AuthenticationSchemeSelectorDelegate

instance.AuthenticationSchemeSelectorDelegate = value

C#

public AuthenticationSchemeSelector AuthenticationSchemeSelectorDelegate
 { get; set; }

C++

public:
property AuthenticationSchemeSelector^ AuthenticationSchemeSelectorDelegate {
    AuthenticationSchemeSelector^ get ();
    void set (AuthenticationSchemeSelector^
 value);
}

J#

/** @property */
public AuthenticationSchemeSelector get_AuthenticationSchemeSelectorDelegate
 ()

/** @property */
public void set_AuthenticationSchemeSelectorDelegate
 (AuthenticationSchemeSelector value)

JScript

public function get AuthenticationSchemeSelectorDelegate
 () : AuthenticationSchemeSelector

public function set AuthenticationSchemeSelectorDelegate
 (value : AuthenticationSchemeSelector)

プロパティ値
認証プロトコルの選択に使用されるメソッドを呼び出す AuthenticationSchemeSelector デリゲート。既定値は null 参照 (Visual Basic では Nothing) です。

例外

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

解説

メモ
HttpListener の特定のインスタンスで処理されるすべての要求に対して同じ認証プロトコルを使用する場合は、このプロパティを設定する必要はありません。すべてのクライアント要求に対して使用するプロトコルを指定するには、AuthenticationSchemes プロパティを使用します。

クライアントがヘッダーで認証情報を指定していない場合、HttpListener は、未認証の各受信要求について、指定されたデリゲートを呼び出して、クライアントの認証に使用するプロトコル (存在する場合) を決定します。GetContext メソッドおよび EndGetContext メソッドは、HttpListener が正常に要求を認証した場合だけ、受信要求を返します。要求を認証できない場合、HttpListener は、自動的に 401 応答を返します。System.Net.HttpListenerRequest.LogonUserIdentity プロパティを使用して、正常に認証されたクライアントの ID を取得できます。

認証プロトコルの選択をアプリケーション固有のメソッドにデリゲートする機能は、HttpListener のインスタンスに、受信した要求の特性 (要求の Url プロパティや UserHostAddress プロパティなど) に応じて異なる認証プロトコルを使用する場合に便利です。

メモ
このプロパティを設定して Digest、NTLM、または Negotiate を有効にするには、SecurityPermission と ControlPrincipal が必要です。

使用例

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

C#

// Set up a listener.
HttpListener listener = new HttpListener();
HttpListenerPrefixCollection prefixes = listener.Prefixes;
prefixes.Add(@"http://localhost:8080/");
prefixes.Add(@"http://contoso.com:8080/");

// Specify the authentication delegate.
listener.AuthenticationSchemeSelectorDelegate = 
    new AuthenticationSchemeSelector (AuthenticationSchemeForClient);

// Start listening for requests and process them 
// synchronously.
listener.Start();

AuthenticationSchemeSelector デリゲートによって呼び出されるメソッドの実装を提供するコード例を次に示します。

C#

static AuthenticationSchemes AuthenticationSchemeForClient(HttpListenerRequest
 request)
{
    Console.WriteLine("Client authentication protocol selection in
 progress...");
    // Do not authenticate local machine requests.
    if (request.RemoteEndPoint.Address.Equals (IPAddress.Loopback))
    {
        return AuthenticationSchemes.None;
    }
    else
    {
        return AuthenticationSchemes.IntegratedWindowsAuthentication;
    }
}

プラットフォーム

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 名前空間