ClaimsIdentity Classe

Définition

Représente une identité basée sur des revendications.Represents a claims-based identity.

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
Héritage
ClaimsIdentity
Dérivé
Attributs
Implémente

Remarques

La ClaimsIdentity classe est une implémentation concrète d’une identité basée sur les revendications, c’est-à-dire une identité décrite par une collection de revendications.The ClaimsIdentity class is a concrete implementation of a claims-based identity; that is, an identity described by a collection of claims. Une revendication est une instruction sur une entité créée par un émetteur qui décrit une propriété, un droit ou une autre qualité de cette entité.A claim is a statement about an entity made by an issuer that describes a property, right, or some other quality of that entity. Une telle entité est considérée comme étant l’objet de la revendication.Such an entity is said to be the subject of the claim. Une revendication est représentée par la Claim classe.A claim is represented by the Claim class. Les revendications contenues dans ClaimsIdentity décrivent l’entité représentée par l’identité correspondante et peuvent être utilisées pour prendre des décisions d’autorisation et d’authentification.The claims contained in a ClaimsIdentity describe the entity that the corresponding identity represents, and can be used to make authorization and authentication decisions. Un modèle d’accès basé sur les revendications présente de nombreux avantages par rapport aux modèles d’accès plus traditionnels qui s’appuient exclusivement sur les rôles.A claims-based access model has many advantages over more traditional access models that rely exclusively on roles. Par exemple, les revendications peuvent fournir des informations beaucoup plus riches sur l’identité qu’elles représentent et peuvent être évaluées pour l’autorisation ou l’authentification de manière beaucoup plus spécifique.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.

À partir de .NET Framework 4,5, WIF (Windows Identity Foundation) et l’identité basée sur les revendications ont été entièrement intégrés dans le .NET Framework.Beginning with .NET Framework 4.5, Windows Identity Foundation (WIF) and claims-based identity have been fully integrated into the .NET Framework. Cela signifie que de nombreuses classes qui représentent une identité dans le .NET Framework dérivent désormais de ClaimsIdentity leurs propriétés par le biais d’une collection de revendications.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. Cela diffère des versions précédentes du .NET Framework, dans lesquelles ces classes implémentaient IIdentity directement l’interface.This is different from previous versions of the .NET Framework, in which, these classes implemented the IIdentity interface directly. La collection de revendications qui décrivent l’identité est accessible via la Claims propriété.The collection of claims that describe the identity can be accessed through the Claims property. La ClaimsIdentity classe fournit plusieurs méthodes pour rechercher et modifier des revendications et prend entièrement en charge les requêtes LINQ (Language Integrated Queries).The ClaimsIdentity class provides several methods for finding and modifying claims and fully supports language integrated queries (LINQ). Dans le code d’application, ClaimsIdentity les objets sont généralement accessibles par ClaimsPrincipal le biais d’objets, par exemple, le principal retourné par Thread.CurrentPrincipal .In application code, ClaimsIdentity objects are typically accessed through ClaimsPrincipal objects; for example, the principal returned by Thread.CurrentPrincipal.

Notes

La ClaimsPrincipal classe a Claims également une propriété.The ClaimsPrincipal class has a Claims property as well. Dans la majorité des cas, vous devez accéder aux revendications de l’utilisateur via la ClaimsPrincipal.Claims collection plutôt que par le biais de la Claims collection.In the majority of cases you should access the user's claims through the ClaimsPrincipal.Claims collection rather than through the Claims collection. Vous devrez accéder aux revendications d’un individu ClaimsIdentity uniquement dans les cas où le principal en contient plusieurs ClaimsIdentity et vous devez évaluer ou modifier une identité spécifique.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.

Important

Pour ajouter ou supprimer des revendications de la Claims collection, un appelant doit avoir une confiance totale.To add or remove claims from the Claims collection, a caller must have full trust.

