WindowsTokenRoleProvider クラス

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

WindowsTokenRoleProvider クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

Windows グループ メンバシップから ASP.NET アプリケーションのロール情報を取得します。

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

Visual Basic (宣言)

Public Class WindowsTokenRoleProvider
    Inherits RoleProvider

Visual Basic (使用法)

Dim instance As WindowsTokenRoleProvider

C#

public class WindowsTokenRoleProvider : RoleProvider

C++

public ref class WindowsTokenRoleProvider :
 public RoleProvider

J#

public class WindowsTokenRoleProvider extends
 RoleProvider

JScript

public class WindowsTokenRoleProvider extends
 RoleProvider

解説

WindowsTokenRoleProvider クラスは、Windows セキュリティ グループに基づいて Windows ユーザーのロール情報を取得する読み取り専用のロール メンバシップ プロバイダです。このクラスは、IIS 認証の設定によって匿名の認証が無効にされる Windows 認証モードを使用する ASP.NET アプリケーションで特に便利です。特定の Windows グループのユーザーのメンバシップに基づいて、アクセスを許可または拒否するように ASP.NET アプリケーションを構成できます。

WindowsTokenRoleProvider クラスを使用して、Windows グループ メンバシップに基づいたロールの作成または削除、およびロールのメンバシップの変更を実行することはできません。この機能は、Windows オペレーティング システムによって管理されます。WindowsTokenRoleProvider クラスは、RoleProvider 抽象クラスの IsUserInRole メソッドと GetUsersInRole メソッドのみをサポートします。

使用例

ASP.NET アプリケーションの Web.config ファイルの例を次に示します。このファイルは、アプリケーションが Windows 認証と WindowsTokenRoleProvider クラスの両方を使用して Windows ユーザーのロール情報を取得するように指定します。authorization 要素により、BUILTIN\Administrators グループのユーザーのみがアプリケーションにアクセスできるよう指定されます。

<configuration>
  <system.web>
    <authentication mode="Windows" />

    <authorization>
      <allow roles="BUILTIN\Administrators" />
        <deny users="*" />
      </authorization>

    <roleManager defaultProvider="WindowsProvider" 
      enabled="true"
      cacheRolesInCookie="false">
      <providers>
        <add
          name="WindowsProvider"
          type="System.Web.Security.WindowsTokenRoleProvider" />
      </providers>
    </roleManager>

  </system.web>
</configuration>

.NET Framework のセキュリティ

• AspNetHostingPermission  (ホスト環境で WindowsTokenRoleProvider クラスを使用するために必要なアクセス許可)要求値 : LinkDemand。アクセス許可値 : Minimal。

継承階層

System.Object
   System.Configuration.Provider.ProviderBase
     System.Web.Security.RoleProvider
      System.Web.Security.WindowsTokenRoleProvider

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
WindowsTokenRoleProvider メンバ
System.Web.Security 名前空間
その他の技術情報
ロール管理について