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 ifadedir. Böyle bir varlığın talebin konusu olduğu söylenir. Talep sınıfı tarafından Claim temsil edilir. içinde ClaimsIdentity yer alan talepler, ilgili kimliğin temsil ettiğ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 ayrıntılı bir şekilde değerlendirilebilir.
.NET Framework 4.5'le başlayarak, Windows Identity Foundation (WIF) ve talep tabanlı kimlik .NET Framework ile tam olarak tümleştirilmiştir. Bu, .NET Framework'te 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'ün ö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 dil tümleşik sorgularını (LINQ) tam olarak destekler. Uygulama kodunda nesnelere ClaimsIdentity genellikle nesneleri üzerinden ClaimsPrincipal erişilir; örneğin, tarafından Thread.CurrentPrincipaldöndürülen sorumlu.
Uyarı
Sınıfı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 yöntemi, bir kimliğin IPrincipal.IsInRole(String) 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 senaryoları ve BootstrapContext özellikleri aracılığıyla Actor desteklenir.
Oluşturucular
| Name | Description |
|---|---|
| ClaimsIdentity() |
Boş bir talep koleksiyonuyla sınıfının yeni bir örneğini ClaimsIdentity başlatır. |
| ClaimsIdentity(BinaryReader, StringComparison) |
belirtilen BinaryReaderile bir örneğini ClaimsIdentity başlatır. |
| ClaimsIdentity(BinaryReader) |
belirtilen BinaryReaderile bir örneğini ClaimsIdentity başlatır. |
| ClaimsIdentity(ClaimsIdentity, StringComparison) |
Mevcut ClaimsIdentity bir örnekten ClaimsIdentity sınıfının yeni bir örneğini 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>, String, String, String) |
Belirtilen talepler, kimlik doğrulama türü, ad talep türü ve rol talep türü ile sınıfın yeni bir örneğini ClaimsIdentity 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>) |
Numaralandırılmış bir nesne koleksiyonu kullanarak sınıfın ClaimsIdentity yeni bir örneğini Claim başlatır. |
| ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String, StringComparison) |
ClaimsIdentity sınıfının yeni bir örneğini baş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 sınıfından IIdentity yeni bir sınıf örneği ClaimsIdentity 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) |
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(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(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(String, String, String) |
Belirtilen kimlik doğrulama türü, ad talep türü ve rol talep türü ile sınıfı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. |
Alanlar
| Name | Description |
|---|---|
| DefaultIssuer |
Varsayılan veren; "YEREL YETKILI". |
| DefaultNameClaimType |
Varsayılan ad talep türü; Nameöğesini seçin. |
| DefaultRoleClaimType |
Varsayılan rol talep türü; Roleöğesini seçin. |
Özellikler
| Name | Description |
|---|---|
| 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 tüm ek verileri içerir. genellikle çağrılırken WriteTo(BinaryWriter, Byte[])ayarlanır. |
| IsAuthenticated |
Kimliğin kimlik doğrulaması yapılıp yapılmadığını 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 |
Hangi taleplerin bu talep kimliğinin özelliği için değer sağladığını Name belirlemek için 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
| Name | Description |
|---|---|
| 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() |
Geçerli örneğin Type 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 Objectbasit 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 bir dize döndürür. (Devralındığı yer: Object) |
| TryRemoveClaim(Claim) |
Talep kimliğinden bir talebi kaldırmaya çalışır. |
| WriteTo(BinaryWriter, Byte[]) |
kullanarak BinaryWriterseri hale getirmektedir. |
| WriteTo(BinaryWriter) |
kullanarak BinaryWriterseri hale getirmektedir. |