PrincipalPermissionとは何？わかりやすく解説 Weblio辞書

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

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

PrincipalPermission クラス

宣言セキュリティアクションと強制セキュリティアクションの両方のために定義された言語構成要素を使用して、アクティブプリンシパル (IPrincipal のトピックを参照) をチェックできるようにします。このクラスは継承できません。

名前空間: System.Security.Permissions
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class
 PrincipalPermission
    Implements IPermission, IUnrestrictedPermission, ISecurityEncodable

Visual Basic (使用法)

Dim instance As PrincipalPermission

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public sealed class PrincipalPermission : IPermission,
 IUnrestrictedPermission, ISecurityEncodable

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class PrincipalPermission sealed
 : IPermission, IUnrestrictedPermission, ISecurityEncodable

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public final class PrincipalPermission implements
 IPermission, IUnrestrictedPermission, 
    ISecurityEncodable

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public final class PrincipalPermission implements
 IPermission, IUnrestrictedPermission, 
    ISecurityEncodable

解説

コンストラクタにユーザー名とロールの ID 情報を渡すことにより、PrincipalPermission を使用して、この情報と一致するアクティブプリンシパルの ID を要求できます。

アクティブ IPrincipal および関連付けられた IIdentity と一致するためには、指定した ID とロールの両方が一致する必要があります。null 参照 (Visual Basic では Nothing) ID 文字列を使用する場合は、すべての ID と一致する要求として解釈されます。null 参照 (Visual Basic では Nothing) ロール文字列を使用すると、すべてのロールと一致します。このため、name または role の null 参照 (Visual Basic では Nothing) パラメータを PrincipalPermission に渡すと、すべての IPrincipal の ID とロールに一致します。IIdentity が認証されたエンティティまたは認証されていないエンティティのどちらを表しているかを判断するだけの PrincipalPermission も構築できます。この場合、name と role は無視されます。

その他のほとんどのアクセス許可とは異なり、PrincipalPermission は、CodeAccessPermission を拡張しません。ただし、これは IPermission インターフェイスを実装します。これは、PrincipalPermission が、コードのアクセス許可ではないためです。つまり、このアクセス許可は、実行しているアセンブリの ID に基づいて与えられるものではありません。その代わりに、コードアクセスとコード ID アクセス許可で実行する場合と一貫した方法で、現在のユーザー ID に対して、操作 (Demand、Union、Intersect など) を実行することをコードに許可します。

重要 :
プリンシパルのアクセス許可を要求する前に、現在のアプリケーションドメインのプリンシパルポリシーを列挙値 WindowsPrincipal に設定する必要があります。既定では、プリンシパルポリシーは UnauthenticatedPrincipal に設定されます。プリンシパルポリシーを WindowsPrincipal に設定しないと、プリンシパルのアクセス許可の要求は失敗します。プリンシパルのアクセス許可を要求する前に、次のコードを実行する必要があります。 `AppDomain.CurrentDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal).`

重要 :

プリンシパルのアクセス許可を要求する前に、現在のアプリケーションドメインのプリンシパルポリシーを列挙値 WindowsPrincipal に設定する必要があります。既定では、プリンシパルポリシーは UnauthenticatedPrincipal に設定されます。プリンシパルポリシーを WindowsPrincipal に設定しないと、プリンシパルのアクセス許可の要求は失敗します。プリンシパルのアクセス許可を要求する前に、次のコードを実行する必要があります。

AppDomain.CurrentDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal).

使用例

2 人の異なる管理者権限を持つユーザーを表す 2 つの PrincipalPermission オブジェクトを作成し、2 つの和集合を形成して、要求を行う例を次に示します。Demand は、アクティブな IPrincipal の実装が、マネージャのロールを持つユーザー Bob、またはスーパバイザのロールを持つユーザー Louise のいずれかを表す場合にだけ成功します。

Visual Basic

Dim id1 As String = "Bob"
Dim role1 As String = "Manager"
Dim PrincipalPerm1 As New
 PrincipalPermission(id1, role1)
       
