ClaimsIdentity Sınıf

Tanım

Talep tabanlı bir kimliği temsil eder.Represents a claims-based identity.

public ref class ClaimsIdentity : System::Security::Principal::IIdentity
public 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
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type ClaimsIdentity = class
    interface IIdentity
Public Class ClaimsIdentity
Implements IIdentity
Devralma
ClaimsIdentity
Türetilmiş
Öznitelikler
Uygulamalar

Açıklamalar

ClaimsIdentitySınıfı, talep tabanlı kimliğin somut bir uygulamasıdır; diğer bir deyişle, talepler koleksiyonu tarafından tanımlanan bir kimlik.The ClaimsIdentity class is a concrete implementation of a claims-based identity; that is, an identity described by a collection of claims. Talep, bir veren tarafından oluşturulan ve bir özelliği, sağ veya başka bir varlık kalitesini açıklayan bir varlıktır.A claim is a statement about an entity made by an issuer that describes a property, right, or some other quality of that entity. Bu tür bir varlık, talebin konusu olarak kabul edilir.Such an entity is said to be the subject of the claim. Bir talep sınıf tarafından temsil edilir Claim .A claim is represented by the Claim class. İçinde yer alan talepler, ClaimsIdentity karşılık gelen kimliğin temsil ettiği varlığı açıkla ve yetkilendirme ve kimlik doğrulama kararları almak için kullanılabilir.The claims contained in a ClaimsIdentity describe the entity that the corresponding identity represents, and can be used to make authorization and authentication decisions. Talep tabanlı erişim modelinin, özel olarak rollere güvenen daha geleneksel erişim modelleriyle ilgili birçok avantajı vardır.A claims-based access model has many advantages over more traditional access models that rely exclusively on roles. Örneğin, talepler temsil ettikleri kimlik hakkında daha zengin bilgiler sağlayabilir ve çok daha belirli bir şekilde yetkilendirme veya kimlik doğrulama için değerlendirilebilir.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 ' den başlayarak, Windows Identity Foundation (WıF) ve talep tabanlı kimlik .NET Framework ile tamamen tümleşiktir.Beginning with .NET Framework 4.5, Windows Identity Foundation (WIF) and claims-based identity have been fully integrated into the .NET Framework. Bu, .NET Framework bir kimliği temsil eden pek çok sınıfın bundan türeten türetilmiş ClaimsIdentity bir talepler koleksiyonu aracılığıyla özelliklerini tanımladıkları anlamına gelir.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. Bu, bu sınıfların arabirimi doğrudan uyguladığı .NET Framework önceki sürümlerinden farklıdır IIdentity .This is different from previous versions of the .NET Framework, in which, these classes implemented the IIdentity interface directly. Kimliği tanımlayan talepler koleksiyonu, özelliği aracılığıyla erişilebilir Claims .The collection of claims that describe the identity can be accessed through the Claims property. ClaimsIdentitySınıfı, talepleri bulmak ve değiştirmek için çeşitli yöntemler sağlar ve dil ile tümleşik sorguları (LINQ) tam olarak destekler.The ClaimsIdentity class provides several methods for finding and modifying claims and fully supports language integrated queries (LINQ). Uygulama kodunda, ClaimsIdentity nesnelere genellikle nesneler aracılığıyla erişilir ClaimsPrincipal ; Örneğin, tarafından döndürülen asıl Thread.CurrentPrincipal .In application code, ClaimsIdentity objects are typically accessed through ClaimsPrincipal objects; for example, the principal returned by Thread.CurrentPrincipal.

Not

ClaimsPrincipalSınıfın bir Claims özelliği de vardır.The ClaimsPrincipal class has a Claims property as well. Çoğu durumda, koleksiyon aracılığıyla değil, kullanıcının taleplerini koleksiyon aracılığıyla erişmeniz gerekir 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. Bir bireyin ClaimsIdentity yalnızca sorumlunun birden fazla içerdiği durumlarda ClaimsIdentity ve belirli bir kimliği değerlendirmeniz ya da değiştirmeniz gerektiğinde erişmeniz gerekir.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.

Önemli

Koleksiyona talepler eklemek veya bu koleksiyondan talep kaldırmak için Claims , çağıran tam güvene sahip olmalıdır.To add or remove claims from the Claims collection, a caller must have full trust.

