Claim Clase

Definición

public ref class Claim

public class Claim

[System.Serializable]
public class Claim

type Claim = class

[<System.Serializable>]
type Claim = class

Public Class Claim

Herencia

Object

Claim

Atributos

SerializableAttribute

Ejemplos

En el ejemplo siguiente se extraen las notificaciones asociadas al usuario autenticado que realiza una solicitud HTTP y se escriben en la respuesta HTTP. El usuario actual se lee de HttpContext como ClaimsPrincipal y las notificaciones se leen de él. Después, las notificaciones se escriben en el HttpResponse objeto .

ClaimsPrincipal principal = HttpContext.Current.User as ClaimsPrincipal;  
if (null != principal)  
{  
   foreach (Claim claim in principal.Claims)  
   {  
      Response.Write("CLAIM TYPE: " + claim.Type + "; CLAIM VALUE: " + claim.Value + "</br>");  
   }  

}  

Comentarios

Una notificación es una instrucción sobre un sujeto por un emisor. Las notificaciones representan atributos del asunto que son útiles en el contexto de las operaciones de autenticación y autorización. Los sujetos y emisores son ambas entidades que forman parte de un escenario de identidad. Algunos ejemplos típicos de un asunto son: un usuario, una aplicación o un servicio, un dispositivo o un equipo. Algunos ejemplos típicos de un emisor son: el sistema operativo, una aplicación, un servicio, un proveedor de roles, un proveedor de identidades o un proveedor de federación. Un emisor entrega notificaciones mediante la emisión de tokens de seguridad, normalmente a través de un servicio de token de seguridad (STS). (En WIF, puede crear un STS derivando de la SecurityTokenService clase ). En ocasiones, los atributos de asunto almacenados directamente en el recurso pueden ampliar la colección de notificaciones recibidas de un emisor. Una notificación se puede evaluar para determinar los derechos de acceso a los datos y otros recursos protegidos durante el proceso de autorización y también se puede usar para tomar o expresar decisiones de autenticación sobre un sujeto.

A partir de .NET 4.5, las clases de Windows Identity Foundation (WIF), que implementan la identidad basada en notificaciones, se han integrado completamente en .NET Framework. La clase implementa el concepto de Claim notificaciones.

A continuación se describen las propiedades importantes de la Claim clase :

• La Type propiedad es una cadena (normalmente un URI) que contiene la información semántica sobre la notificación; le indica qué significa el valor de la notificación. Por ejemplo, una notificación con un tipo de notificación de GivenName ("http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname") representa el nombre de un usuario. El valor de la Type propiedad puede ser uno de los tipos de notificación conocidos definidos en la ClaimTypes clase , o puede ser un URI arbitrario tal como lo define el emisor. Por ejemplo, un tipo de notificación "urn:spendinglimit" podría representar un atributo de usuario que tenga sentido en el contexto empresarial del emisor.

• La Value propiedad contiene el valor de la notificación. Para reducir las dependencias y simplificar la administración, en WIF, el valor de una notificación solo se representa como una cadena. Para los tipos de valor más complejos, se recomienda usar tipos de esquema XML estándar para indicar cómo se va a serializar el valor en una cadena y deserializar desde una cadena.

• La ValueType propiedad contiene una cadena que identifica la información de tipo para el valor. Esta propiedad debe usarse para comprender el formato del valor y para proporcionar información sobre cómo deserializarlo. Si la solución requiere tipos de valor complejos, se recomienda usar tipos de esquema XML estándar en la ValueType propiedad para indicar cómo se va a serializar la Value propiedad en una cadena y deserializarla.

• La Subject propiedad es un ClaimsIdentity objeto que representa el asunto de la notificación. El asunto de la notificación es la entidad (normalmente, el usuario que solicita acceso a un recurso) sobre el que se afirma la notificación. ClaimsIdentity contiene, entre sus propiedades, una colección de notificaciones que describen las propiedades y atributos del asunto según atestigua uno o varios emisores.

• La Issuer propiedad contiene el nombre de la entidad que emitió la notificación. El emisor de una notificación se representa en WIF mediante una cadena que contiene un nombre tomado de una lista de emisores conocidos que mantiene el registro de nombres del emisor. El registro de nombres del emisor es una instancia de una clase que deriva de la IssuerNameRegistry clase . El registro de nombres del emisor asocia un nombre mnemónico al material criptográfico necesario para comprobar las firmas de los tokens generados por el emisor correspondiente. Por ejemplo, la ConfigurationBasedIssuerNameRegistry clase , disponible de forma predeterminada con .NET 4.5, asocia el nombre mnemónico para cada emisor con su certificado X.509 correspondiente. La lista de emisores conocidos suele compilarse en tiempo de inicio mediante el registro de nombres del emisor. La lista usada por ConfigurationBasedIssuerNameRegistry se especifica en el archivo de configuración de la aplicación.

• La OriginalIssuer propiedad contiene el nombre de la entidad que emitió originalmente la notificación. Esta propiedad está diseñada para facilitar escenarios en los que una notificación puede pasar a través de varios emisores antes de que el cliente lo presente en la aplicación rp; como escenarios de federación. Puede examinar la OriginalIssuer propiedad para determinar la entidad que emitió originalmente la notificación. El nombre se toma de la lista de emisores conocidos mantenidos por el registro de nombres del emisor, como en el caso de la Issuer propiedad .

Constructores

Propiedades

Métodos

Se aplica a

Consulte también

• ClaimsIdentity
• ClaimsPrincipal
• IssuerNameRegistry