ClaimsIdentity ClaimsIdentity ClaimsIdentity ClaimsIdentity Class

Definition

Stellt eine anspruchsbasierte Identität dar.Represents a claims-based identity.

public ref 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
Public Class ClaimsIdentity
Implements IIdentity
Vererbung
ClaimsIdentityClaimsIdentityClaimsIdentityClaimsIdentity
Attribute
Implementiert

Hinweise

Die ClaimsIdentity Klasse ist eine konkrete Implementierung einer anspruchsbasierten Identität; d. h. eine Identität, die durch eine Sammlung von Ansprüchen beschrieben.The ClaimsIdentity class is a concrete implementation of a claims-based identity; that is, an identity described by a collection of claims. Ein Anspruch ist eine Anweisung zu einer Entität, die durch einen Aussteller, der beschreibt, eine Eigenschaft oder einige andere Qualität dieser Entität vorgenommen.A claim is a statement about an entity made by an issuer that describes a property, right, or some other quality of that entity. Solche Entität ist als der Antragsteller des Anspruchs.Such an entity is said to be the subject of the claim. Ein Anspruch wird dargestellt, durch die Claim Klasse.A claim is represented by the Claim class. Die in enthaltenen Ansprüche eine ClaimsIdentity beschrieben, die Entität, die die entsprechende Identität darstellt, und kann verwendet werden, um Autorisierungs- und Authentifizierungsfunktionen Entscheidungen zu treffen.The claims contained in a ClaimsIdentity describe the entity that the corresponding identity represents, and can be used to make authorization and authentication decisions. Ein Modell anspruchsbasierter Zugriff hat viele Vorteile gegenüber herkömmlicheren Zugriffsmodelle, die ausschließlich von Rollen abhängig sind.A claims-based access model has many advantages over more traditional access models that rely exclusively on roles. Ansprüche können z. B. viel umfangreichere Informationen zur Identität bereitstellen, die Sie darstellen, und für die Autorisierung oder Authentifizierung in einer wesentlich mehr bestimmten Weise ausgewertet werden können.For example, claims can provide much richer information about the identity they represent and can be evaluated for authorization or authentication in a far more specific manner.

Ab .NET Framework 4.5 wurden Windows Identity Foundation (WIF) und anspruchsbasierte Identität vollständig in .NET Framework integriert.Beginning with .NET Framework 4.5, Windows Identity Foundation (WIF) and claims-based identity have been fully integrated into the .NET Framework. Dies bedeutet, dass viele Klassen, die jetzt, eine Identität in .NET Framework darstellen abgeleitet ClaimsIdentity und eine Beschreibung für Eigenschaften durch eine Sammlung von Ansprüchen.This means that many classes that represent an identity in the .NET Framework now derive from ClaimsIdentity and describe their properties through a collection of claims. Dies unterscheidet sich von früheren Versionen von .NET Framework, in denen diese Klassen implementiert die IIdentity -Schnittstelle direkt.This is different from previous versions of the .NET Framework, in which, these classes implemented the IIdentity interface directly. Die Auflistung von Ansprüchen, die beschreiben, die Identität kann zugegriffen werden, über die Claims Eigenschaft.The collection of claims that describe the identity can be accessed through the Claims property. Die ClaimsIdentity Klasse bietet mehrere Methoden zum Auffinden und Ändern von Ansprüchen und Sprache integrierte Abfragen (LINQ) vollständig unterstützt.The ClaimsIdentity class provides several methods for finding and modifying claims and fully supports language integrated queries (LINQ). Im Anwendungscode ClaimsIdentity Objekte in der Regel erfolgt über ClaimsPrincipal Objekte, z. B. der Prinzipal, der vom Thread.CurrentPrincipal.In application code, ClaimsIdentity objects are typically accessed through ClaimsPrincipal objects; for example, the principal returned by Thread.CurrentPrincipal.

Hinweis

Die ClaimsPrincipal -Klasse verfügt über eine Claims -Eigenschaft ebenfalls.The ClaimsPrincipal class has a Claims property as well. In den meisten Fällen greifen Sie auf der Ansprüche des Benutzers über die ClaimsPrincipal.Claims Auflistung Umweg über den Claims Auflistung.In the majority of cases you should access the user's claims through the ClaimsPrincipal.Claims collection rather than through the Claims collection. Sie müssen auf die Ansprüche eines einzelnen ClaimsIdentity nur in Fällen, in dem der Prinzipal mehrere enthält ClaimsIdentity und zur Auswertung oder zum Ändern einer bestimmten Identität ausgeführt werden müssen.You will need to access the claims of an individual ClaimsIdentity only in the cases where the principal contains more than one ClaimsIdentity and you need to evaluate or modify a specific identity.

