ClaimsIdentity ClaimsIdentity ClaimsIdentity ClaimsIdentity Class

定義

クレームベース ID を表します。Represents a claims-based identity.

public ref class ClaimsIdentity : System::Security::Principal::IIdentity
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class ClaimsIdentity : System.Security.Principal.IIdentity
type ClaimsIdentity = class
    interface IIdentity
Public Class ClaimsIdentity
Implements IIdentity
継承
ClaimsIdentityClaimsIdentityClaimsIdentityClaimsIdentity
属性
実装

注釈

ClaimsIdentityクラスは、クレームベースの id (クレームのコレクションによって記述される id) の具象実装です。The ClaimsIdentity class is a concrete implementation of a claims-based identity; that is, an identity described by a collection of claims. クレームは、発行者によって作成されたエンティティに関するステートメントで、そのエンティティのプロパティ、権限、またはその他の品質を記述します。A claim is a statement about an entity made by an issuer that describes a property, right, or some other quality of that entity. このようなエンティティは、要求のサブジェクトであると言われます。Such an entity is said to be the subject of the claim. クレームは、 Claimクラスによって表されます。A claim is represented by the Claim class. に含まれているClaimsIdentityクレームは、対応する id が表すエンティティを記述し、承認と認証の決定に使用できます。The claims contained in a ClaimsIdentity describe the entity that the corresponding identity represents, and can be used to make authorization and authentication decisions. 信頼性情報ベースのアクセスモデルには、ロールのみに依存する従来のアクセスモデルよりも多くの利点があります。A claims-based access model has many advantages over more traditional access models that rely exclusively on roles. たとえば、クレームは、それが表す id に関する豊富な情報を提供し、さらに具体的な方法で承認または認証のために評価することができます。For example, claims can provide much richer information about the identity they represent and can be evaluated for authorization or authentication in a far more specific manner.

.NET Framework 4.5 以降では、Windows Identity Foundation (WIF) とクレームベースの id が .NET Framework に完全に統合されています。Beginning with .NET Framework 4.5, Windows Identity Foundation (WIF) and claims-based identity have been fully integrated into the .NET Framework. つまり、.NET Framework 内の id を表すクラスの多くは、クレームのClaimsIdentityコレクションを通じてから派生し、そのプロパティを記述するようになりました。This means that many classes that represent an identity in the .NET Framework now derive from ClaimsIdentity and describe their properties through a collection of claims. これは .NET Framework の以前のバージョンとは異なり、これらのクラスはインターフェイスをIIdentity直接実装しています。This is different from previous versions of the .NET Framework, in which, these classes implemented the IIdentity interface directly. Id を記述するクレームのコレクションは、プロパティをClaims使用してアクセスできます。The collection of claims that describe the identity can be accessed through the Claims property. クラスClaimsIdentityには、要求を検索および変更し、統合言語クエリ (LINQ) を完全にサポートするためのメソッドがいくつか用意されています。The ClaimsIdentity class provides several methods for finding and modifying claims and fully supports language integrated queries (LINQ). アプリケーションコードClaimsIdentityでは、オブジェクトは通常、 ClaimsPrincipalオブジェクトを介してアクセスされます。 Thread.CurrentPrincipalたとえば、によって返されるプリンシパルなどです。In application code, ClaimsIdentity objects are typically accessed through ClaimsPrincipal objects; for example, the principal returned by Thread.CurrentPrincipal.

注意

クラスClaimsPrincipalにもClaimsプロパティがあります。The ClaimsPrincipal class has a Claims property as well. ほとんどの場合、コレクションをClaimsPrincipal.Claims Claims使用するのではなく、コレクションを通じてユーザーの要求にアクセスする必要があります。In the majority of cases you should access the user's claims through the ClaimsPrincipal.Claims collection rather than through the Claims collection. 個人ClaimsIdentityの要求にアクセスする必要があるのは、プリンシパルに複数のプリンシパルが含まれてClaimsIdentityいて、特定の id を評価または変更する必要がある場合のみです。You will need to access the claims of an individual ClaimsIdentity only in the cases where the principal contains more than one ClaimsIdentity and you need to evaluate or modify a specific identity.

重要

