ClaimsIdentity Sınıf

Tanım

Ad Alanı:

System.Security.Claims

Bütünleştirilmiş Kod:

System.Security.Claims.dll

Kaynak:

ClaimsIdentity.cs

Talep tabanlı kimliği temsil eder.

public ref class ClaimsIdentity : System::Security::Principal::IIdentity

public class ClaimsIdentity : System.Security.Principal.IIdentity

type ClaimsIdentity = class
    interface IIdentity

Public Class ClaimsIdentity
Implements IIdentity

Devralma

Object

ClaimsIdentity

Türetilmiş

System.Security.Principal.GenericIdentity

System.Security.Principal.WindowsIdentity

Uygulamalar

IIdentity

Açıklamalar

ClaimsIdentity sınıfı, talep tabanlı kimliğin somut bir uygulamasıdır; yani bir talep koleksiyonu tarafından tanımlanan bir kimliktir. Talep, veren tarafından yapılan ve bu varlığın bir özelliğini, hakkını veya başka bir kalitesini açıklayan varlıkla ilgili bir bildirimdir. Böyle bir varlığın talebin konusu olduğu söylenir. Bir talep sınıfı tarafından Claim temsil edilir. Bir ClaimsIdentity içinde yer alan talepler, ilgili kimliğin temsildiği varlığı açıklar ve yetkilendirme ve kimlik doğrulama kararları almak için kullanılabilir. Talep tabanlı erişim modeli, yalnızca rollere dayanan daha geleneksel erişim modellerine kıyasla birçok avantaja sahiptir. Örneğin, talepler temsil ettikleri kimlik hakkında çok daha zengin bilgiler sağlayabilir ve yetkilendirme veya kimlik doğrulaması için çok daha belirgin bir şekilde değerlendirilebilir.

.NET Framework 4.5 sürümünden başlayarak, Windows Identity Foundation (WIF) ve talep tabanlı kimlik .NET Framework tamamen tümleştirilmiştir. Bu, .NET Framework bir kimliği temsil eden birçok sınıfın artık bir talep koleksiyonu aracılığıyla özelliklerini türetdiği ClaimsIdentity ve tanımladığı anlamına gelir. Bu, bu sınıfların arabirimi doğrudan uyguladığı .NET Framework önceki sürümlerinden IIdentity farklıdır. Kimliği açıklayan talep koleksiyonuna özelliği aracılığıyla Claims erişilebilir. sınıfı, ClaimsIdentity talepleri bulmak ve değiştirmek için çeşitli yöntemler sağlar ve dille tümleşik sorguları (LINQ) tam olarak destekler. Uygulama kodunda nesnelere ClaimsIdentity genellikle nesneleri üzerinden ClaimsPrincipal erişilir; örneğin, tarafından Thread.CurrentPrincipaldöndürülen sorumlu.

Not

Sınıfının ClaimsPrincipal da bir Claims özelliği vardır. Çoğu durumda kullanıcının taleplerine koleksiyon yerine koleksiyon üzerinden ClaimsPrincipal.ClaimsClaims erişmeniz gerekir. Bir kişinin ClaimsIdentity taleplerine yalnızca sorumlunun birden ClaimsIdentity fazla içerdiği durumlarda erişmeniz ve belirli bir kimliği değerlendirmeniz veya değiştirmeniz gerekir.

Önemli

Koleksiyona talep eklemek veya koleksiyondan talep kaldırmak için çağıranın Claims tam güvene sahip olması gerekir.

Talep tabanlı modelde IIdentity.Name özelliği ve IPrincipal.IsInRole(String) yöntemi, bir kimliğin içerdiği talepler değerlendirilerek uygulanır. Talep tabanlı modeldeki temel uygulamalar özelliği ve ClaimsPrincipal.IsInRole yöntemi tarafından ClaimsIdentity.Name sağlanır. ve RoleClaimType özellikleri, NameClaimType 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.

Temsilci seçme senaryoları ve BootstrapContext özellikleri aracılığıyla Actor desteklenir.

Oluşturucular

