Claim Classe

Definição

public ref class Claim

public class Claim

[System.Serializable]
public class Claim

type Claim = class

[<System.Serializable>]
type Claim = class

Public Class Claim

Herança

Object

Claim

Atributos

SerializableAttribute

Exemplos

O exemplo a seguir extrai as declarações associadas ao usuário autenticado que executa uma solicitação HTTP e as grava na resposta HTTP. O usuário atual é lido do HttpContext como um ClaimsPrincipal e as declarações são lidas dele. Em seguida, as declarações são gravadas no 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>");  
   }  

}  

Comentários

Uma declaração é uma declaração sobre um assunto por um emissor. As declarações representam atributos do assunto que são úteis no contexto de operações de autenticação e autorização. Entidades e emissores são entidades que fazem parte de um cenário de identidade. Alguns exemplos típicos de um assunto são: um usuário, um aplicativo ou serviço, um dispositivo ou um computador. Alguns exemplos típicos de um emissor são: o sistema operacional, um aplicativo, um serviço, um provedor de funções, um provedor de identidade ou um provedor de federação. Um emissor entrega declarações emitindo tokens de segurança, normalmente por meio de um STS (Serviço de Token de Segurança). (No WIF, você pode criar um STS derivando da SecurityTokenService classe .) Às vezes, a coleção de declarações recebidas de um emissor pode ser estendida por atributos de entidade armazenados diretamente no recurso. Uma declaração pode ser avaliada para determinar os direitos de acesso a dados e outros recursos protegidos durante o processo de autorização e também pode ser usada para tomar ou expressar decisões de autenticação sobre um assunto.

A partir do .NET 4.5, as classes do WIF (Windows Identity Foundation), que implementam a identidade baseada em declarações, foram totalmente integradas ao .NET Framework. O conceito de declarações é implementado pela Claim classe .

O seguinte descreve propriedades importantes da Claim classe :

• A Type propriedade é uma cadeia de caracteres (normalmente um URI) que contém as informações semânticas sobre a declaração; ela informa o que significa o valor da declaração. Por exemplo, uma declaração com um tipo de declaração de GivenName ("http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname") representa o nome de um usuário. O valor da Type propriedade pode ser um dos tipos de declaração conhecidos definidos na ClaimTypes classe ou pode ser um URI arbitrário, conforme definido pelo emissor. Por exemplo, um tipo de declaração "urn:spendinglimit" pode representar um atributo de usuário que faz sentido dentro do contexto de negócios do emissor.

• A Value propriedade contém o valor da declaração. Para reduzir dependências e simplificar a administração, no WIF, o valor de uma declaração é representado apenas como uma cadeia de caracteres. Para tipos de valor mais complexos, é recomendável que você use tipos de esquema XML padrão para indicar como o valor deve ser serializado e desserializado de uma cadeia de caracteres.

• A ValueType propriedade contém uma cadeia de caracteres que identifica as informações de tipo para o valor. Essa propriedade deve ser usada para entender o formato do valor e fornecer informações sobre como desserializá-lo. Se sua solução exigir tipos de valor complexos, é recomendável que você use tipos de esquema XML padrão na ValueType propriedade para indicar como a Value propriedade deve ser serializada e desserializada de uma cadeia de caracteres.

• A Subject propriedade é um ClaimsIdentity objeto que representa o assunto da declaração. O assunto da declaração é a entidade (normalmente o usuário que está solicitando acesso a um recurso) sobre a qual a declaração é declarada. O ClaimsIdentity contém, entre suas propriedades, uma coleção de declarações que descrevem as propriedades e os atributos da entidade como atestados por um ou mais emissores.

• A Issuer propriedade contém o nome da entidade que emitiu a declaração. O emissor de uma declaração é representado no WIF por uma cadeia de caracteres que contém um nome obtido de uma lista de emissores conhecidos que é mantido pelo registro de nome do emissor. O registro de nome do emissor é uma instância de uma classe derivada da IssuerNameRegistry classe . O registro de nome do emissor associa um nome mnemônico ao material criptográfico necessário para verificar as assinaturas de tokens produzidos pelo emissor correspondente. Por exemplo, a ConfigurationBasedIssuerNameRegistry classe , disponível pronta para uso com o .NET 4.5, associa o nome mnemônico para cada emissor ao certificado X.509 correspondente. A lista de emissores conhecidos normalmente é criada no momento da inicialização pelo registro de nome do emissor. A lista usada pelo ConfigurationBasedIssuerNameRegistry é especificada no arquivo de configuração do aplicativo.

• A OriginalIssuer propriedade contém o nome da entidade que originalmente emitiu a declaração. Essa propriedade foi projetada para facilitar cenários em que uma declaração pode passar por vários emissores antes de ser apresentada pelo cliente ao aplicativo RP; como cenários de federação. Você pode examinar a OriginalIssuer propriedade para determinar a entidade que originalmente emitiu a declaração. O nome é obtido da lista de emissores conhecidos mantidos pelo registro de nome do emissor, como no caso da Issuer propriedade .

Construtores

Propriedades

Métodos

Aplica-se a

Confira também

• ClaimsIdentity
• ClaimsPrincipal
• IssuerNameRegistry