WindowsAuthenticationModule クラスとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

WindowsAuthenticationModule クラス

Windows 認証が有効な場合、ASP.NET アプリケーションに対してユーザーの ID を設定します。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 WindowsAuthenticationModule
    Implements IHttpModule

Visual Basic (使用法)

Dim instance As WindowsAuthenticationModule

public sealed class WindowsAuthenticationModule
 : IHttpModule

C++

public ref class WindowsAuthenticationModule
 sealed : IHttpModule

public final class WindowsAuthenticationModule
 implements IHttpModule

JScript

public final class WindowsAuthenticationModule
 implements IHttpModule

解説

認証 Mode が Windows に設定されている場合、WindowsAuthenticationModule は、現在の HttpContext の User プロパティを、現在の要求に対して IIS が提供した Windows ID を表す IPrincipal オブジェクトに設定します。IIS が匿名認証を使用する場合、WindowsAuthenticationModule は、GetAnonymous メソッドによって返される ID を使用します。

WindowsAuthenticationModule は Authenticate イベントを公開します。このイベントにより、現在の HttpContext の User プロパティにカスタム IPrincipal オブジェクトを設定できます。Authenticate イベントには、ASP.NET アプリケーションの Global.asax ファイルに、WindowsAuthentication_OnAuthenticate というサブルーチンを指定することによってアクセスします。

使用例

WindowsAuthentication_OnAuthenticate イベントを使用して、現在の HttpContext の User プロパティにカスタム IPrincipal オブジェクトを設定するコード例を次に示します。

Visual Basic

Public Sub WindowsAuthentication_OnAuthenticate(sender
 As Object, args As WindowsAuthenticationEventArgs)
  If Not args.Identity.IsAnonymous Then
    args.User = New Samples.AspNet.Security.MyPrincipal(args.Identity)
  End If
End Sub

public void WindowsAuthentication_OnAuthenticate(object
 sender, WindowsAuthenticationEventArgs args)
{
  if (!args.Identity.IsAnonymous)
  {
    args.User = new Samples.AspNet.Security.MyPrincipal(args.Identity);
  }
}

.NET Framework のセキュリティ