コレクションに対してClaims要求を追加または削除するには、呼び出し元に完全信頼が必要です。To add or remove claims from the Claims collection, a caller must have full trust.

クレームベースモデルIIdentity.Nameでは、プロパティIPrincipal.IsInRole(String)とメソッドは、id に含まれるクレームを評価することによって実装されます。In the claims-based model, the IIdentity.Name property and the IPrincipal.IsInRole(String) method are implemented by evaluating the claims contained by an identity. クレームベースのモデルの基本実装は、 ClaimsIdentity.NameプロパティClaimsPrincipal.IsInRoleとメソッドによって提供されます。The base implementations in the claims-based model are provided by the ClaimsIdentity.Name property and the ClaimsPrincipal.IsInRole method. プロパティNameClaimTypeRoleClaimTypeプロパティを使用すると、これらの操作を実行するときに、id に含まれる要求を評価するために使用する要求の種類を指定できます。The NameClaimType and RoleClaimType properties enable you to specify a claim type that should be used to evaluate the claims contained by the identity when performing these operations.

委任のシナリオは、 ActorプロパティとBootstrapContextプロパティを使用してサポートされます。Delegation scenarios are supported through the Actor and BootstrapContext properties.

コンストラクター

ClaimsIdentity() ClaimsIdentity() ClaimsIdentity() ClaimsIdentity()

空のクレーム コレクションを使用して、ClaimsIdentity クラスの新しいインスタンスを初期化します。Initializes a new instance of the ClaimsIdentity class with an empty claims collection.

ClaimsIdentity(BinaryReader) ClaimsIdentity(BinaryReader) ClaimsIdentity(BinaryReader) ClaimsIdentity(BinaryReader)

BinaryReader を指定して、ClaimsIdentity のインスタンスを初期化します。Initializes an instance of ClaimsIdentity with the specified BinaryReader.

ClaimsIdentity(ClaimsIdentity) ClaimsIdentity(ClaimsIdentity) ClaimsIdentity(ClaimsIdentity) ClaimsIdentity(ClaimsIdentity)

既存の ClaimsIdentity インスタンスを使用して ClaimsIdentity クラスの新しいインスタンスを初期化します。Initializes a new instance of the ClaimsIdentity class from an existing ClaimsIdentity instance.

ClaimsIdentity(IEnumerable<Claim>) ClaimsIdentity(IEnumerable<Claim>) ClaimsIdentity(IEnumerable<Claim>) ClaimsIdentity(IEnumerable<Claim>)

ClaimsIdentity オブジェクトの列挙された配列を使用して、Claim クラスの新しいインスタンスを初期化します。Initializes a new instance of the ClaimsIdentity class using an enumerated collection of Claim objects.

ClaimsIdentity(IEnumerable<Claim>, String) ClaimsIdentity(IEnumerable<Claim>, String) ClaimsIdentity(IEnumerable<Claim>, String) ClaimsIdentity(IEnumerable<Claim>, String)

指定したクレームと認証の種類を使用して ClaimsIdentity クラスの新しいインスタンスを初期化します。Initializes a new instance of the ClaimsIdentity class with the specified claims and authentication type.

ClaimsIdentity(IEnumerable<Claim>, String, String, String) ClaimsIdentity(IEnumerable<Claim>, String, String, String) ClaimsIdentity(IEnumerable<Claim>, String, String, String) ClaimsIdentity(IEnumerable<Claim>, String, String, String)

指定したクレーム、認証の種類、名前クレームの種類、およびロール クレームの種類を使用して、ClaimsIdentity クラスの新しいインスタンスを初期化します。Initializes a new instance of the ClaimsIdentity class with the specified claims, authentication type, name claim type, and role claim type.

ClaimsIdentity(IIdentity) ClaimsIdentity(IIdentity) ClaimsIdentity(IIdentity) ClaimsIdentity(IIdentity)

指定した ClaimsIdentity の名前と認証の種類を使用して IIdentity クラスの新しいインスタンスを初期化します。Initializes a new instance of the ClaimsIdentity class using the name and authentication type from the specified IIdentity.