ClaimsIdentity()	Boş bir talep koleksiyonu ile sınıfının yeni bir örneğini ClaimsIdentity başlatır.
ClaimsIdentity(BinaryReader)	Belirtilen BinaryReaderile bir örneğini ClaimsIdentity başlatır.
ClaimsIdentity(ClaimsIdentity)	Mevcut ClaimsIdentity bir örnekten ClaimsIdentity sınıfının yeni bir örneğini başlatır.
ClaimsIdentity(IEnumerable<Claim>)	Numaralandırılmış bir nesne koleksiyonu kullanarak sınıfının yeni bir örneğini ClaimsIdentityClaim başlatır.
ClaimsIdentity(IEnumerable<Claim>, String)	Belirtilen talepler ve kimlik doğrulama türüyle sınıfının yeni bir örneğini ClaimsIdentity başlatır.
ClaimsIdentity(IEnumerable<Claim>, String, String, String)	Belirtilen talepler, kimlik doğrulama türü, ad talep türü ve rol talep türü ile sınıfının yeni bir örneğini ClaimsIdentity başlatır.
ClaimsIdentity(IIdentity)	Belirtilen IIdentityöğesinden ClaimsIdentity ad ve kimlik doğrulama türünü kullanarak sınıfının yeni bir örneğini başlatır.
ClaimsIdentity(IIdentity, IEnumerable<Claim>)	Belirtilen talepleri ve belirtilen kullanarak sınıfının yeni bir örneğini ClaimsIdentityIIdentitybaşlatır.
ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String)	Belirtilen talepleri, kimlik doğrulama türünü, ad talep türünü ve rol talep türünü kullanarak belirtilen IIdentity öğesinden sınıfının yeni bir örneğini ClaimsIdentity başlatır.
ClaimsIdentity(SerializationInfo)	Geçersiz. kullanılarak ISerializableoluşturulan serileştirilmiş bir akıştan sınıfının yeni bir örneğini ClaimsIdentity başlatır.
ClaimsIdentity(SerializationInfo, StreamingContext)	Geçersiz. kullanılarak ISerializableoluşturulan serileştirilmiş bir akıştan sınıfının yeni bir örneğini ClaimsIdentity başlatır.
ClaimsIdentity(String)	Boş bir talep koleksiyonu ve belirtilen kimlik doğrulama türü ile sınıfının yeni bir örneğini ClaimsIdentity başlatır.
ClaimsIdentity(String, String, String)	Belirtilen kimlik doğrulama türü, ad talep türü ve rol talep türü ile sınıfının yeni bir örneğini ClaimsIdentity başlatır.

Alanlar

DefaultIssuer	Varsayılan veren; "YEREL YETKILI".
DefaultNameClaimType	Varsayılan ad talep türü; Name.
DefaultRoleClaimType	Varsayılan rol talep türü; Role.

Özellikler

Actor	Temsilci hakları verilen çağıran tarafın kimliğini alır veya ayarlar.
AuthenticationType	Kimlik doğrulama türünü alır.
BootstrapContext	Bu talep kimliğini oluşturmak için kullanılan belirteci alır veya ayarlar.
Claims	Bu talep kimliğiyle ilişkili talepleri alır.
CustomSerializationData	Türetilmiş bir tür tarafından sağlanan ek verileri içerir. genellikle çağrılırken WriteTo(BinaryWriter, Byte[])ayarlanır.
IsAuthenticated	Kimliğin kimliğinin doğrulanıp doğrulanmamış olduğunu gösteren bir değer alır.
Label	Bu talep kimliği için etiketi alır veya ayarlar.
Name	Bu talep kimliğinin adını alır.
NameClaimType	Bu talep kimliğinin özelliği için değer sağlayan talepleri belirlemek için Name kullanılan talep türünü alır.
RoleClaimType	Bu talep kimliğindeki talepler arasında .NET rolü olarak yorumlanacak talep türünü alır.

Yöntemler

AddClaim(Claim)	Bu talep kimliğine tek bir talep ekler.
AddClaims(IEnumerable<Claim>)	Bu talep kimliğine taleplerin listesini ekler.
Clone()	Bu talep kimliğinden yeni bir ClaimsIdentity kopya döndürür.
CreateClaim(BinaryReader)	Özel Claimbir oluşturmak için türetilmiş türler için bir genişletilebilirlik noktası sağlar.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
FindAll(Predicate<Claim>)	Belirtilen koşulla eşleşen tüm talepleri alır.
FindAll(String)	Belirtilen talep türüne sahip tüm talepleri alır.
FindFirst(Predicate<Claim>)	Belirtilen koşulla eşleşen ilk talebi alır.
FindFirst(String)	Belirtilen talep türüne sahip ilk talebi alır.
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetObjectData(SerializationInfo, StreamingContext)	SerializationInfo geçerli ClaimsIdentity nesneyi seri hale getirmek için gereken verilerle doldurur.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
HasClaim(Predicate<Claim>)	Bu talep kimliğinin belirtilen koşulla eşleşen bir talep olup olmadığını belirler.
HasClaim(String, String)	Bu talep kimliğinin belirtilen talep türüne ve değerine sahip bir talep olup olmadığını belirler.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
RemoveClaim(Claim)	Talep kimliğinden bir talebi kaldırmaya çalışır.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TryRemoveClaim(Claim)	Talep kimliğinden bir talebi kaldırmaya çalışır.
WriteTo(BinaryWriter)	kullanarak BinaryWriterseri hale getirmektedir.
WriteTo(BinaryWriter, Byte[])	kullanarak BinaryWriterseri hale getirmektedir.

Ayrıca bkz.

• Claim
• ClaimsPrincipal
• GenericIdentity
• WindowsIdentity
• FormsIdentity