Wichtig

Zum Hinzufügen oder entfernen die Ansprüche aus den Claims Sammlung ein Aufrufer muss volle Vertrauenswürdigkeit haben.To add or remove claims from the Claims collection, a caller must have full trust.

In die Claims-basierte Modell die IIdentity.Name Eigenschaft und die IPrincipal.IsInRole(String) -Methode implementiert werden, durch Auswerten der Ansprüche, die durch eine Identität enthalten.In the claims-based model, the IIdentity.Name property and the IPrincipal.IsInRole(String) method are implemented by evaluating the claims contained by an identity. Basisimplementierungen in die Claims-basierte Modell werden bereitgestellt, durch die ClaimsIdentity.Name Eigenschaft und die ClaimsPrincipal.IsInRole Methode.The base implementations in the claims-based model are provided by the ClaimsIdentity.Name property and the ClaimsPrincipal.IsInRole method. Die NameClaimType und RoleClaimType Eigenschaften ermöglichen es Ihnen, einen Anspruchstyp an, die zum Auswerten der Ansprüche, die von der Identität enthalten sind, beim Ausführen dieser Schritte verwendet werden soll.The NameClaimType and RoleClaimType properties enable you to specify a claim type that should be used to evaluate the claims contained by the identity when performing these operations.

Delegierungsszenarien werden unterstützt, über die Actor und BootstrapContext Eigenschaften.Delegation scenarios are supported through the Actor and BootstrapContext properties.

Konstruktoren

ClaimsIdentity() ClaimsIdentity() ClaimsIdentity() ClaimsIdentity()

Initialisiert eine neue Instanz der ClaimsIdentity-Klasse mit einer leeren Anspruchauflistung.Initializes a new instance of the ClaimsIdentity class with an empty claims collection.

ClaimsIdentity(BinaryReader) ClaimsIdentity(BinaryReader) ClaimsIdentity(BinaryReader) ClaimsIdentity(BinaryReader)

Initialisiert eine Instanz von ClaimsIdentity mit der angegebenen BinaryReader.Initializes an instance of ClaimsIdentity with the specified BinaryReader.

ClaimsIdentity(ClaimsIdentity) ClaimsIdentity(ClaimsIdentity) ClaimsIdentity(ClaimsIdentity) ClaimsIdentity(ClaimsIdentity)

Initialisiert eine neue Instanz der ClaimsIdentity-Klasse aus einer bestehenden ClaimsIdentity-Instanz.Initializes a new instance of the ClaimsIdentity class from an existing ClaimsIdentity instance.

ClaimsIdentity(IEnumerable<Claim>) ClaimsIdentity(IEnumerable<Claim>) ClaimsIdentity(IEnumerable<Claim>) ClaimsIdentity(IEnumerable<Claim>)

Initialisiert mithilfe einer enumerierten Auflistung von ClaimsIdentity-Objekten eine neue Instanz der Claim-Klasse.Initializes a new instance of the ClaimsIdentity class using an enumerated collection of Claim objects.

ClaimsIdentity(IEnumerable<Claim>, String) ClaimsIdentity(IEnumerable<Claim>, String) ClaimsIdentity(IEnumerable<Claim>, String) ClaimsIdentity(IEnumerable<Claim>, String)

Initialisiert eine neue Instanz der ClaimsIdentity-Klasse mit dem angegebenen Ansprüchen und Authentifizierungstypen.Initializes a new instance of the ClaimsIdentity class with the specified claims and authentication type.

ClaimsIdentity(IEnumerable<Claim>, String, String, String) ClaimsIdentity(IEnumerable<Claim>, String, String, String) ClaimsIdentity(IEnumerable<Claim>, String, String, String) ClaimsIdentity(IEnumerable<Claim>, String, String, String)

Initialisiert eine neue Instanz der ClaimsIdentity-Klasse mit den angegebenen Werten für Ansprüche, Authentifizierungstyp, Namensanspruchstyp und Typ des Rollenanspruchs.Initializes a new instance of the ClaimsIdentity class with the specified claims, authentication type, name claim type, and role claim type.

ClaimsIdentity(IIdentity) ClaimsIdentity(IIdentity) ClaimsIdentity(IIdentity) ClaimsIdentity(IIdentity)

Initialisiert eine neue Instanz der ClaimsIdentity-Klasse mithilfe des Namens und Authentifizierungstyps aus der angegebenen IIdentity.Initializes a new instance of the ClaimsIdentity class using the name and authentication type from the specified IIdentity.

ClaimsIdentity(IIdentity, IEnumerable<Claim>) ClaimsIdentity(IIdentity, IEnumerable<Claim>) ClaimsIdentity(IIdentity, IEnumerable<Claim>) ClaimsIdentity(IIdentity, IEnumerable<Claim>)