Dim id2 As String = "Louise"
Dim role2 As String = "Supervisor"
Dim PrincipalPerm2 As New
 PrincipalPermission(id2, role2)
       
PrincipalPerm1.Union(PrincipalPerm2).Demand()

String id1 = "Bob";
String role1 = "Manager";
PrincipalPermission PrincipalPerm1 = new PrincipalPermission(id1,
 role1);

String id2 = "Louise";
String role2 = "Supervisor";
PrincipalPermission PrincipalPerm2 = new PrincipalPermission(id2,
 role2);

(PrincipalPerm1.Union(PrincipalPerm2)).Demand();

C++

String^ id1 = "Bob";
String^ role1 = "Manager";
PrincipalPermission^ PrincipalPerm1 = gcnew PrincipalPermission( id1,role1 );

String^ id2 = "Louise";
String^ role2 = "Supervisor";
PrincipalPermission^ PrincipalPerm2 = gcnew PrincipalPermission( id2,role2 );

(PrincipalPerm1->Union( PrincipalPerm2 ))->Demand();

String id1 = "Bob";
String role1 = "Manager";
PrincipalPermission principalPerm1 = new PrincipalPermission(id1
,
    role1);
String id2 = "Louise";
String role2 = "Supervisor";
PrincipalPermission principalPerm2 = new PrincipalPermission(id2
,
    role2);
principalPerm1.Union(principalPerm2).Demand();

継承階層

System.Object
System.Security.Permissions.PrincipalPermission

スレッドセーフ

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

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PrincipalPermission メンバ
System.Security.Permissions 名前空間
PrincipalPermissionAttribute
その他の技術情報
アクセス許可
アクセス許可の要求
プリンシパル

PrincipalPermission コンストラクタ (PermissionState)

PermissionState を指定して、PrincipalPermission クラスの新しいインスタンスを初期化します。

名前空間: System.Security.Permissions
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    state As PermissionState _
)

Visual Basic (使用法)

Dim state As PermissionState

Dim instance As New PrincipalPermission(state)

public PrincipalPermission (
    PermissionState state
)

C++

public:
PrincipalPermission (
    PermissionState state
)

public PrincipalPermission (
    PermissionState state
)

JScript

public function PrincipalPermission (
    state : PermissionState
)

パラメータ

state: PermissionState 値の 1 つ。

例外

例外の種類	条件
ArgumentException	state パラメータが、有効な PermissionState ではありません。

解説

None は、認証されていないプリンシパルだけと一致します。Name は、空の文字列 ("") です。Role と Authenticated は、false にはなりません。Unrestricted は、すべてのプリンシパルと一致します。Name は null 参照 (Visual Basic では Nothing)、Role は null 参照 (Visual Basic では Nothing) です。

メモ
このコンストラクタは、他のアクセス許可の設計との一貫性のために提供されていますが、実際の用途はありません。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PrincipalPermission クラス
PrincipalPermission メンバ
System.Security.Permissions 名前空間

PrincipalPermission コンストラクタ (String, String, Boolean)

指定した name、role と認証ステータスで、PrincipalPermission クラスの新しいインスタンスを初期化します。

名前空間: System.Security.Permissions
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    name As String, _
    role As String, _
    isAuthenticated As Boolean _
)

Visual Basic (使用法)

Dim name As String
Dim role As String
Dim isAuthenticated As Boolean

Dim instance As New PrincipalPermission(name,
 role, isAuthenticated)

public PrincipalPermission (
    string name,
    string role,
    bool isAuthenticated
)

C++

public:
PrincipalPermission (
    String^ name, 
    String^ role, 
    bool isAuthenticated
)

public PrincipalPermission (
    String name, 
    String role, 
    boolean isAuthenticated
)

JScript

public function PrincipalPermission (
    name : String, 
    role : String, 
    isAuthenticated : boolean
)

パラメータ

name: IPrincipal オブジェクトのユーザーの名前。

role: IPrincipal オブジェクトのユーザーのロール。たとえば、管理者。

isAuthenticated: ユーザーが認証されていることを示すには true。それ以外の場合は false。

解説

