ClaimsIdentity Klasa

Definicja

Przestrzeń nazw:

System.Security.Claims

Zestaw:

System.Security.Claims.dll

Źródło:

ClaimsIdentity.cs

Reprezentuje tożsamość opartą na oświadczeniach.

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

Dziedziczenie

Object

ClaimsIdentity

Pochodne

System.Security.Principal.GenericIdentity

System.Security.Principal.WindowsIdentity

Implementuje

IIdentity

Uwagi

Klasa ClaimsIdentity jest konkretną implementacją tożsamości opartej na oświadczeniach, czyli tożsamości opisanej przez kolekcję oświadczeń. Oświadczenie jest instrukcją dotyczącą jednostki złożonej przez wystawcę, która opisuje właściwość, prawo lub inną jakość tej jednostki. Mówi się, że taka jednostka jest przedmiotem roszczenia. Oświadczenie jest reprezentowane przez klasę Claim . Oświadczenia zawarte w opisie ClaimsIdentity jednostki, którą reprezentuje odpowiednia tożsamość, i mogą służyć do podejmowania decyzji dotyczących autoryzacji i uwierzytelniania. Model dostępu oparty na oświadczeniach ma wiele zalet w porównaniu z bardziej tradycyjnymi modelami dostępu, które opierają się wyłącznie na rolach. Na przykład oświadczenia mogą dostarczać znacznie bogatsze informacje o tożsamości, którą reprezentują i mogą być oceniane pod kątem autoryzacji lub uwierzytelniania w znacznie bardziej szczegółowy sposób.

Począwszy od .NET Framework 4.5, tożsamość oparta na oświadczeniach (Windows Identity Foundation) i tożsamości opartej na oświadczeniach zostały w pełni zintegrowane z .NET Framework. Oznacza to, że wiele klas reprezentujących tożsamość w .NET Framework teraz pochodzi od ClaimsIdentity i opisuje ich właściwości za pośrednictwem kolekcji oświadczeń. Różni się to od poprzednich wersji .NET Framework, w których te klasy zaimplementowały IIdentity interfejs bezpośrednio. Dostęp do kolekcji oświadczeń opisujących tożsamość można uzyskać za pośrednictwem Claims właściwości . Klasa ClaimsIdentity udostępnia kilka metod znajdowania i modyfikowania oświadczeń oraz w pełni obsługuje zapytania zintegrowane z językiem (LINQ). W kodzie ClaimsIdentity aplikacji obiekty są zwykle dostępne za pośrednictwem ClaimsPrincipal obiektów, na przykład podmiot zabezpieczeń zwracany przez Thread.CurrentPrincipal.

Uwaga

Klasa ClaimsPrincipal ma Claims również właściwość . W większości przypadków należy uzyskać dostęp do oświadczeń użytkownika za pośrednictwem ClaimsPrincipal.Claims kolekcji, a nie za pośrednictwem Claims kolekcji. Musisz uzyskać dostęp do oświadczeń pojedynczej osoby ClaimsIdentity tylko w przypadkach, gdy podmiot zabezpieczeń zawiera więcej niż jeden ClaimsIdentity i musisz ocenić lub zmodyfikować określoną tożsamość.

Ważne

Aby dodać lub usunąć oświadczenia z Claims kolekcji, obiekt wywołujący musi mieć pełną relację zaufania.

W modelu IIdentity.Name opartym na oświadczeniach właściwość i IPrincipal.IsInRole(String) metoda są implementowane przez ocenę oświadczeń zawartych w tożsamości. Podstawowe implementacje w modelu opartym na oświadczeniach są dostarczane przez ClaimsIdentity.Name właściwość i metodę ClaimsPrincipal.IsInRole . Właściwości NameClaimType i RoleClaimType umożliwiają określenie typu oświadczenia, który ma być używany do oceny oświadczeń zawartych w tożsamości podczas wykonywania tych operacji.

Scenariusze delegowania są obsługiwane za pośrednictwem Actor właściwości i BootstrapContext .

Konstruktory