Initialisiert mit den angegebenen Ansprüchen und dem angegebenen ClaimsIdentity eine neue Instanz der IIdentity-Klasse.Initializes a new instance of the ClaimsIdentity class using the specified claims and the specified IIdentity.

ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String) ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String) ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String) ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String)

Initialisiert eine neue Instanz der ClaimsIdentity-Klasse aus dem angegebenen IIdentity unter Verwendung der angegebenen Werte für Ansprüche, Authentifizierungstyp, Namensanspruchstyp und Rollenanspruchstyp.Initializes a new instance of the ClaimsIdentity class from the specified IIdentity using the specified claims, authentication type, name claim type, and role claim type.

ClaimsIdentity(SerializationInfo) ClaimsIdentity(SerializationInfo) ClaimsIdentity(SerializationInfo) ClaimsIdentity(SerializationInfo)

Initialisiert mithilfe von ISerializable eine neue Instanz der ClaimsIdentity-Klasse aus einem serialisierten Stream.Initializes a new instance of the ClaimsIdentity class from a serialized stream created by using ISerializable.

ClaimsIdentity(SerializationInfo, StreamingContext) ClaimsIdentity(SerializationInfo, StreamingContext) ClaimsIdentity(SerializationInfo, StreamingContext) ClaimsIdentity(SerializationInfo, StreamingContext)

Initialisiert mithilfe von ISerializable eine neue Instanz der ClaimsIdentity-Klasse aus einem serialisierten Stream.Initializes a new instance of the ClaimsIdentity class from a serialized stream created by using ISerializable.

ClaimsIdentity(String) ClaimsIdentity(String) ClaimsIdentity(String) ClaimsIdentity(String)

Initialisiert eine neue Instanz der ClaimsIdentity-Klasse mit einer leeren Anspruchsauflistung und dem angegebenen Authentifizierungstyp.Initializes a new instance of the ClaimsIdentity class with an empty claims collection and the specified authentication type.

ClaimsIdentity(String, String, String) ClaimsIdentity(String, String, String) ClaimsIdentity(String, String, String) ClaimsIdentity(String, String, String)

Initialisiert eine neue Instanz der ClaimsIdentity-Klasse mit den angegebenen Werten für Ansprüche, Authentifizierungstyp, Namensanspruchstyp und Typ des Rollenanspruchs.Initializes a new instance of the ClaimsIdentity class with the specified authentication type, name claim type, and role claim type.

Felder

DefaultIssuer DefaultIssuer DefaultIssuer DefaultIssuer

Der Standardaussteller; "LOCAL AUTHORITY".The default issuer; "LOCAL AUTHORITY".

DefaultNameClaimType DefaultNameClaimType DefaultNameClaimType DefaultNameClaimType

Der Anspruchstyp für den Standardnamen; Name.The default name claim type; Name.

DefaultRoleClaimType DefaultRoleClaimType DefaultRoleClaimType DefaultRoleClaimType

Der standardmäßige Rollenanspruchstyps; Role.The default role claim type; Role.

Eigenschaften

Actor Actor Actor Actor

Ruft die Identität des Aufrufers ab, dem Übertragungsrechte erteilt wurden, oder legt diese fest.Gets or sets the identity of the calling party that was granted delegation rights.

AuthenticationType AuthenticationType AuthenticationType AuthenticationType

Ruft den Authentifizierungstyp ab.Gets the authentication type.

BootstrapContext BootstrapContext BootstrapContext BootstrapContext

Ruft das Token ab, das verwendet wurde, um diese Anspruchsidentität zu erstellen, oder legt dieses fest.Gets or sets the token that was used to create this claims identity.

Claims Claims Claims Claims

Ruft die Ansprüche ab, die dieser Anspruchsidentität zugeordnet sind.Gets the claims associated with this claims identity.

CustomSerializationData CustomSerializationData CustomSerializationData CustomSerializationData

Enthält alle zusätzlichen Daten, die von einem abgeleiteten Typ bereitgestellt werden.Contains any additional data provided by a derived type. Wird in der Regel beim Aufrufen von WriteTo(BinaryWriter, Byte[]) festgelegt.Typically set when calling WriteTo(BinaryWriter, Byte[]).

IsAuthenticated IsAuthenticated IsAuthenticated IsAuthenticated

Ruft einen Wert ab, der angibt, ob die Identität authentifiziert wurde.Gets a value that indicates whether the identity has been authenticated.

Label Label Label Label

Ruft die Bezeichnung für diese Anspruchsidentität ab oder legt diese fest.Gets or sets the label for this claims identity.

Name Name Name Name

Ruft den Namen dieser Anspruchsidentität ab.Gets the name of this claims identity.

