ClaimsIdentity ClaimsIdentity ClaimsIdentity ClaimsIdentity Class

Definición

Representa una identidad basada en notificaciones.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
Herencia
ClaimsIdentityClaimsIdentityClaimsIdentityClaimsIdentity
Atributos
Implementaciones

Comentarios

La ClaimsIdentity clase es una implementación concreta de una identidad basada en notificaciones; es decir, una identidad descrita por una colección de notificaciones.The ClaimsIdentity class is a concrete implementation of a claims-based identity; that is, an identity described by a collection of claims. Una demanda es una instrucción sobre una entidad realizada por un emisor que describe una propiedad, un derecho o alguna otra calidad de la entidad.A claim is a statement about an entity made by an issuer that describes a property, right, or some other quality of that entity. Se dice que dicha entidad es el asunto de la demanda.Such an entity is said to be the subject of the claim. Una demanda se representa mediante la Claim clase.A claim is represented by the Claim class. Las notificaciones contenidas en un ClaimsIdentity describen la entidad que representa la identidad correspondiente y se pueden usar para tomar decisiones de autorización y autenticación.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 modelo de acceso basado en notificaciones tiene muchas ventajas en comparación con los modelos de acceso más tradicionales que se basan exclusivamente en roles.A claims-based access model has many advantages over more traditional access models that rely exclusively on roles. Por ejemplo, las notificaciones pueden proporcionar información mucho más completa sobre la identidad que representan y se pueden evaluar para la autorización o autenticación de una manera mucho más específica.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.

A partir de .NET Framework 4,5, Windows Identity Foundation (WIF) y la identidad basada en notificaciones se han integrado completamente en el .NET Framework.Beginning with .NET Framework 4.5, Windows Identity Foundation (WIF) and claims-based identity have been fully integrated into the .NET Framework. Esto significa que muchas clases que representan una identidad en el .NET Framework ahora derivan ClaimsIdentity de y describen sus propiedades a través de una colección de notificaciones.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. Esto es diferente de las versiones anteriores del .NET Framework, en el que estas clases implementaban IIdentity la interfaz directamente.This is different from previous versions of the .NET Framework, in which, these classes implemented the IIdentity interface directly. Se puede tener acceso a la colección de notificaciones que describen la identidad Claims a través de la propiedad.The collection of claims that describe the identity can be accessed through the Claims property. La ClaimsIdentity clase proporciona varios métodos para buscar y modificar notificaciones y es totalmente compatible con las consultas integradas de lenguaje (LINQ).The ClaimsIdentity class provides several methods for finding and modifying claims and fully supports language integrated queries (LINQ). En el código de ClaimsIdentity aplicación, normalmente se tiene acceso ClaimsPrincipal a los objetos a través de objetos; por Thread.CurrentPrincipalejemplo, la entidad de seguridad devuelta por.In application code, ClaimsIdentity objects are typically accessed through ClaimsPrincipal objects; for example, the principal returned by Thread.CurrentPrincipal.

Nota

La ClaimsPrincipal clase también tiene Claims una propiedad.The ClaimsPrincipal class has a Claims property as well. En la mayoría de los casos, debe tener acceso a las notificaciones ClaimsPrincipal.Claims del usuario a través de Claims la colección en lugar de hacerlo a través de la colección.In the majority of cases you should access the user's claims through the ClaimsPrincipal.Claims collection rather than through the Claims collection. Tendrá que acceder a las notificaciones de un individuo ClaimsIdentity solo en los casos en los que la entidad de seguridad ClaimsIdentity contenga más de una y necesite evaluar o modificar una identidad específica.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.

Importante

Para agregar o quitar notificaciones de Claims la colección, un llamador debe tener plena confianza.To add or remove claims from the Claims collection, a caller must have full trust.

En el modelo basado en notificaciones, IIdentity.Name la propiedad y IPrincipal.IsInRole(String) el método se implementan mediante la evaluación de las notificaciones contenidas en una identidad.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. Las implementaciones base del modelo basado en notificaciones se proporcionan mediante la ClaimsIdentity.Name propiedad y el ClaimsPrincipal.IsInRole método.The base implementations in the claims-based model are provided by the ClaimsIdentity.Name property and the ClaimsPrincipal.IsInRole method. Las NameClaimType propiedades RoleClaimType y permiten especificar un tipo de notificación que se debe usar para evaluar las notificaciones contenidas por la identidad al realizar estas operaciones.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.

Los escenarios de delegación se admiten BootstrapContext a través de las Actor propiedades y.Delegation scenarios are supported through the Actor and BootstrapContext properties.

Constructores

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

Inicializa una nueva instancia de la clase ClaimsIdentity con una colección de reclamaciones vacía.Initializes a new instance of the ClaimsIdentity class with an empty claims collection.

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

Inicializa una instancia de ClaimsIdentity con BinaryReader especificado.Initializes an instance of ClaimsIdentity with the specified BinaryReader.

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

Inicializa una nueva instancia de la clase ClaimsIdentity a partir de una instancia ClaimsIdentity existente.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>)

Inicializa una nueva instancia de la clase ClaimsIdentity usando una colección enumerada de objetos Claim.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)

Inicializa una nueva instancia de la clase ClaimsIdentity con las reclamaciones y tipo de autenticación especificados.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)

Inicializa una nueva instancia de la clase ClaimsIdentity donde se especifican las notificaciones, el tipo de autenticación, el tipo de notificación de nombre y el tipo de notificación de rol.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)

Inicializa una nueva instancia de la clase ClaimsIdentity usando el tipo de nombre y autenticación a partir del IIdentity especificado.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>)