Talep tabanlı modelde, IIdentity.Name özelliği ve IPrincipal.IsInRole(String) yöntemi bir kimlik tarafından içerilen talepler hesaplanarak uygulanır.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. Talep tabanlı modeldeki temel uygulamalar, ClaimsIdentity.Name özelliği ve yöntemi tarafından sağlanır ClaimsPrincipal.IsInRole .The base implementations in the claims-based model are provided by the ClaimsIdentity.Name property and the ClaimsPrincipal.IsInRole method. NameClaimTypeVe RoleClaimType Özellikleri, bu işlemleri gerçekleştirirken kimliğin içerdiği talepleri değerlendirmek için kullanılması gereken bir talep türü belirtmenizi sağlar.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.

Yetkilendirme senaryoları ve özellikleri aracılığıyla desteklenir Actor BootstrapContext .Delegation scenarios are supported through the Actor and BootstrapContext properties.

Oluşturucular

ClaimsIdentity()

Boş bir talep koleksiyonuyla sınıfının yeni bir örneğini başlatır ClaimsIdentity .Initializes a new instance of the ClaimsIdentity class with an empty claims collection.

ClaimsIdentity(BinaryReader)

Belirtilen bir örneğini bir örneği başlatır ClaimsIdentity BinaryReader .Initializes an instance of ClaimsIdentity with the specified BinaryReader.

ClaimsIdentity(ClaimsIdentity)

Mevcut bir örnekten sınıfının yeni bir örneğini başlatır ClaimsIdentity ClaimsIdentity .Initializes a new instance of the ClaimsIdentity class from an existing ClaimsIdentity instance.

ClaimsIdentity(IEnumerable<Claim>)

ClaimsIdentityNumaralandırılmış nesne koleksiyonunu kullanarak sınıfının yeni bir örneğini başlatır Claim .Initializes a new instance of the ClaimsIdentity class using an enumerated collection of Claim objects.

ClaimsIdentity(IEnumerable<Claim>, String)

ClaimsIdentityBelirtilen talepler ve kimlik doğrulama türü ile sınıfın yeni bir örneğini başlatır.Initializes a new instance of the ClaimsIdentity class with the specified claims and authentication type.

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

ClaimsIdentityBelirtilen talepler, kimlik doğrulama türü, ad talep türü ve rol talep türü ile sınıfın yeni bir örneğini başlatır.Initializes a new instance of the ClaimsIdentity class with the specified claims, authentication type, name claim type, and role claim type.

ClaimsIdentity(IIdentity)

ClaimsIdentityBelirtilen ad ve kimlik doğrulama türünü kullanarak sınıfının yeni bir örneğini başlatır IIdentity .Initializes a new instance of the ClaimsIdentity class using the name and authentication type from the specified IIdentity.

ClaimsIdentity(IIdentity, IEnumerable<Claim>)

ClaimsIdentityBelirtilen talepler ve belirtilen talepler kullanılarak sınıfın yeni bir örneğini başlatır IIdentity .Initializes a new instance of the ClaimsIdentity class using the specified claims and the specified IIdentity.

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

Belirtilen ClaimsIdentity IIdentity talepler, kimlik doğrulama türü, ad talep türü ve rol talep türü kullanılarak belirtilen sınıftan yeni bir örneğini başlatır.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)

ClaimsIdentityKullanılarak oluşturulan serileştirilmiş bir akıştan sınıfının yeni bir örneğini başlatır ISerializable .Initializes a new instance of the ClaimsIdentity class from a serialized stream created by using ISerializable.

ClaimsIdentity(SerializationInfo, StreamingContext)

ClaimsIdentityKullanılarak oluşturulan serileştirilmiş bir akıştan sınıfının yeni bir örneğini başlatır ISerializable .Initializes a new instance of the ClaimsIdentity class from a serialized stream created by using ISerializable.

ClaimsIdentity(String)

ClaimsIdentityBoş bir talep koleksiyonu ve belirtilen kimlik doğrulama türü ile sınıfın yeni bir örneğini başlatır.Initializes a new instance of the ClaimsIdentity class with an empty claims collection and the specified authentication type.

ClaimsIdentity(String, String, String)

ClaimsIdentityBelirtilen kimlik doğrulama türü, ad talep türü ve rol talep türü ile sınıfın yeni bir örneğini başlatır.Initializes a new instance of the ClaimsIdentity class with the specified authentication type, name claim type, and role claim type.

Alanlar

DefaultIssuer

Varsayılan veren; "YEREL YETKILI".The default issuer; "LOCAL AUTHORITY".