Dans le modèle basé sur les revendications, la IIdentity.Name propriété et la IPrincipal.IsInRole(String) méthode sont implémentées en évaluant les revendications contenues par une identité.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. Les implémentations de base dans le modèle basé sur les revendications sont fournies par la ClaimsIdentity.Name propriété et la ClaimsPrincipal.IsInRole méthode.The base implementations in the claims-based model are provided by the ClaimsIdentity.Name property and the ClaimsPrincipal.IsInRole method. Les NameClaimType RoleClaimType Propriétés et vous permettent de spécifier un type de revendication à utiliser pour évaluer les revendications contenues dans l’identité lors de l’exécution de ces opérations.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.

Les scénarios de délégation sont pris en charge via les Actor BootstrapContext Propriétés et.Delegation scenarios are supported through the Actor and BootstrapContext properties.

Constructeurs

ClaimsIdentity()

Initialise une nouvelle instance de la classe ClaimsIdentity avec une collection de revendications vides.Initializes a new instance of the ClaimsIdentity class with an empty claims collection.

ClaimsIdentity(BinaryReader)

Initialise une instance de la classe ClaimsIdentity avec le BinaryReader spécifié.Initializes an instance of ClaimsIdentity with the specified BinaryReader.

ClaimsIdentity(ClaimsIdentity)

Initialise une nouvelle instance de la classe ClaimsIdentity à partir d’une instance ClaimsIdentity existante.Initializes a new instance of the ClaimsIdentity class from an existing ClaimsIdentity instance.

ClaimsIdentity(IEnumerable<Claim>)

Initialise une nouvelle instance de la classe ClaimsIdentity avec une collection énumérée d'objets Claim.Initializes a new instance of the ClaimsIdentity class using an enumerated collection of Claim objects.

ClaimsIdentity(IEnumerable<Claim>, String)

Initialise une nouvelle instance de la classe ClaimsIdentity avec les revendications et le type d'authentification spécifiés.Initializes a new instance of the ClaimsIdentity class with the specified claims and authentication type.

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

Initialise une nouvelle instance de la classe ClaimsIdentity avec les revendications, le type d’authentification, le type de revendication de nom et le type de réclamation de rôle spécifiés.Initializes a new instance of the ClaimsIdentity class with the specified claims, authentication type, name claim type, and role claim type.

ClaimsIdentity(IIdentity)

Initialise une nouvelle instance de la classe ClaimsIdentity à l'aide du nom et du type d'authentification du IIdentity spécifié.Initializes a new instance of the ClaimsIdentity class using the name and authentication type from the specified IIdentity.

ClaimsIdentity(IIdentity, IEnumerable<Claim>)

Initialise une nouvelle instance de la classe ClaimsIdentity à l'aide des revendications spécifiées et du IIdentity spécifié.Initializes a new instance of the ClaimsIdentity class using the specified claims and the specified IIdentity.

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

Initialise une nouvelle instance de la classe ClaimsIdentity à partir de l'IIdentity spécifiée à l'aide des revendications, du type d'authentification, du type de revendication de nom, et du ype de revendication de rôle spécifiés.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)

Initialise une nouvelle instance de la classe ClaimsIdentity à partir du flux sérialisé créé à l’aide de ISerializable.Initializes a new instance of the ClaimsIdentity class from a serialized stream created by using ISerializable.

ClaimsIdentity(SerializationInfo, StreamingContext)

Initialise une nouvelle instance de la classe ClaimsIdentity à partir du flux sérialisé créé à l’aide de ISerializable.Initializes a new instance of the ClaimsIdentity class from a serialized stream created by using ISerializable.

ClaimsIdentity(String)

Initialise une nouvelle instance de la classe ClaimsIdentity avec une collection de revendications vides et le type d'authentification spécifié.Initializes a new instance of the ClaimsIdentity class with an empty claims collection and the specified authentication type.

ClaimsIdentity(String, String, String)

Initialise une nouvelle instance de la classe ClaimsIdentity avec le type d'authentification, le type de revendication de nom et le type de réclamation de rôle spécifiés.Initializes a new instance of the ClaimsIdentity class with the specified authentication type, name claim type, and role claim type.

Champs

DefaultIssuer

Émetteur par défaut ; « LOCAL AUTHORITY ».The default issuer; "LOCAL AUTHORITY".

DefaultNameClaimType

Type de revendication de nom par défaut ; Name.The default name claim type; Name.

DefaultRoleClaimType

Type de revendication de rôle par défaut ; Role.The default role claim type; Role.

