ClaimsIdentity 클래스

정의

클레임 기반 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
상속
ClaimsIdentity
파생
특성
구현

설명

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. Claims 속성을 통해 id를 설명 하는 클레임 컬렉션에 액세스할 수 있습니다.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. 대부분의 경우에는 Claims 컬렉션을 통해서가 아니라 ClaimsPrincipal.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 포함 되어 있고 특정 id를 평가 하거나 수정 해야 하는 경우에만 개별 ClaimsIdentity의 클레임에 액세스 해야 합니다.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.

위임 시나리오는 ActorBootstrapContext 속성을 통해 지원 됩니다.Delegation scenarios are supported through the Actor and BootstrapContext properties.

생성자

ClaimsIdentity()

빈 클레임 컬렉션으로 ClaimsIdentity 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ClaimsIdentity class with an empty claims collection.

ClaimsIdentity(BinaryReader)

지정된 ClaimsIdentity을 사용하여 BinaryReader의 인스턴스를 초기화합니다.Initializes an instance of ClaimsIdentity with the specified BinaryReader.

ClaimsIdentity(ClaimsIdentity)

기존 ClaimsIdentity 인스턴스에서 ClaimsIdentity 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ClaimsIdentity class from an existing ClaimsIdentity instance.

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 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ClaimsIdentity class with the specified claims and authentication type.

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 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ClaimsIdentity class using the name and authentication type from the specified IIdentity.

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 클래스의 새 인스턴스를 초기화합니다.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)

ISerializable을 사용하여 만든 serialize된 스트림으로부터 ClaimsIdentity 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ClaimsIdentity class from a serialized stream created by using ISerializable.

ClaimsIdentity(SerializationInfo, StreamingContext)

ISerializable을 사용하여 만든 serialize된 스트림으로부터 ClaimsIdentity 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ClaimsIdentity class from a serialized stream created by using ISerializable.

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 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the ClaimsIdentity class with the specified authentication type, name claim type, and role claim type.

필드

DefaultIssuer

기본 발급자인 "로컬 인증 기관"입니다.The default issuer; "LOCAL AUTHORITY".

DefaultNameClaimType

기본 이름 클레임 형식은 Name입니다.The default name claim type; Name.

DefaultRoleClaimType

기본 역할 클레임 형식은 Role입니다.The default role claim type; Role.

속성

Actor

위임 권한이 부여된 발신자의 ID를 가져오거나 설정합니다.Gets or sets the identity of the calling party that was granted delegation rights.

AuthenticationType

인증 형식을 가져옵니다.Gets the authentication type.

BootstrapContext

이 클레임 ID를 만드는 데 사용된 토큰을 가져오거나 설정합니다.Gets or sets the token that was used to create this claims identity.

Claims

이 클레임 ID에 연결된 클레임을 가져옵니다.Gets the claims associated with this claims identity.

CustomSerializationData

파생된 형식에서 제공하는 추가 데이터를 포함합니다.Contains any additional data provided by a derived type. 일반적으로 WriteTo(BinaryWriter, Byte[])를 호출할 때 설정합니다.Typically set when calling WriteTo(BinaryWriter, Byte[]).

IsAuthenticated

ID가 인증되었는지 여부를 나타내는 값을 가져옵니다.Gets a value that indicates whether the identity has been authenticated.

Label

이 클레임 ID에 대한 레이블을 가져오거나 설정합니다.Gets or sets the label for this claims identity.

Name

이 클레임 ID의 이름을 가져옵니다.Gets the name of this claims identity.

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

이 클레임 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)

이 클레임 ID에 단일 클레임을 추가합니다.Adds a single claim to this claims identity.

AddClaims(IEnumerable<Claim>)

이 클레임 ID에 클레임 목록을 추가합니다.Adds a list of claims to this claims identity.

Clone()

이 클레임 ID에서 복사한 새 ClaimsIdentity를 반환합니다.Returns a new ClaimsIdentity copied from this claims identity.

CreateClaim(BinaryReader)

사용자 지정 Claim을 만들 파생된 형식에 대한 확장성 지점을 제공합니다.Provides an extensibility point for derived types to create a custom Claim.

Equals(Object)

지정한 개체가 현재 개체와 같은지를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
FindAll(Predicate<Claim>)

지정된 조건자와 일치하는 클레임을 모두 검색합니다.Retrieves all of the claims that are matched by the specified predicate.

FindAll(String)

지정된 클레임 형식이 있는 클레임을 모두 검색합니다.Retrieves all of the claims that have the specified claim type.

FindFirst(Predicate<Claim>)

지정된 조건자와 일치하는 첫 번째 클레임을 검색합니다.Retrieves the first claim that is matched by the specified predicate.

FindFirst(String)

지정된 클레임 형식으로 첫 번째 클레임을 검색합니다.Retrieves the first claim with the specified claim type.

GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetObjectData(SerializationInfo, StreamingContext)

현재 SerializationInfo 개체를 serialize하는 데 필요한 데이터로 ClaimsIdentity를 채웁니다.Populates the SerializationInfo with data needed to serialize the current ClaimsIdentity object.

GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
HasClaim(Predicate<Claim>)

이 클레임에 지정된 조건자와 일치하는 클레임이 있는지 여부를 확인합니다.Determines whether this claims identity has a claim that is matched by the specified predicate.

HasClaim(String, String)

이 클레임 ID에 지정된 클레임 형식 및 값을 가진 클레임이 있는지 여부를 확인합니다.Determines whether this claims identity has a claim with the specified claim type and value.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
RemoveClaim(Claim)

클레임 ID에서 클레임을 제거하려고 시도합니다.Attempts to remove a claim from the claims identity.

ToString()

현재 개체를 나타내는 string을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)
TryRemoveClaim(Claim)

클레임 ID에서 클레임을 제거하려고 시도합니다.Attempts to remove a claim from the claims identity.

WriteTo(BinaryWriter)

BinaryWriter를 사용하여 직렬화합니다.Serializes using a BinaryWriter.

WriteTo(BinaryWriter, Byte[])

BinaryWriter를 사용하여 직렬화합니다.Serializes using a BinaryWriter.

적용 대상

추가 정보