DefaultNameClaimType

Varsayılan ad talep türü; Name.The default name claim type; Name.

DefaultRoleClaimType

Varsayılan rol talep türü; Role.The default role claim type; Role.

Özellikler

Actor

Temsili haklar verilen çağıran tarafın kimliğini alır veya ayarlar.Gets or sets the identity of the calling party that was granted delegation rights.

AuthenticationType

Kimlik doğrulama türünü alır.Gets the authentication type.

BootstrapContext

Bu talep kimliğini oluşturmak için kullanılan belirteci alır veya ayarlar.Gets or sets the token that was used to create this claims identity.

Claims

Bu talep kimliğiyle ilişkili talepleri alır.Gets the claims associated with this claims identity.

CustomSerializationData

Türetilmiş bir tür tarafından belirtilen ek verileri içerir.Contains any additional data provided by a derived type. Genellikle çağrılırken ayarlanır WriteTo(BinaryWriter, Byte[]) .Typically set when calling WriteTo(BinaryWriter, Byte[]).

IsAuthenticated

Kimliğin kimlik doğrulamasının yapılıp yapılmayacağını gösteren bir değer alır.Gets a value that indicates whether the identity has been authenticated.

Label

Bu talep kimliği için etiketi alır veya ayarlar.Gets or sets the label for this claims identity.

Name

Bu talep kimliğinin adını alır.Gets the name of this claims identity.

NameClaimType

Hangi taleplerin Name Bu talep kimliği özelliği için değer sağlamasını belirlemede kullanılan talep türünü alır.Gets the claim type that is used to determine which claims provide the value for the Name property of this claims identity.

RoleClaimType

Bu talep kimliğindeki talepler arasında .NET rolü olarak yorumlanabilecek talep türünü alır.Gets the claim type that will be interpreted as a .NET role among the claims in this claims identity.

Yöntemler

AddClaim(Claim)

Bu talep kimliğine tek bir talep ekler.Adds a single claim to this claims identity.

AddClaims(IEnumerable<Claim>)

Bu talep kimliğine talepler listesi ekler.Adds a list of claims to this claims identity.

Clone()

ClaimsIdentityBu talep kimliğinden kopyalanmış yeni bir değer döndürür.Returns a new ClaimsIdentity copied from this claims identity.

CreateClaim(BinaryReader)

Özel oluşturmak için türetilmiş türler için bir genişletilebilirlik noktası sağlar Claim .Provides an extensibility point for derived types to create a custom Claim.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
FindAll(Predicate<Claim>)

Belirtilen koşul ile eşleşen tüm talepleri alır.Retrieves all of the claims that are matched by the specified predicate.

FindAll(String)

Belirtilen talep türüne sahip tüm talepleri alır.Retrieves all of the claims that have the specified claim type.

FindFirst(Predicate<Claim>)

Belirtilen koşula göre eşleşen ilk talebi alır.Retrieves the first claim that is matched by the specified predicate.

FindFirst(String)

Belirtilen talep türüne sahip ilk talebi alır.Retrieves the first claim with the specified claim type.

GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetObjectData(SerializationInfo, StreamingContext)

SerializationInfoGeçerli nesneyi serileştirmek için gereken verileri ile doldurur ClaimsIdentity .Populates the SerializationInfo with data needed to serialize the current ClaimsIdentity object.

GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
HasClaim(Predicate<Claim>)

Bu talep kimliğinin belirtilen koşula göre eşleşen bir talep olup olmadığını belirler.Determines whether this claims identity has a claim that is matched by the specified predicate.

HasClaim(String, String)

Bu talep kimliğinin belirtilen talep türü ve değeri olan bir talebine sahip olup olmadığını belirler.Determines whether this claims identity has a claim with the specified claim type and value.

MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
RemoveClaim(Claim)

Talep kimliğinden bir talebi kaldırmaya çalışır.Attempts to remove a claim from the claims identity.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)
TryRemoveClaim(Claim)

Talep kimliğinden bir talebi kaldırmaya çalışır.Attempts to remove a claim from the claims identity.

WriteTo(BinaryWriter)

Kullanarak seri hale getirir BinaryWriter .Serializes using a BinaryWriter.

WriteTo(BinaryWriter, Byte[])

Kullanarak seri hale getirir BinaryWriter .Serializes using a BinaryWriter.

Şunlara uygulanır

Ayrıca bkz.