Compartilhar via


ClaimsIdentity Classe

Definição

Representa uma identidade baseada em declarações.

public ref class ClaimsIdentity : System::Security::Principal::IIdentity
public 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
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type ClaimsIdentity = class
    interface IIdentity
Public Class ClaimsIdentity
Implements IIdentity
Herança
ClaimsIdentity
Derivado
Atributos
Implementações

Comentários

A ClaimsIdentity classe é uma implementação concreta de uma identidade baseada em declarações; ou seja, uma identidade descrita por uma coleção de declarações. Uma declaração é uma declaração sobre uma entidade feita por um emissor que descreve uma propriedade, um direito ou alguma outra qualidade dessa entidade. Essa entidade é considerada o assunto da declaração. Uma declaração é representada pela Claim classe . As declarações contidas em uma ClaimsIdentity descrevem a entidade que a identidade correspondente representa e podem ser usadas para tomar decisões de autorização e autenticação. Um modelo de acesso baseado em declarações tem muitas vantagens em relação aos modelos de acesso mais tradicionais que dependem exclusivamente de funções. Por exemplo, as declarações podem fornecer informações muito mais avançadas sobre a identidade que representam e podem ser avaliadas para autorização ou autenticação de uma maneira muito mais específica.

A partir do .NET Framework 4.5, o WIF (Windows Identity Foundation) e a identidade baseada em declarações foram totalmente integrados ao .NET Framework. Isso significa que muitas classes que representam uma identidade no .NET Framework agora derivam de ClaimsIdentity e descrevem suas propriedades por meio de uma coleção de declarações. Isso é diferente das versões anteriores do .NET Framework, em que essas classes implementaram a IIdentity interface diretamente. A coleção de declarações que descrevem a identidade pode ser acessada por meio da Claims propriedade . A ClaimsIdentity classe fornece vários métodos para localizar e modificar declarações e dá suporte total a LINQ (consultas integradas à linguagem). No código do aplicativo, ClaimsIdentity os objetos normalmente são acessados por meio ClaimsPrincipal de objetos ; por exemplo, a entidade de segurança retornada por Thread.CurrentPrincipal.

Observação

A ClaimsPrincipal classe também tem uma Claims propriedade . Na maioria dos casos, você deve acessar as declarações do usuário por meio da ClaimsPrincipal.Claims coleção, em vez de por meio da Claims coleção. Você precisará acessar as declarações de um indivíduo ClaimsIdentity somente nos casos em que a entidade de segurança contém mais de uma ClaimsIdentity e você precisa avaliar ou modificar uma identidade específica.

Importante

Para adicionar ou remover declarações da Claims coleção, um chamador deve ter confiança total.

No modelo baseado em declarações, a IIdentity.Name propriedade e o IPrincipal.IsInRole(String) método são implementados avaliando as declarações contidas por uma identidade. As implementações base no modelo baseado em declarações são fornecidas pela ClaimsIdentity.Name propriedade e pelo ClaimsPrincipal.IsInRole método . As NameClaimType propriedades e RoleClaimType permitem que você especifique um tipo de declaração que deve ser usado para avaliar as declarações contidas pela identidade ao executar essas operações.

Há suporte para cenários de delegação por meio das Actor propriedades e BootstrapContext .

Construtores

ClaimsIdentity()

Inicializa uma nova instância da classe ClaimsIdentity com uma coleção de declarações vazias.

ClaimsIdentity(BinaryReader)

Inicializa uma instância de ClaimsIdentity com o BinaryReader especificado.

ClaimsIdentity(ClaimsIdentity)

Inicializa uma nova instância da classe ClaimsIdentity de uma instância ClaimsIdentity existente.

ClaimsIdentity(IEnumerable<Claim>)

Inicializa uma nova instância da classe ClaimsIdentity usando uma coleção de objetos Claim enumerados.

ClaimsIdentity(IEnumerable<Claim>, String)

Inicializa uma nova instância da classe ClaimsIdentity com as declarações e o tipo de autenticação especificados.

ClaimsIdentity(IEnumerable<Claim>, String, String, String)

Inicializa uma nova instância da classe ClaimsIdentity com as declarações, o tipo de autenticação, tipo de declaração de nome e tipo de declaração de função especificados.