Propriétés

Actor

Obtient ou définit l'identité de la partie appelante s'est vue accordée des droits de délégation.Gets or sets the identity of the calling party that was granted delegation rights.

AuthenticationType

Obtient le type d'authentification.Gets the authentication type.

BootstrapContext

Obtient ou définit le jeton qui a été utilisé pour créer cette identité basée sur les revendications.Gets or sets the token that was used to create this claims identity.

Claims

Obtient les revendications associées à cette identité basée sur les revendications.Gets the claims associated with this claims identity.

CustomSerializationData

Contient les données supplémentaires fournies par un type dérivé.Contains any additional data provided by a derived type. En règle générale, définie au moment de l’appel de WriteTo(BinaryWriter, Byte[]).Typically set when calling WriteTo(BinaryWriter, Byte[]).

IsAuthenticated

Obtient une valeur qui indique que l'identité a été authentifiée.Gets a value that indicates whether the identity has been authenticated.

Label

Obtient ou définit l'étiquette de cette identité basée sur les revendications.Gets or sets the label for this claims identity.

Name

Obtient le nom de cette identité basée sur les revendications.Gets the name of this claims identity.

NameClaimType

Obtient le type de revendication utilisé pour déterminer les revendications qui fournissent la valeur de la propriété Name de cette identité basée sur les revendications.Gets the claim type that is used to determine which claims provide the value for the Name property of this claims identity.

RoleClaimType

Obtient le type de revendication qui est interprétée comme un rôle .NET Framework entre les revendications dans cette identité basée sur les revendications.Gets the claim type that will be interpreted as a .NET Framework role among the claims in this claims identity.

Méthodes

AddClaim(Claim)

Ajoute une revendication unique à cette identité des revendications.Adds a single claim to this claims identity.

AddClaims(IEnumerable<Claim>)

Ajoute une liste de revendications à cette identité de revendications.Adds a list of claims to this claims identity.

Clone()

Retourne une nouvelle ClaimsIdentity copiée à partir de cette identité basée sur les revendications.Returns a new ClaimsIdentity copied from this claims identity.

CreateClaim(BinaryReader)

Fournit un point d’extensibilité pour les types dérivés afin de créer un Claim personnalisé.Provides an extensibility point for derived types to create a custom Claim.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
FindAll(Predicate<Claim>)

Récupère toutes les revendications qui sont mises en correspondance par le prédicat spécifié.Retrieves all of the claims that are matched by the specified predicate.

FindAll(String)

Récupère toutes les revendications qui ont le type de revendication spécifié.Retrieves all of the claims that have the specified claim type.

FindFirst(Predicate<Claim>)

Extrait la première revendication qui est mise en correspondance par le prédicat spécifié.Retrieves the first claim that is matched by the specified predicate.

FindFirst(String)

Extrait la première revendication avec le type de revendication spécifié.Retrieves the first claim with the specified claim type.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetObjectData(SerializationInfo, StreamingContext)

Renseigne des SerializationInfo avec les données nécessaires à la sérialisation de l'objet ClaimsIdentity actuel.Populates the SerializationInfo with data needed to serialize the current ClaimsIdentity object.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
HasClaim(Predicate<Claim>)

Détermine si cette identité des revendications a une revendication qui est mise en correspondance par l'attribut spécifié.Determines whether this claims identity has a claim that is matched by the specified predicate.

HasClaim(String, String)

Détermine si cette identité des revendications a une revendication avec le type et la valeur de revendication spécifiques.Determines whether this claims identity has a claim with the specified claim type and value.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
RemoveClaim(Claim)

Tente de supprimer une revendication dans l'identité basée sur les revendications.Attempts to remove a claim from the claims identity.

ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)
TryRemoveClaim(Claim)

Tente de supprimer une revendication dans l'identité basée sur les revendications.Attempts to remove a claim from the claims identity.

WriteTo(BinaryWriter)

Sérialise à l’aide d’un BinaryWriter.Serializes using a BinaryWriter.

WriteTo(BinaryWriter, Byte[])

Sérialise à l’aide d’un BinaryWriter.Serializes using a BinaryWriter.

S’applique à

Voir aussi