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 seguinte extrai as reivindicações associadas ao utilizador autenticado que realiza um pedido HTTP e escreve-as na resposta HTTP. O utilizador atual é lido a partir do HttpContext como a ClaimsPrincipal e as reivindicações são lidas a partir dele. As reivindicações são então escritas 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>");
   }

}

Observações

Uma reclamação é uma declaração sobre um assunto feita por um emissor. As reivindicações representam atributos do sujeito que são úteis no contexto de operações de autenticação e autorização. Sujeitos e emissores são ambos entidades que fazem parte de um cenário de identidade. Alguns exemplos típicos de um assunto são: um utilizador, uma aplicação ou serviço, um dispositivo ou um computador. Alguns exemplos típicos de um emissor são: o sistema operativo, uma aplicação, um serviço, um fornecedor de papéis, um fornecedor de identidade ou um fornecedor de federação. Um emissor apresenta reivindicações emitindo tokens de segurança, normalmente através de um Serviço de Token de Segurança (STS). Por vezes, a coleção de reivindicações recebidas de um emissor pode ser alargada por atributos sujeitos armazenados diretamente no recurso. Uma reivindicação pode ser avaliada para determinar direitos de acesso a dados e outros recursos seguros durante o processo de autorização e também pode ser usada para tomar ou expressar decisões de autenticação sobre um sujeito.

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

Segue-se a descrição das propriedades importantes da Claim classe:

• A Type propriedade é uma cadeia de caracteres (tipicamente um URI) que contém a informação semântica sobre a reivindicação; indica-lhe o valor da reivindicação. Por exemplo, uma reivindicação com um tipo de reivindicação (GivenName"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname") representa o primeiro nome de um utilizador. O valor da Type propriedade pode ser um dos tipos de reivindicações bem conhecidos definidos na ClaimTypes classe, ou pode ser um URI arbitrário conforme definido pelo emissor. Por exemplo, um tipo de reclamação "urn:spendinglimit" pode representar um atributo de utilizador que faz sentido no contexto empresarial do emissor.

• A Value propriedade contém o valor da reivindicação. Para reduzir dependências e simplificar a administração, no WIF o valor de uma reivindicação é representado apenas como uma cadeia. Para tipos de valor mais complexos, recomenda-se que utilize tipos de esquema XML padrão para indicar como o valor deve ser serializado e desserializado a partir de uma cadeia.

• A ValueType propriedade contém uma cadeia que identifica a informação do tipo para o valor. Esta propriedade deve ser usada para compreender o formato do valor e fornecer informações sobre como o desserializar. Se a sua solução exigir tipos de valor complexos, recomenda-se que utilize tipos padrão de esquema XML na ValueType propriedade para indicar como a Value propriedade deve ser serializada e desserializada a partir de uma cadeia.

• A Subject propriedade é um ClaimsIdentity objeto que representa o sujeito da reivindicação. O sujeito da reclamação é a entidade (normalmente o utilizador que solicita acesso a um recurso) sobre a qual a reivindicação é invocada. Contém ClaimsIdentity , entre as suas propriedades, uma coleção de reivindicações que descrevem as propriedades e atributos do sujeito, conforme atestados por um ou mais emissores.

• A Issuer propriedade contém o nome da entidade que emitiu a reclamação. O emitente de uma reivindicação é representado na WIF por uma cadeia que contém um nome retirado de uma lista de emissores bem conhecidos mantida pelo registo de nomes do emissor. O registo de nomes do emissor é uma instância de uma classe que deriva dessa IssuerNameRegistry classe. O registo de nomes do emissor associa um nome mnemónico ao material criptográfico necessário para verificar as assinaturas dos tokens produzidos pelo emissor correspondente. Por exemplo, a classe ConfigurationBasedIssuerNameRegistry, disponível de fábrica com .NET 4.5, associa o nome mnemónico de cada emissor ao respetivo certificado X.509. A lista de emissores conhecidos é normalmente construída no momento de arranque pelo registo de nomes do emissor. A lista usada pelo ConfigurationBasedIssuerNameRegistry é especificada no ficheiro de configuração da aplicação.

• A OriginalIssuer propriedade contém o nome da entidade que originalmente emitiu a reivindicação. Esta propriedade foi concebida para facilitar cenários em que uma reclamação pode passar por vários emissores antes de ser apresentada pelo cliente à aplicação RP; como cenários de federação. Pode examinar a OriginalIssuer propriedade para determinar a entidade que originalmente emitiu a reclamação. O nome é retirado da lista de emissores conhecidos mantida pelo registo de nomes do emitente, como no caso da Issuer propriedade.

Ver também

• ClaimsIdentity
• ClaimsPrincipal
• IssuerNameRegistry