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();