ClaimsIdentity Klasa

Definicja

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

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
Dziedziczenie
ClaimsIdentity
Pochodne
Atrybuty
Implementuje

Uwagi

Klasa ClaimsIdentity jest konkretną implementacją tożsamości opartej na oświadczeniach, czyli tożsamości opisanej przez kolekcję oświadczeń. Oświadczenie to instrukcja dotycząca jednostki dokonanej przez wystawcę opisującego właściwość, prawo lub inną jakość tej jednostki. Taka jednostka jest uważana za przedmiotem roszczenia. Oświadczenie jest reprezentowane przez klasę Claim . Oświadczenia zawarte w opisie ClaimsIdentity jednostki reprezentującej odpowiednią 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, Windows Identity Foundation (WIF) 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 pochodzi teraz z 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. Kolekcja 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ń zwrócony 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 przez tożsamość. 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 powinien być używany do oceny oświadczeń zawartych przez tożsamość 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 określonego ClaimsIdentity BinaryReaderobiektu .

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 wyliczonej 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)

Inicjuje ClaimsIdentity nowe wystąpienie klasy z serializacji strumienia utworzonego przy użyciu polecenia ISerializable.

ClaimsIdentity(SerializationInfo, StreamingContext)

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 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 dostarczone 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ślania, 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)

Udostępnia 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, które są zgodne z określonym predykatem.

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 dane SerializationInfo wymagane 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świadczenia ma oświadczenie o określonym typie oświadczenia i wartości.

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.

Dotyczy

Zobacz też