ClaimsIdentity Sınıf
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Talep tabanlı kimliği temsil eder.
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
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. |