ClaimsIdentity()	Inicjuje ClaimsIdentity nowe wystąpienie klasy z pustą kolekcją oświadczeń.
ClaimsIdentity(BinaryReader)	Inicjuje wystąpienie klasy ClaimsIdentity z określonym BinaryReaderelementem .
ClaimsIdentity(ClaimsIdentity)	Inicjuje ClaimsIdentity nowe wystąpienie klasy z istniejącego ClaimsIdentity wystąpienia.
ClaimsIdentity(IEnumerable<Claim>)	Inicjuje ClaimsIdentity nowe wystąpienie klasy przy użyciu wyliczanej kolekcji Claim obiektów.
ClaimsIdentity(IEnumerable<Claim>, String)	Inicjuje ClaimsIdentity nowe wystąpienie klasy z określonymi oświadczeniami i typem uwierzytelniania.
ClaimsIdentity(IEnumerable<Claim>, String, String, String)	Inicjuje ClaimsIdentity nowe wystąpienie klasy z określonymi oświadczeniami, typem uwierzytelniania, typem oświadczenia nazwy i typem oświadczenia roli.
ClaimsIdentity(IIdentity)	Inicjuje ClaimsIdentity nowe wystąpienie klasy przy użyciu nazwy i typu uwierzytelniania z określonego IIdentityelementu .
ClaimsIdentity(IIdentity, IEnumerable<Claim>)	Inicjuje nowe wystąpienie ClaimsIdentity klasy przy użyciu określonych oświadczeń i określonego IIdentity.
ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String)	Inicjuje nowe wystąpienie ClaimsIdentity klasy z określonego IIdentity przy użyciu określonych oświadczeń, typu uwierzytelniania, typu oświadczenia nazwy i typu oświadczenia roli.
ClaimsIdentity(SerializationInfo)	Przestarzałe. Inicjuje ClaimsIdentity nowe wystąpienie klasy na podstawie serializowanego strumienia utworzonego przy użyciu polecenia ISerializable.
ClaimsIdentity(SerializationInfo, StreamingContext)	Przestarzałe. Inicjuje ClaimsIdentity nowe wystąpienie klasy na podstawie serializowanego strumienia utworzonego przy użyciu polecenia ISerializable.
ClaimsIdentity(String)	Inicjuje ClaimsIdentity nowe wystąpienie klasy z pustą kolekcją oświadczeń i określonym typem uwierzytelniania.
ClaimsIdentity(String, String, String)	Inicjuje ClaimsIdentity nowe wystąpienie klasy z określonym typem uwierzytelniania, typem oświadczenia nazwy i typem oświadczenia roli.

Pola

DefaultIssuer	Domyślny wystawca; "URZĄD LOKALNY".
DefaultNameClaimType	Domyślny typ oświadczenia nazwy; Name.
DefaultRoleClaimType	Domyślny typ oświadczenia roli; Role.

Właściwości

Actor	Pobiera lub ustawia tożsamość strony wywołującej, która otrzymała prawa delegowania.
AuthenticationType	Pobiera typ uwierzytelniania.
BootstrapContext	Pobiera lub ustawia token, który został użyty do utworzenia tej tożsamości oświadczeń.
Claims	Pobiera oświadczenia skojarzone z tą tożsamością oświadczeń.
CustomSerializationData	Zawiera wszelkie dodatkowe dane udostępniane przez typ pochodny. Zazwyczaj ustawiane podczas wywoływania metody WriteTo(BinaryWriter, Byte[]).
IsAuthenticated	Pobiera wartość wskazującą, czy tożsamość została uwierzytelniona.
Label	Pobiera lub ustawia etykietę dla tej tożsamości oświadczeń.
Name	Pobiera nazwę tej tożsamości oświadczeń.
NameClaimType	Pobiera typ oświadczenia używany do określenia, które oświadczenia zapewniają wartość dla Name właściwości tej tożsamości oświadczeń.
RoleClaimType	Pobiera typ oświadczenia, który będzie interpretowany jako rola .NET wśród oświadczeń w tej tożsamości oświadczeń.

Metody

AddClaim(Claim)	Dodaje pojedyncze oświadczenie do tej tożsamości oświadczeń.
AddClaims(IEnumerable<Claim>)	Dodaje listę oświadczeń do tej tożsamości oświadczeń.
Clone()	Zwraca nową ClaimsIdentity skopiowaną z tej tożsamości oświadczeń.
CreateClaim(BinaryReader)	Zapewnia punkt rozszerzalności dla typów pochodnych w celu utworzenia niestandardowego Claimelementu .
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FindAll(Predicate<Claim>)	Pobiera wszystkie oświadczenia dopasowane przez określony predykat.
FindAll(String)	Pobiera wszystkie oświadczenia, które mają określony typ oświadczenia.
FindFirst(Predicate<Claim>)	Pobiera pierwsze oświadczenie zgodne z określonym predykatem.
FindFirst(String)	Pobiera pierwsze oświadczenie z określonym typem oświadczenia.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)	Wypełnia element SerializationInfo danymi wymaganymi do serializacji bieżącego ClaimsIdentity obiektu.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
HasClaim(Predicate<Claim>)	Określa, czy ta tożsamość oświadczenia ma oświadczenie zgodne z określonym predykatem.
HasClaim(String, String)	Określa, czy ta tożsamość oświadczeń ma oświadczenie o określonym typie i wartości oświadczenia.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
RemoveClaim(Claim)	Próbuje usunąć oświadczenie z tożsamości oświadczeń.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TryRemoveClaim(Claim)	Próbuje usunąć oświadczenie z tożsamości oświadczeń.
WriteTo(BinaryWriter)	Serializuje przy użyciu klasy BinaryWriter.
WriteTo(BinaryWriter, Byte[])	Serializuje przy użyciu klasy BinaryWriter.

Zobacz też

• Claim
• ClaimsPrincipal
• GenericIdentity
• WindowsIdentity
• FormsIdentity