NameClaimType NameClaimType NameClaimType NameClaimType

Ruft den Anspruchstyp ab, der verwendet wird, um zu bestimmen, welche Ansprüche den Wert für die Name -Eigenschaft der Identität dieses Anspruchs bereitstellen.Gets the claim type that is used to determine which claims provide the value for the Name property of this claims identity.

RoleClaimType RoleClaimType RoleClaimType RoleClaimType

Ruft den Anspruchstyp ab, der als .NET Framework-Rolle unter den Ansprüchen in dieser Anspruchsidentität interpretiert wird.Gets the claim type that will be interpreted as a .NET Framework role among the claims in this claims identity.

Methoden

AddClaim(Claim) AddClaim(Claim) AddClaim(Claim) AddClaim(Claim)

Fügt einen einzelnen Anspruch dieser Anspruchsidentität hinzu.Adds a single claim to this claims identity.

AddClaims(IEnumerable<Claim>) AddClaims(IEnumerable<Claim>) AddClaims(IEnumerable<Claim>) AddClaims(IEnumerable<Claim>)

Fügt eine Liste von Ansprüchen dieser Anspruchsidentität hinzu.Adds a list of claims to this claims identity.

Clone() Clone() Clone() Clone()

Gibt eine neue ClaimsIdentity zurück, die von dieser Anspruchsidentität kopiert wird.Returns a new ClaimsIdentity copied from this claims identity.

CreateClaim(BinaryReader) CreateClaim(BinaryReader) CreateClaim(BinaryReader) CreateClaim(BinaryReader)

Bietet einen Erweiterungspunkt für abgeleitete Typen, um einen benutzerdefinierten Claim zu erstellen.Provides an extensibility point for derived types to create a custom Claim.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindAll(Predicate<Claim>) FindAll(Predicate<Claim>) FindAll(Predicate<Claim>) FindAll(Predicate<Claim>)

Ruft alle Ansprüche ab, die dem angegebenen Prädikat entsprechen.Retrieves all of the claims that are matched by the specified predicate.

FindAll(String) FindAll(String) FindAll(String) FindAll(String)

Ruft alle Ansprüche ab, die über den angegebenen Anspruchstyp verfügen.Retrieves all of the claims that have the specified claim type.

FindFirst(Predicate<Claim>) FindFirst(Predicate<Claim>) FindFirst(Predicate<Claim>) FindFirst(Predicate<Claim>)

Ruft den ersten Anspruch ab, der dem angegebenen Prädikat entspricht.Retrieves the first claim that is matched by the specified predicate.

FindFirst(String) FindFirst(String) FindFirst(String) FindFirst(String)

Ruft den ersten Anspruch mit dem angegebenen Anspruchstyp ab.Retrieves the first claim with the specified claim type.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Füllt das SerializationInfo-Objekt mit den für das Serialisieren des aktuellen ClaimsIdentity-Objekts erforderlichen Daten.Populates the SerializationInfo with data needed to serialize the current ClaimsIdentity object.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
HasClaim(Predicate<Claim>) HasClaim(Predicate<Claim>) HasClaim(Predicate<Claim>) HasClaim(Predicate<Claim>)

Bestimmt, ob diese Anspruchsidentität einen Anspruch besitzt, der durch das angegebene Prädikat erfüllt ist.Determines whether this claims identity has a claim that is matched by the specified predicate.

HasClaim(String, String) HasClaim(String, String) HasClaim(String, String) HasClaim(String, String)

Bestimmt, ob diese Anspruchsdentität einen Anspruch besitzt mit dem angegebenen Typ und dem angegebenen Wert.Determines whether this claims identity has a claim with the specified claim type and value.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
RemoveClaim(Claim) RemoveClaim(Claim) RemoveClaim(Claim) RemoveClaim(Claim)

Versucht, einen Anspruch aus der Anspruchsidentität zu entfernenden.Attempts to remove a claim from the claims identity.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)
TryRemoveClaim(Claim) TryRemoveClaim(Claim) TryRemoveClaim(Claim) TryRemoveClaim(Claim)

Versucht, einen Anspruch aus der Anspruchsidentität zu entfernenden.Attempts to remove a claim from the claims identity.

WriteTo(BinaryWriter) WriteTo(BinaryWriter) WriteTo(BinaryWriter) WriteTo(BinaryWriter)

Serialisiert mithilfe von BinaryWriter.Serializes using a BinaryWriter.

WriteTo(BinaryWriter, Byte[]) WriteTo(BinaryWriter, Byte[]) WriteTo(BinaryWriter, Byte[]) WriteTo(BinaryWriter, Byte[])

Serialisiert mithilfe von BinaryWriter.Serializes using a BinaryWriter.

Gilt für:

Siehe auch