ClaimsIdentity(IIdentity)

Inicializa uma nova instância da classe ClaimsIdentity usando o nome e o tipo de autenticação do IIdentity especificado.

ClaimsIdentity(IIdentity, IEnumerable<Claim>)

Inicializa uma nova instância da classe ClaimsIdentity usando as declarações especificadas e o IIdentity especificado.

ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String)

Inicializa uma nova instância da classe ClaimsIdentity no IIdentity especificado usando as declarações, o tipo de autenticação, tipo de declaração de nome e tipo de declaração de função especificados.

ClaimsIdentity(SerializationInfo)
Obsoleto.

Inicializa uma nova instância da classe ClaimsIdentity de um fluxo serializado criado usando ISerializable.

ClaimsIdentity(SerializationInfo, StreamingContext)
Obsoleto.

Inicializa uma nova instância da classe ClaimsIdentity de um fluxo serializado criado usando ISerializable.

ClaimsIdentity(String)

Inicializa uma nova instância da classe ClaimsIdentity com uma coleção de declarações vazias e o tipo de autenticação especificado.

ClaimsIdentity(String, String, String)

Inicializa uma nova instância da classe ClaimsIdentity com o tipo de autenticação, tipo de declaração de nome e tipo de declaração de função especificados.

Campos

DefaultIssuer

O emissor padrão, "LOCAL AUTHORITY".

DefaultNameClaimType

O tipo de declaração de nome padrão, Name.

DefaultRoleClaimType

O tipo de declaração de função padrão, Role.

Propriedades

Actor

Obtém ou define a identidade da parte que realiza a chamada e que recebeu direitos de delegação.

AuthenticationType

Obtém o tipo de autenticação.

BootstrapContext

Obtém ou define o token usado para criar esta identidade de declarações.

Claims

Obtém as declarações associadas com esta identidade baseada em declarações.

CustomSerializationData

Contém quaisquer dados adicionais fornecidos por um tipo derivado. Normalmente definido ao chamar WriteTo(BinaryWriter, Byte[]).

IsAuthenticated

Obtém um valor que indica se a identidade foi autenticada.

Label

Obtém ou define o rótulo para essa identidade baseada em declarações.

Name

Obtém o nome dessa identidade baseada em declarações.

NameClaimType

Obtém o tipo de declaração que é usado para determinar quais declarações fornecem o valor para a propriedade Name dessa identidade baseada em declarações.

RoleClaimType

Obtém o tipo de declaração que será interpretado como uma função do .NET entre as declarações nessa identidade de declarações.

Métodos

AddClaim(Claim)

Adiciona uma única declaração a esta identidade baseada em declarações.

AddClaims(IEnumerable<Claim>)

Adiciona uma lista de declarações a essa identidade baseada em declarações.

Clone()

Retorna um novo ClaimsIdentity copiado dessa identidade baseada em declarações.

CreateClaim(BinaryReader)

Fornece um ponto de extensibilidade para tipos derivados para criar um Claim personalizado.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
FindAll(Predicate<Claim>)

Recupera todas as declarações que correspondem ao predicado especificado.

FindAll(String)

Recupera todas as declarações que têm o tipo de declaração especificado.

FindFirst(Predicate<Claim>)

Recupera a primeira declaração correspondente ao predicado especificado.

FindFirst(String)

Recupera a primeira declaração com o tipo de declaração especificado.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)

Preenche o SerializationInfo com os dados necessários para serializar o objeto de ClaimsIdentity atual.

GetType()

Obtém o Type da instância atual.

(Herdado de Object)
HasClaim(Predicate<Claim>)

Determina se essa identidade de declarações tem uma declaração que é correspondida pelo predicado especificado.

HasClaim(String, String)

Determina se essa identidade de declarações tem uma declaração com o tipo e o valor de declaração especificados.

MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
RemoveClaim(Claim)

Tenta remover uma declaração da identidade de declarações.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
TryRemoveClaim(Claim)

Tenta remover uma declaração da identidade de declarações.

WriteTo(BinaryWriter)

Serializa usando um BinaryWriter.

WriteTo(BinaryWriter, Byte[])

Serializa usando um BinaryWriter.

Aplica-se a

Confira também