name パラメータと role パラメータはいずれも、アクティブな IPrincipal および関連付けられた IIdentity と一致するために、このアクセス許可と一致する必要があります。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PrincipalPermission クラス
PrincipalPermission メンバ
System.Security.Permissions 名前空間

PrincipalPermission コンストラクタ

PrincipalPermission クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
PrincipalPermission (PermissionState)	PermissionState を指定して、PrincipalPermission クラスの新しいインスタンスを初期化します。
PrincipalPermission (String, String)	指定した name と role で、PrincipalPermission クラスの新しいインスタンスを初期化します。
PrincipalPermission (String, String, Boolean)	指定した name、role と認証ステータスで、PrincipalPermission クラスの新しいインスタンスを初期化します。

参照

PrincipalPermission コンストラクタ (String, String)

指定した name と role で、PrincipalPermission クラスの新しいインスタンスを初期化します。

名前空間: System.Security.Permissions
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    name As String, _
    role As String _
)

Visual Basic (使用法)

Dim name As String
Dim role As String

Dim instance As New PrincipalPermission(name,
 role)

public PrincipalPermission (
    string name,
    string role
)

C++

public:
PrincipalPermission (
    String^ name, 
    String^ role
)

public PrincipalPermission (
    String name, 
    String role
)

JScript

public function PrincipalPermission (
    name : String, 
    role : String
)

パラメータ

name: IPrincipal オブジェクトのユーザーの名前。

role: IPrincipal オブジェクトのユーザーのロール。たとえば、管理者。

解説

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
PrincipalPermission クラス
PrincipalPermission メンバ
System.Security.Permissions 名前空間

PrincipalPermission メソッド

パブリックメソッドパブリックメソッド

	名前	説明
	Copy	現在のアクセス許可のコピーを作成して返します。
	Demand	現在のプリンシパルが、現在のアクセス許可によって指定されたプリンシパルと一致しているかどうかを実行時に判断します。
	Equals	オーバーロードされます。オーバーライドされます。
	FromXml	XML エンコーディングから、指定した状態のアクセス許可を再構築します。
	GetHashCode	オーバーライドされます。ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適した PrincipalPermission オブジェクトのハッシュコードを取得します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	Intersect	現在のアクセス許可と指定したアクセス許可の積集合を表すアクセス許可を作成して返します。
	IsSubsetOf	現在のアクセス許可が、指定したアクセス許可のサブセットかどうかを判断します。
	IsUnrestricted	現在のアクセス許可が無制限かどうかを示す値を返します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	オーバーライドされます。現在のアクセス許可を表す文字列を作成して返します。
	ToXml	アクセス許可とその現在の状態を表す XML エンコーディングを作成します。
	Union	現在のアクセス許可と指定したアクセス許可の和集合を表すアクセス許可を作成します。

参照

その他の技術情報

アクセス許可
アクセス許可の要求
プリンシパル

PrincipalPermission メンバ

PrincipalPermission データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

	名前	説明
	PrincipalPermission	オーバーロードされます。 PrincipalPermission クラスの新しいインスタンスを初期化します。

パブリックメソッド

	名前	説明
	Copy	現在のアクセス許可のコピーを作成して返します。
	Demand	現在のプリンシパルが、現在のアクセス許可によって指定されたプリンシパルと一致しているかどうかを実行時に判断します。
	Equals	オーバーロードされます。オーバーライドされます。
	FromXml	XML エンコーディングから、指定した状態のアクセス許可を再構築します。
	GetHashCode	オーバーライドされます。ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適した PrincipalPermission オブジェクトのハッシュコードを取得します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	Intersect	現在のアクセス許可と指定したアクセス許可の積集合を表すアクセス許可を作成して返します。
	IsSubsetOf	現在のアクセス許可が、指定したアクセス許可のサブセットかどうかを判断します。
	IsUnrestricted	現在のアクセス許可が無制限かどうかを示す値を返します。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	オーバーライドされます。現在のアクセス許可を表す文字列を作成して返します。
	ToXml	アクセス許可とその現在の状態を表す XML エンコーディングを作成します。
	Union	現在のアクセス許可と指定したアクセス許可の和集合を表すアクセス許可を作成します。