AuthorizationStoreRoleProvider クラス

リファレンス

定義

名前空間:: System.Web.Security

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

承認管理ポリシーストア内での ASP.NET アプリケーションのロールメンバーシップ情報のストレージを管理します。これらの情報は XML ファイル、Active Directory、または Active Directory Application Mode サーバーに格納されます。

public ref class AuthorizationStoreRoleProvider : System::Web::Security::RoleProvider

public class AuthorizationStoreRoleProvider : System.Web.Security.RoleProvider

type AuthorizationStoreRoleProvider = class
    inherit RoleProvider

Public Class AuthorizationStoreRoleProvider
Inherits RoleProvider

継承: Object

ProviderBase

RoleProvider
AuthorizationStoreRoleProvider

例

次のコード例は、ロール管理にを使用 AuthorizationStoreRoleProvider する Web.config ファイルセットを示しています。

<configuration>
  <connectionStrings>
    <add name="AuthorizationServices" connectionString="msxml://~\App_Data\SampleStore.xml" />
  </connectionStrings>

  <system.web>

    <authentication mode="Windows" />
    <identity impersonate="true" />

    <roleManager defaultProvider="AuthorizationStoreRoleProvider"
      enabled="true"
      cacheRolesInCookie="true"
      cookieName=".ASPROLES"
      cookieTimeout="30"
      cookiePath="/"
      cookieRequireSSL="false"
      cookieSlidingExpiration="true"
      cookieProtection="All" >
      <providers>
        <clear />
          <add
            name="AuthorizationStoreRoleProvider"
            type="System.Web.Security.AuthorizationStoreRoleProvider"
            connectionStringName="AuthorizationServices"
            applicationName="SampleApplication"
            cacheRefreshInterval="60"
            scopeName="" />
      </providers>
    </roleManager>

  </system.web>
</configuration>

注釈

このクラスは、クラスと RolePrincipal クラスによって使用されRoles、authorization-manager ストアを使用して ASP.NET アプリケーションのロール管理サービスを提供します。ロール管理を使用して、アプリケーションのさまざまなレベルの承認を指定できます。承認マネージャーには、Microsoft 管理コンソールを使用してアクセスできます。

オブジェクトは AuthorizationStoreRoleProvider 、Windows 認証モードとフォーム認証モードの両方で動作します。

ローカル XML ファイルまたは Active Directory または Active Directory アプリケーションモード (ADAM) サーバーを使用するようにオブジェクトを構成 AuthorizationStoreRoleProvider できます。ローカルファイルを使用する場合、接続文字列は次の例のようになります。

msxml://<path to xml file>

ローカルファイルが ASP.NET Web アプリケーションのディレクトリツリーに格納されている場合は、チルダ ("~") 文字を使用してルートディレクトリを示すことができます。たとえば、ローカルファイルが Web アプリケーションのデータディレクトリに格納されていることを示すには、次の例のような接続文字列を使用します。

msxml://~\App_Data\datafilename.xml

重要

XML データファイルを Web アプリケーションディレクトリに格納することは、潜在的なセキュリティ上の脅威です。既定では、IIS は XML データファイルを Web に提供します。 ASP.NET アプリケーションでローカルデータファイルを使用する場合のセキュリティを向上させるには、データファイルをディレクトリに格納する App_Data 必要があります。ディレクトリに App_Data 格納されているファイルは Web に提供されません。

ポリシーストアに Active Directory または ADAM サーバーを使用している場合、接続文字列は次の例のようになります。

msldap://myserver/CN=MyAzManStore,OU=MyOU,DC=MyDomain,DC=MyDC,DC=Com

オブジェクトメソッドのドキュメント AuthorizationStoreRoleProvider に記載されている例外は、オブジェクトによって AuthorizationStoreRoleProvider 発生する例外です。プロバイダーは基になる Authentication Manager ランタイムに依存しているため、 COMException オブジェクトがメソッド呼び出しを AuthorizationStoreRoleProvider Authentication Manager ランタイムに転送するたびに例外がスローされる場合があります。

重要

オブジェクトには AuthorizationStoreRoleProvider 、部分信頼環境で実行するための次の要件があります。

ASP.NET アプリケーションでファイルベースのポリシーストアを使用する場合、現在の信頼レベルによって付与されるファイル I/O アクセス許可によって、プロバイダーによって読み取りおよび書き込みアクションが許可されるかどうかが決まります。 ASP.NET アプリケーションには、ポリシーストアからデータを読み取るファイルに対する読み取りアクセス許可が必要です。また、新しい情報を保存したり、ポリシーストア内の既存の情報を更新したりするには、書き込みアクセス許可が必要です。既定の中信頼ポリシーファイルは、アプリケーションディレクトリに ASP.NET アプリケーションの読み取り/書き込みアクセス許可を与えます。既定の低信頼ポリシーファイルでは、アプリケーションディレクトリに ASP.NET アプリケーションの読み取りアクセス許可のみが付与されます。さらに、ASP.NET アプリケーションを実行するプロセス ID には、ポリシーファイルの読み取りと書き込みのファイルシステムアクセス許可が必要です。

Active Directory または ADAM サーバーを使用する場合、内部 AuthorizationStoreRoleProvider オブジェクトコードで COM 相互運用機能が使用されるため、ASP.NET アプリケーションにはアンマネージドコードのアクセス許可が必要です。

ASP.NET の外部でオブジェクトを使用 AuthorizationStoreRoleProvider する場合、呼び出し元のコードにはアンマネージコードのアクセス許可が必要です。

コンストラクター

AuthorizationStoreRoleProvider()

AuthorizationStoreRoleProvider クラスの新しいインスタンスを初期化します。

プロパティ

ApplicationName	ロール情報を格納および取得する承認ストアアプリケーションの名前を取得または設定します。
CacheRefreshInterval	ポリシーストアデータのキャッシュのリフレッシュ間隔 (分単位) を取得します。
Description	管理ツールまたは他のユーザーインターフェイス (UI) での表示に適した、簡単でわかりやすい説明を取得します。 (継承元 ProviderBase)
Name	構成時にプロバイダーを参照するために使用される表示名を取得します。 (継承元 ProviderBase)
ScopeName	承認ストアのスコープ名を取得または設定します。

メソッド

AddUsersToRoles(String[], String[])	指定された各ロールに、指定されたユーザー名を追加します。
CreateRole(String)	新しいロールをロール承認マネージャーポリシーストアに追加します。
DeleteRole(String, Boolean)	ロールを承認マネージャーポリシーストアから削除します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
FindUsersInRole(String, String)	このメソッドは、承認ストアロールプロバイダーではサポートされていません。
GetAllRoles()	アプリケーションのすべてのロールのリストを取得します。
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetRolesForUser(String)	ユーザーに割り当てられたロールのリストを取得します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetUsersInRole(String)	指定されたロールに属するユーザーのリストを取得します。
Initialize(String, NameValueCollection)	ASP.NET アプリケーションの構成ファイルに指定されているプロパティ値を使用して、承認マネージャーロールプロバイダーを初期化します。このメソッドはコードから直接使用するためのものではありません。
IsUserInRole(String, String)	指定したユーザーが指定したロールに存在するかどうかを示す値を取得します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
RemoveUsersFromRoles(String[], String[])	指定されたユーザー名を指定されたロールから削除します。
RoleExists(String)	指定されたロール名が承認マネージャーポリシーストアに既に存在するかどうかを示す値を取得します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

適用対象

こちらもご覧ください

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

次の方法で共有