Roles クラス

定義

public ref class Roles abstract sealed

public static class Roles

type Roles = class

Public Class Roles

継承

Object

Roles

例

次の例は、ASP.NET メンバーシップと ASP.NET ロールの両方を使用し、 を使用 SqlRoleProvider してメンバーシップとロール情報を SQL Server データベースに格納するように構成されたアプリケーションの Web.config ファイルを示しています。 ユーザーはフォーム認証で認証され、Administrators ロールのユーザーのみがアプリケーションへのアクセスを許可されます。

<configuration>
  <connectionStrings>
    <add name="SqlServices" connectionString="Data Source=localhost;Initial Catalog=aspnetdb;Integrated Security=SSPI;" />
  </connectionStrings>

  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="login.aspx"
      name=".ASPXFORMSAUTH" />
    </authentication>

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

    <membership defaultProvider="AspNetSqlProvider" userIsOnlineTimeWindow="15">
    </membership>

    <roleManager defaultProvider="SqlProvider"
      enabled="true"
      cacheRolesInCookie="true"
      cookieName=".ASPROLES"
      cookieTimeout="30"
      cookiePath="/"
      cookieRequireSSL="true"
      cookieSlidingExpiration="true"
      cookieProtection="All" >

      <providers>
        <clear />
        <add
          name="SqlProvider"
          type="System.Web.Security.SqlRoleProvider"
          connectionStringName="SqlServices"
          applicationName="SampleApplication" />
        </providers>

    </roleManager>
  </system.web>
</configuration>

次のコード例では、ログオンしているユーザーが管理者ロールに属しているかどうかをプログラムで確認してから、ユーザーに他のユーザーのロールの表示を許可します。

注釈

ASP.NET ロール管理を使用すると、ロールと呼ばれるユーザーのグループに基づいて、アプリケーションの承認を管理できます。 ユーザーをロールに割り当てることで、ユーザー名に基づいて承認を指定する代わりに、ロールに基づいて Web アプリケーションのさまざまなパーツまたは機能へのアクセスを制御できます。 たとえば、従業員アプリケーションには、マネージャー、従業員、取締役などのロールがあり、各ロールに異なる特権が指定されている場合があります。

ユーザーは複数のロールに属する場合があります。 たとえば、サイトがディスカッション フォーラムの場合、一部のユーザーがメンバーとモデレーターの両方の役割を果たす可能性があります。 サイトで異なる特権を持つ各ロールを定義し、両方のロールに含まれるユーザーは両方の権限セットを持つ場合があります。

ASP.NET アプリケーションのロール管理を有効にするには、次の例に示すように、アプリケーションの system.web Web.config ファイルの セクションの roleManager 要素を使用します。

<configuration>
  <connectionStrings>
    <add name="SqlServices" connectionString="Data Source=localhost;Initial Catalog=aspnetdb;Integrated Security=SSPI;" />
  </connectionStrings>

  <system.web>
    <authentication mode="Forms" >
      <forms loginUrl="login.aspx"
      name=".ASPXFORMSAUTH" />
    </authentication>

  <roleManager defaultProvider="SqlProvider"
    enabled="true"
    cacheRolesInCookie="true"
    cookieName=".ASPROLES"
    cookieTimeout="30"
    cookiePath="/"
    cookieRequireSSL="false"
    cookieSlidingExpiration="true"
    cookieProtection="All" >
    <providers>
      <add
        name="SqlProvider"
        type="System.Web.Security.SqlRoleProvider"
        connectionStringName="SqlServices"
        applicationName="SampleApplication" />
      </providers>
    </roleManager>
  </system.web>
</configuration>

承認規則は、Web アプリケーションの構成ファイルで指定することも、コードでプログラムで指定することもできます。 たとえば、Web.config ファイルの次の 承認 セクションでは、(匿名ユーザーを拒否することによって) ユーザーがログオンし、Administrators ロールのユーザーのみがアクセスできるようにする必要があります。

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

アプリケーションの authorization Web.config ファイルの セクションを使用してロールに基づいて承認を指定する場合、アプリケーションのユーザーは認証されたユーザー ID を指定する必要があります。 ユーザーは、Windows 認証またはフォーム認証を使用して認証できます。 匿名ユーザーをロールに割り当てることはできません。 ロールは、ASP.NET Membership クラスとは独立して、または組み合わせて使用できます。

プログラムでロール メンバーシップを確認するには、 メソッドで RolesIsUserInRole クラスまたは プロパティをPage.User使用するか、 メソッドで プロパティをPage.UserIPrincipal.IsInRole使用できます。 プログラムによってロールのメンバーシップを確認するサンプル コードについては、このトピックの「例」セクションを参照してください。

Rolesクラスを使用すると、ロールを作成および削除したり、ロールにユーザーを追加したり、ロールからユーザーを削除したりすることもできます。

ロール情報は、複数のデータ ソースに格納できます。

• クラスを WindowsTokenRoleProvider 使用すると、Windows グループのメンバーシップに基づいてロール情報を取得できます。

• クラスを使用して、SQL Server データベースにロール情報を SqlRoleProvider 格納できます。

• 既存のロール情報がある場合、またはにロール情報を格納し、Windows、承認ストア、または SQL Server 以外のデータ ソースからロール情報を取得する場合は、抽象クラスを継承するクラスを作成することで、カスタム ロール プロバイダーを RoleProvider 実装できます。 詳細については、「 ロール プロバイダーの実装」を参照してください。

ユーザーのブラウザーが Cookie を受け入れる場合は、そのユーザーのロール情報をユーザーのコンピューターの Cookie に格納できます。 各ページ要求で、ASP.NET は Cookie からそのユーザーのロール情報を読み取ります。 これにより、ロール情報を取得するためにデータ ソースとの通信量を減らすことで、アプリケーションのパフォーマンスを向上させることができます。 ユーザーのロール情報が Cookie に格納するには長すぎる場合、ASP.NET は Cookie に最後に使用したロール情報のみを格納し、必要に応じてデータ ソース内の追加のロール情報を検索します。 ユーザーのブラウザーが Cookie をサポートしていない場合、または Cookie が無効になっている場合、ロール情報は Cookie にキャッシュされません。

ASP.NET ロールを構成するときに プロパティを指定 CookieProtectionValue することで、Cookie にキャッシュされるロール名の信頼性を向上させることができます。 既定値 CookieProtectionValue は です All。Cookie 内のロール名を暗号化し、Cookie の内容が変更されていないことを検証します。

プロパティ

メソッド

適用対象

こちらもご覧ください

• ロール管理 ASP.NET 理解する