ClaimsIdentity Classe

Référence

Définition

Espace de noms:: System.Security.Claims

Assemblys:: mscorlib.dll, System.Security.Claims.dll

Assembly:: System.Security.Claims.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: ClaimsIdentity.cs

Source:: ClaimsIdentity.cs

Source:: ClaimsIdentity.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Représente une identité basée sur des revendications.

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: Object
ClaimsIdentity

Dérivé: System.Security.Principal.GenericIdentity

System.Security.Principal.WindowsIdentity

System.Web.Security.FormsIdentity

Attributs: ComVisibleAttribute SerializableAttribute

Implémente: IIdentity

Remarques

La ClaimsIdentity classe est une implémentation concrète d’une identité basée sur des revendications, c’est-à-dire une identité décrite par une collection de revendications. Une revendication est une déclaration sur une entité faite par un émetteur qui décrit une propriété, un droit ou une autre qualité de cette entité. Une telle entité serait l’objet de la revendication. Une revendication est représentée par la Claim classe . Les revendications contenues dans un ClaimsIdentity décrivent l’entité que l’identité correspondante représente et peuvent être utilisées pour prendre des décisions d’autorisation et d’authentification. 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 des rôles. 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 d’une manière beaucoup plus spécifique.

À compter de .NET Framework 4.5, Windows Identity Foundation (WIF) et l’identité basée sur les revendications ont été entièrement intégrées au .NET Framework. Cela signifie que de nombreuses classes qui représentent une identité dans le .NET Framework dérivent désormais de ClaimsIdentity et décrivent leurs propriétés par le biais d’une collection de revendications. Cela diffère des versions précédentes du .NET Framework, dans lesquels ces classes implémentent directement l’interface IIdentity . La collection de revendications qui décrivent l’identité est accessible via la Claims propriété . La ClaimsIdentity classe fournit plusieurs méthodes pour rechercher et modifier des revendications et prend entièrement en charge les requêtes intégrées au langage (LINQ). Dans le code d’application, ClaimsIdentity les objets sont généralement accessibles via ClaimsPrincipal des objets ; par exemple, le principal retourné par Thread.CurrentPrincipal.

Notes

La ClaimsPrincipal classe a également une Claims propriété. 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. Vous devez accéder aux revendications d’un individu ClaimsIdentity uniquement dans les cas où le principal en contient plusieurs ClaimsIdentity et que vous devez évaluer ou modifier une identité spécifique.

Important

Pour ajouter ou supprimer des revendications de la Claims collection, un appelant doit avoir une confiance totale.

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é. 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 . Les NameClaimType propriétés et RoleClaimType vous permettent de spécifier un type de revendication qui doit être utilisé pour évaluer les revendications contenues par l’identité lors de l’exécution de ces opérations.

Les scénarios de délégation sont pris en charge via les Actor propriétés et BootstrapContext .

Constructeurs

ClaimsIdentity()	Initialise une nouvelle instance de la classe ClaimsIdentity avec une collection de revendications vides.
ClaimsIdentity(BinaryReader)	Initialise une instance de la classe ClaimsIdentity avec le BinaryReader spécifié.
ClaimsIdentity(ClaimsIdentity)	Initialise une nouvelle instance de la classe ClaimsIdentity à partir d’une instance ClaimsIdentity existante.
ClaimsIdentity(IEnumerable<Claim>)	Initialise une nouvelle instance de la classe ClaimsIdentity avec une collection énumérée d'objets Claim.
ClaimsIdentity(IEnumerable<Claim>, String)	Initialise une nouvelle instance de la classe ClaimsIdentity avec les revendications et le type d'authentification spécifiés.
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.
ClaimsIdentity(IIdentity)	Initialise une nouvelle instance de la classe ClaimsIdentity à l'aide du nom et du type d'authentification du IIdentity spécifié.
ClaimsIdentity(IIdentity, IEnumerable<Claim>)	Initialise une nouvelle instance de la classe ClaimsIdentity à l'aide des revendications spécifiées et du IIdentity spécifié.
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.
ClaimsIdentity(SerializationInfo)	Obsolète. Initialise une nouvelle instance de la classe ClaimsIdentity à partir du flux sérialisé créé à l’aide de ISerializable.
ClaimsIdentity(SerializationInfo, StreamingContext)	Obsolète. Initialise une nouvelle instance de la classe ClaimsIdentity à partir du flux sérialisé créé à l’aide de ISerializable.
ClaimsIdentity(String)	Initialise une nouvelle instance de la classe ClaimsIdentity avec une collection de revendications vides et le type d'authentification spécifié.
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.

Champs

DefaultIssuer	Émetteur par défaut ; « LOCAL AUTHORITY ».
DefaultNameClaimType	Type de revendication de nom par défaut ; Name.
DefaultRoleClaimType	Type de revendication de rôle par défaut ; 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.
AuthenticationType	Obtient le type d'authentification.
BootstrapContext	Obtient ou définit le jeton qui a été utilisé pour créer cette identité basée sur les revendications.
Claims	Obtient les revendications associées à cette identité basée sur les revendications.
CustomSerializationData	Contient les données supplémentaires fournies par un type dérivé. En règle générale, définie au moment de l’appel de WriteTo(BinaryWriter, Byte[]).
IsAuthenticated	Obtient une valeur qui indique que l'identité a été authentifiée.
Label	Obtient ou définit l'étiquette de cette identité basée sur les revendications.
Name	Obtient le nom de cette identité basée sur les revendications.
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.
RoleClaimType	Obtient le type de revendication qui est interprétée comme un rôle .NET entre les revendications dans cette identité basée sur les revendications.

Méthodes

AddClaim(Claim)	Ajoute une revendication unique à cette identité des revendications.
AddClaims(IEnumerable<Claim>)	Ajoute une liste de revendications à cette identité de revendications.
Clone()	Retourne une nouvelle ClaimsIdentity copiée à partir de cette identité basée sur les revendications.
CreateClaim(BinaryReader)	Fournit un point d’extensibilité pour les types dérivés afin de créer un Claim personnalisé.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
FindAll(Predicate<Claim>)	Récupère toutes les revendications qui sont mises en correspondance par le prédicat spécifié.
FindAll(String)	Récupère toutes les revendications qui ont le type de revendication spécifié.
FindFirst(Predicate<Claim>)	Extrait la première revendication qui est mise en correspondance par le prédicat spécifié.
FindFirst(String)	Extrait la première revendication avec le type de revendication spécifié.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetObjectData(SerializationInfo, StreamingContext)	Renseigne des SerializationInfo avec les données nécessaires à la sérialisation de l'objet ClaimsIdentity actuel.
GetType()	Obtient le Type de l'instance actuelle. (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é.
HasClaim(String, String)	Détermine si cette identité des revendications a une revendication avec le type et la valeur de revendication spécifiques.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
RemoveClaim(Claim)	Tente de supprimer une revendication dans l'identité basée sur les revendications.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)
TryRemoveClaim(Claim)	Tente de supprimer une revendication dans l'identité basée sur les revendications.
WriteTo(BinaryWriter)	Sérialise à l’aide d’un BinaryWriter.
WriteTo(BinaryWriter, Byte[])	Sérialise à l’aide d’un BinaryWriter.

S’applique à