Inicializa una nueva instancia de la clase ClaimsIdentity usando las reclamaciones especificadas y el IIdentity especificado.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)

Inicializa una nueva instancia de la clase ClaimsIdentity a partir de la IIdentity especificada y usa las notificaciones, tipo de autenticación, tipo de notificación de nombre y tipo de notificación de rol especificados.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)

Inicializa una nueva instancia de la clase ClaimsIdentity a partir de una secuencia serializada creada mediante ISerializable.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)

Inicializa una nueva instancia de la clase ClaimsIdentity a partir de una secuencia serializada creada mediante ISerializable.Initializes a new instance of the ClaimsIdentity class from a serialized stream created by using ISerializable.

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

Inicializa una nueva instancia de la clase ClaimsIdentity con una colección de notificaciones vacía y el tipo de autenticación especificado.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)

Inicializa una nueva instancia de la clase ClaimsIdentity con el tipo de autenticación, tipo de reclamación de nombre y tipo de reclamación de rol especificados.Initializes a new instance of the ClaimsIdentity class with the specified authentication type, name claim type, and role claim type.

Campos

DefaultIssuer DefaultIssuer DefaultIssuer DefaultIssuer

Emisor predeterminado; "LOCAL AUTHORITY".The default issuer; "LOCAL AUTHORITY".

DefaultNameClaimType DefaultNameClaimType DefaultNameClaimType DefaultNameClaimType

Tipo de notificación de nombre predeterminado; Name.The default name claim type; Name.

DefaultRoleClaimType DefaultRoleClaimType DefaultRoleClaimType DefaultRoleClaimType

Tipo de notificación de rol predeterminado; Role.The default role claim type; Role.

Propiedades

Actor Actor Actor Actor

Obtiene o establece la identidad del usuario que llama al que se han concedido derechos de delegación.Gets or sets the identity of the calling party that was granted delegation rights.

AuthenticationType AuthenticationType AuthenticationType AuthenticationType

Obtiene el tipo de autenticación.Gets the authentication type.

BootstrapContext BootstrapContext BootstrapContext BootstrapContext

Obtiene o establece el token que se usó para crear estas notificaciones de identidad.Gets or sets the token that was used to create this claims identity.

Claims Claims Claims Claims

Obtiene las notificaciones asociadas con esta identidad de notificación.Gets the claims associated with this claims identity.

CustomSerializationData CustomSerializationData CustomSerializationData CustomSerializationData

Contiene datos adicionales proporcionados por un tipo derivado.Contains any additional data provided by a derived type. Se establece normalmente cuando se llama a WriteTo(BinaryWriter, Byte[]).Typically set when calling WriteTo(BinaryWriter, Byte[]).

IsAuthenticated IsAuthenticated IsAuthenticated IsAuthenticated

Obtiene un valor que indica si la identidad se ha autenticado.Gets a value that indicates whether the identity has been authenticated.

Label Label Label Label

Obtiene o establece la etiqueta para esta identidad de notificaciones.Gets or sets the label for this claims identity.

Name Name Name Name

Obtiene el nombre de esta identidad de notificación.Gets the name of this claims identity.

NameClaimType NameClaimType NameClaimType NameClaimType

Obtiene el tipo de notificación que se usa para determinar qué notificaciones proporcionan el valor de la propiedad Name de esta identidad de notificación.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

Obtiene el tipo de notificación que se interpreta como rol de .NET Framework entre las notificaciones en esta identidad de notificación.Gets the claim type that will be interpreted as a .NET Framework role among the claims in this claims identity.

Métodos

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

Agrega una sola reclamación a esta identidad de reclamaciones.Adds a single claim to this claims identity.

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

Agrega una lista de reclamaciones a esta identidad de reclamaciones.Adds a list of claims to this claims identity.

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

Devuelve un objeto ClaimsIdentity nuevo copiado de esta identidad de reclamaciones.Returns a new ClaimsIdentity copied from this claims identity.

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

Proporciona un punto de extensibilidad para tipos derivados para crear un Claim personalizado.Provides an extensibility point for derived types to create a custom Claim.

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

Determina si el objeto especificado es igual al objeto actual.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>)

Recupera todas las notificaciones que coinciden con el predicado especificado.Retrieves all of the claims that are matched by the specified predicate.

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

Recupera todas las notificaciones con el tipo de notificación especificado.Retrieves all of the claims that have the specified claim type.

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

Recupera la primera reclamación con la que coincide el predicado especificado.Retrieves the first claim that is matched by the specified predicate.

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

Recupera la primera reclamación con el tipo especificado.Retrieves the first claim with the specified claim type.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Rellena el objeto SerializationInfo con los datos necesarios para serializar el objeto ClaimsIdentity actual.Populates the SerializationInfo with data needed to serialize the current ClaimsIdentity object.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Determina si esta identidad de notificaciones tiene una notificación que coincide con el predicado especificado.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)

Determina si esta identidad de notificaciones tiene una notificación con el tipo y el valor especificados.Determines whether this claims identity has a claim with the specified claim type and value.

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

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Se intenta quitar una reclamación de la identidad de reclamaciones.Attempts to remove a claim from the claims identity.

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

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

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

Se intenta quitar una reclamación de la identidad de reclamaciones.Attempts to remove a claim from the claims identity.

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

Se serializa usando un BinaryWriter.Serializes using a BinaryWriter.

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

Se serializa usando un BinaryWriter.Serializes using a BinaryWriter.

Se aplica a

Consulte también: