ClaimsIdentity Clase

Definición

Espacio de nombres:

System.Security.Claims

Ensamblado:

System.Security.Claims.dll

Source:

ClaimsIdentity.cs

Representa una identidad basada en notificaciones.

public ref class ClaimsIdentity : System::Security::Principal::IIdentity

public class ClaimsIdentity : System.Security.Principal.IIdentity

type ClaimsIdentity = class
    interface IIdentity

Public Class ClaimsIdentity
Implements IIdentity

Herencia

Object

ClaimsIdentity

Derivado

System.Security.Principal.GenericIdentity

System.Security.Principal.WindowsIdentity

Implementaciones

IIdentity

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. Una notificación es una instrucción sobre una entidad realizada por un emisor que describe una propiedad, un derecho o alguna otra calidad de esa entidad. Se dice que dicha entidad es el sujeto de la reclamación. Una notificación se representa mediante la Claim clase . 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. Un modelo de acceso basado en notificaciones tiene muchas ventajas sobre los modelos de acceso más tradicionales que se basan exclusivamente en 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 la autenticación de una manera mucho más específica.

A partir de .NET Framework 4.5, Windows Identity Foundation (WIF) y la identidad basada en notificaciones se han integrado completamente en .NET Framework. Esto significa que muchas clases que representan una identidad en .NET Framework ahora derivan de ClaimsIdentity y describen sus propiedades a través de una colección de notificaciones. Esto es diferente de las versiones anteriores de .NET Framework, en las que estas clases implementaron la IIdentity interfaz directamente. Se puede acceder a la colección de notificaciones que describen la identidad a través de la Claims propiedad . La ClaimsIdentity clase proporciona varios métodos para buscar y modificar notificaciones y es totalmente compatible con consultas integradas de lenguaje (LINQ). En el código de aplicación, ClaimsIdentity normalmente se obtiene acceso a los objetos a través ClaimsPrincipal de objetos; por ejemplo, la entidad de seguridad devuelta por Thread.CurrentPrincipal.

Nota

La ClaimsPrincipal clase también tiene una Claims propiedad . En la mayoría de los casos, debe tener acceso a las notificaciones del usuario a través de la ClaimsPrincipal.Claims colección en lugar de a través de la Claims colección. Tendrá que acceder a las notificaciones de un individuo ClaimsIdentity solo en los casos en los que la entidad de seguridad contenga más de una ClaimsIdentity y tenga que evaluar o modificar una identidad específica.

Importante

Para agregar o quitar notificaciones de la Claims colección, un llamador debe tener plena confianza.

En el modelo basado en notificaciones, la IIdentity.Name propiedad y el IPrincipal.IsInRole(String) método se implementan mediante la evaluación de las notificaciones contenidas por una identidad. La propiedad y el ClaimsPrincipal.IsInRole método proporcionan las ClaimsIdentity.Name implementaciones base en el modelo basado en notificaciones. Las NameClaimType propiedades y RoleClaimType permiten especificar un tipo de notificación que se debe usar para evaluar las notificaciones contenidas por la identidad al realizar estas operaciones.

Los escenarios de delegación se admiten mediante las Actor propiedades y BootstrapContext .

Constructores

ClaimsIdentity()	Inicializa una nueva instancia de la clase ClaimsIdentity con una colección de reclamaciones vacía.
ClaimsIdentity(BinaryReader)	Inicializa una instancia de ClaimsIdentity con BinaryReader especificado.
ClaimsIdentity(ClaimsIdentity)	Inicializa una nueva instancia de la clase ClaimsIdentity a partir de una instancia ClaimsIdentity existente.
ClaimsIdentity(IEnumerable<Claim>)	Inicializa una nueva instancia de la clase ClaimsIdentity usando una colección enumerada de objetos Claim.
ClaimsIdentity(IEnumerable<Claim>, String)	Inicializa una nueva instancia de la clase ClaimsIdentity con las reclamaciones y tipo de autenticación especificados.
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.
ClaimsIdentity(IIdentity)	Inicializa una nueva instancia de la clase ClaimsIdentity usando el tipo de nombre y autenticación a partir del IIdentity especificado.
ClaimsIdentity(IIdentity, IEnumerable<Claim>)	Inicializa una nueva instancia de la clase ClaimsIdentity usando las reclamaciones especificadas y el IIdentity especificado.
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.
ClaimsIdentity(SerializationInfo)	Obsoletos. Inicializa una nueva instancia de la clase ClaimsIdentity a partir de una secuencia serializada creada mediante ISerializable.
ClaimsIdentity(SerializationInfo, StreamingContext)	Obsoletos. Inicializa una nueva instancia de la clase ClaimsIdentity a partir de una secuencia serializada creada mediante ISerializable.
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.
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.

Campos

DefaultIssuer	Emisor predeterminado; "LOCAL AUTHORITY".
DefaultNameClaimType	Tipo de notificación de nombre predeterminado; Name.
DefaultRoleClaimType	Tipo de notificación de rol predeterminado; Role.

Propiedades

Actor	Obtiene o establece la identidad del usuario que llama al que se han concedido derechos de delegación.
AuthenticationType	Obtiene el tipo de autenticación.
BootstrapContext	Obtiene o establece el token que se usó para crear estas notificaciones de identidad.
Claims	Obtiene las notificaciones asociadas con esta identidad de notificación.
CustomSerializationData	Contiene datos adicionales proporcionados por un tipo derivado. Se establece normalmente cuando se llama a WriteTo(BinaryWriter, Byte[]).
IsAuthenticated	Obtiene un valor que indica si la identidad se ha autenticado.
Label	Obtiene o establece la etiqueta para esta identidad de notificaciones.
Name	Obtiene el nombre de esta identidad de notificación.
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.
RoleClaimType	Obtiene el tipo de notificación que se interpreta como rol de .NET entre las notificaciones en esta identidad de notificación.

Métodos

AddClaim(Claim)	Agrega una sola reclamación a esta identidad de reclamaciones.
AddClaims(IEnumerable<Claim>)	Agrega una lista de reclamaciones a esta identidad de reclamaciones.
Clone()	Devuelve un objeto ClaimsIdentity nuevo copiado de esta identidad de reclamaciones.
CreateClaim(BinaryReader)	Proporciona un punto de extensibilidad para tipos derivados para crear un Claim personalizado.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
FindAll(Predicate<Claim>)	Recupera todas las notificaciones que coinciden con el predicado especificado.
FindAll(String)	Recupera todas las notificaciones con el tipo de notificación especificado.
FindFirst(Predicate<Claim>)	Recupera la primera reclamación con la que coincide el predicado especificado.
FindFirst(String)	Recupera la primera reclamación con el tipo especificado.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Rellena el objeto SerializationInfo con los datos necesarios para serializar el objeto ClaimsIdentity actual.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
HasClaim(Predicate<Claim>)	Determina si esta identidad de notificaciones tiene una notificación que coincide con el predicado especificado.
HasClaim(String, String)	Determina si esta identidad de notificaciones tiene una notificación con el tipo y el valor especificados.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
RemoveClaim(Claim)	Se intenta quitar una reclamación de la identidad de reclamaciones.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TryRemoveClaim(Claim)	Se intenta quitar una reclamación de la identidad de reclamaciones.
WriteTo(BinaryWriter)	Se serializa usando un BinaryWriter.
WriteTo(BinaryWriter, Byte[])	Se serializa usando un BinaryWriter.

Consulte también

• Claim
• ClaimsPrincipal
• GenericIdentity
• WindowsIdentity
• FormsIdentity