ClaimsIdentity(IIdentity, IEnumerable<Claim>) ClaimsIdentity(IIdentity, IEnumerable<Claim>) ClaimsIdentity(IIdentity, IEnumerable<Claim>) ClaimsIdentity(IIdentity, IEnumerable<Claim>)

指定したクレームと指定した ClaimsIdentity を使用して IIdentity クラスの新しいインスタンスを初期化します。Initializes a new instance of the ClaimsIdentity class using the specified claims and the specified IIdentity.

ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String) ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String) ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String) ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String)

指定したクレーム、認証の種類、名前クレームの種類、およびロール クレームの種類を使用して、指定した ClaimsIdentity から IIdentity クラスの新しいインスタンスを初期化します。Initializes a new instance of the ClaimsIdentity class from the specified IIdentity using the specified claims, authentication type, name claim type, and role claim type.

ClaimsIdentity(SerializationInfo) ClaimsIdentity(SerializationInfo) ClaimsIdentity(SerializationInfo) ClaimsIdentity(SerializationInfo)

ClaimsIdentity を使用して作成したシリアル化ストリームから ISerializable クラスの新しいインスタンスを初期化します。Initializes a new instance of the ClaimsIdentity class from a serialized stream created by using ISerializable.

ClaimsIdentity(SerializationInfo, StreamingContext) ClaimsIdentity(SerializationInfo, StreamingContext) ClaimsIdentity(SerializationInfo, StreamingContext) ClaimsIdentity(SerializationInfo, StreamingContext)

ClaimsIdentity を使用して作成したシリアル化ストリームから ISerializable クラスの新しいインスタンスを初期化します。Initializes a new instance of the ClaimsIdentity class from a serialized stream created by using ISerializable.

ClaimsIdentity(String) ClaimsIdentity(String) ClaimsIdentity(String) ClaimsIdentity(String)

空のクレームのコレクションと指定した認証の種類で ClaimsIdentity クラスの新しいインスタンスを初期化します。Initializes a new instance of the ClaimsIdentity class with an empty claims collection and the specified authentication type.

ClaimsIdentity(String, String, String) ClaimsIdentity(String, String, String) ClaimsIdentity(String, String, String) ClaimsIdentity(String, String, String)

指定した認証の種類、名前クレームの種類、およびロール クレームの種類を使用して、ClaimsIdentity クラスの新しいインスタンスを初期化します。Initializes a new instance of the ClaimsIdentity class with the specified authentication type, name claim type, and role claim type.

フィールド

DefaultIssuer DefaultIssuer DefaultIssuer DefaultIssuer

既定の発行者 “LOCAL AUTHORITY”。The default issuer; "LOCAL AUTHORITY".

DefaultNameClaimType DefaultNameClaimType DefaultNameClaimType DefaultNameClaimType

既定の名前クレームの種類、NameThe default name claim type; Name.

DefaultRoleClaimType DefaultRoleClaimType DefaultRoleClaimType DefaultRoleClaimType

既定のロール クレームの種類、RoleThe default role claim type; Role.

プロパティ

Actor Actor Actor Actor

デリゲート権限が付与された呼び出しパーティの ID を取得または設定します。Gets or sets the identity of the calling party that was granted delegation rights.

AuthenticationType AuthenticationType AuthenticationType AuthenticationType

認証の種類を取得します。Gets the authentication type.

BootstrapContext BootstrapContext BootstrapContext BootstrapContext

このクレーム ID を作成するために使用されたトークンを取得または設定します。Gets or sets the token that was used to create this claims identity.

Claims Claims Claims Claims

このクレーム ID に関連付けられているクレームを取得します。Gets the claims associated with this claims identity.

CustomSerializationData CustomSerializationData CustomSerializationData CustomSerializationData

派生型によって提供される追加データが含まれています。Contains any additional data provided by a derived type. 通常、WriteTo(BinaryWriter, Byte[]) の呼び出し時に設定されます。Typically set when calling WriteTo(BinaryWriter, Byte[]).

IsAuthenticated IsAuthenticated IsAuthenticated IsAuthenticated

ID が認証されているかどうかを示す値を取得します。Gets a value that indicates whether the identity has been authenticated.

Label Label Label Label

このクレーム識別子のラベルを取得または設定します。Gets or sets the label for this claims identity.

Name Name Name Name

このクレーム ID の名前を取得します。Gets the name of this claims identity.

NameClaimType NameClaimType NameClaimType NameClaimType

このクレーム ID の Name プロパティにどのクレームが値を提供するかを判断するために使用されるクレームの種類を取得します。Gets the claim type that is used to determine which claims provide the value for the Name property of this claims identity.

RoleClaimType RoleClaimType RoleClaimType RoleClaimType

このクレーム ID のクレームのうちで .NET Framework のロールとして解釈されるクレームの種類を取得します。Gets the claim type that will be interpreted as a .NET Framework role among the claims in this claims identity.

メソッド

AddClaim(Claim) AddClaim(Claim) AddClaim(Claim) AddClaim(Claim)

このクレーム ID に単一のクレームを追加します。Adds a single claim to this claims identity.

AddClaims(IEnumerable<Claim>) AddClaims(IEnumerable<Claim>) AddClaims(IEnumerable<Claim>) AddClaims(IEnumerable<Claim>)

このクレーム ID にクレームの一覧を追加します。Adds a list of claims to this claims identity.

Clone() Clone() Clone() Clone()

このクレーム ID からコピーした新しい ClaimsIdentity を返します。Returns a new ClaimsIdentity copied from this claims identity.

CreateClaim(BinaryReader) CreateClaim(BinaryReader) CreateClaim(BinaryReader) CreateClaim(BinaryReader)

カスタム Claim を作成する拡張ポイントを派生型に提供します。Provides an extensibility point for derived types to create a custom Claim.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindAll(Predicate<Claim>) FindAll(Predicate<Claim>) FindAll(Predicate<Claim>) FindAll(Predicate<Claim>)

指定した述語に一致するすべてのクレームを取得します。Retrieves all of the claims that are matched by the specified predicate.

FindAll(String) FindAll(String) FindAll(String) FindAll(String)

指定されたクレーム型のすべてのクレームを取得します。Retrieves all of the claims that have the specified claim type.

FindFirst(Predicate<Claim>) FindFirst(Predicate<Claim>) FindFirst(Predicate<Claim>) FindFirst(Predicate<Claim>)

指定した述語に一致する最初のクレームを取得します。Retrieves the first claim that is matched by the specified predicate.

FindFirst(String) FindFirst(String) FindFirst(String) FindFirst(String)

指定したクレームの種類の最初のクレームを取得します。Retrieves the first claim with the specified claim type.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

SerializationInfo オブジェクトに、現在の ClaimsIdentity オブジェクトをシリアル化するために必要なデータを格納します。Populates the SerializationInfo with data needed to serialize the current ClaimsIdentity object.

GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
HasClaim(Predicate<Claim>) HasClaim(Predicate<Claim>) HasClaim(Predicate<Claim>) HasClaim(Predicate<Claim>)

指定した述語に一致するクレーム ID がこのクレーム ID に含まれるかどうかを判断します。Determines whether this claims identity has a claim that is matched by the specified predicate.

HasClaim(String, String) HasClaim(String, String) HasClaim(String, String) HasClaim(String, String)

指定したクレームの種類と値を持つクレームがこのクレーム ID に含まれるかどうかを判断します。Determines whether this claims identity has a claim with the specified claim type and value.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
RemoveClaim(Claim) RemoveClaim(Claim) RemoveClaim(Claim) RemoveClaim(Claim)

クレーム ID からクレームを削除します。Attempts to remove a claim from the claims identity.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)
TryRemoveClaim(Claim) TryRemoveClaim(Claim) TryRemoveClaim(Claim) TryRemoveClaim(Claim)

クレーム ID からクレームを削除します。Attempts to remove a claim from the claims identity.

WriteTo(BinaryWriter) WriteTo(BinaryWriter) WriteTo(BinaryWriter) WriteTo(BinaryWriter)

BinaryWriter を使用してシリアル化します。Serializes using a BinaryWriter.

WriteTo(BinaryWriter, Byte[]) WriteTo(BinaryWriter, Byte[]) WriteTo(BinaryWriter, Byte[]) WriteTo(BinaryWriter, Byte[])

BinaryWriter を使用してシリアル化します。Serializes using a BinaryWriter.

適用対象

こちらもご覧ください