ClaimsIdentity Classe

Definição

Namespace:

System.Security.Claims

Assemblies:

netstandard.dll, System.Security.Claims.dll

Origem:

ClaimsIdentity.cs

Representa uma identidade baseada em declarações.

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

Herança

Object

ClaimsIdentity

Derivado

System.Security.Principal.GenericIdentity

System.Security.Principal.WindowsIdentity

Implementações

IIdentity

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. Diz-se que tal entidade é objeto da reivindicação. Uma declaração é representada pela Claim classe. As declarações contidas em uma ClaimsIdentity entidade 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 a 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 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 ClaimsIdentity e descrevem suas propriedades por meio de uma coleção de declarações. Isso é diferente das versões anteriores do .NET Framework, nas quais 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 consultas integradas à linguagem (LINQ). 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 e não 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 total confiança.

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 em 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 as propriedades 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 do e BootstrapContext das Actor propriedades.

Construtores

Nome	Description
ClaimsIdentity()	Inicializa uma nova instância da ClaimsIdentity classe com uma coleção de declarações vazia.
ClaimsIdentity(BinaryReader, StringComparison)	Inicializa uma instância com ClaimsIdentity a especificada BinaryReader.
ClaimsIdentity(BinaryReader)	Inicializa uma instância com ClaimsIdentity a especificada BinaryReader.
ClaimsIdentity(ClaimsIdentity, StringComparison)	Inicializa uma nova instância da classe de ClaimsIdentity uma instância existente ClaimsIdentity .
ClaimsIdentity(ClaimsIdentity)	Inicializa uma nova instância da classe de ClaimsIdentity uma instância existente ClaimsIdentity .
ClaimsIdentity(IEnumerable<Claim>, String, String, String)	Inicializa uma nova instância da classe com as declarações, o tipo de autenticação, o tipo de declaração de nome e o tipo de ClaimsIdentity declaração de função especificados.
ClaimsIdentity(IEnumerable<Claim>, String)	Inicializa uma nova instância da ClaimsIdentity classe com o tipo de autenticação e declarações especificados.
ClaimsIdentity(IEnumerable<Claim>)	Inicializa uma nova instância da ClaimsIdentity classe usando uma coleção enumerada de Claim objetos.
ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String, StringComparison)	Inicializa uma nova instância da classe ClaimsIdentity.
ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String)	Inicializa uma nova instância da classe do ClaimsIdentity especificado IIdentity usando as declarações especificadas, o tipo de autenticação, o tipo de declaração de nome e o tipo de declaração de função.
ClaimsIdentity(IIdentity, IEnumerable<Claim>)	Inicializa uma nova instância da ClaimsIdentity classe usando as declarações especificadas e as especificadas IIdentity.
ClaimsIdentity(IIdentity)	Inicializa uma nova instância da ClaimsIdentity classe usando o nome e o tipo de autenticação do especificado IIdentity.
ClaimsIdentity(SerializationInfo, StreamingContext)	Obsoleto. Inicializa uma nova instância da classe de ClaimsIdentity um fluxo serializado criado usando ISerializable.
ClaimsIdentity(SerializationInfo)	Obsoleto. Inicializa uma nova instância da classe de ClaimsIdentity um fluxo serializado criado usando ISerializable.
ClaimsIdentity(String, String, String)	Inicializa uma nova instância da ClaimsIdentity classe com o tipo de autenticação, o tipo de declaração de nome e o tipo de declaração de função especificados.
ClaimsIdentity(String)	Inicializa uma nova instância da ClaimsIdentity classe com uma coleção de declarações vazia e o tipo de autenticação especificado.

Campos

Nome	Description
DefaultIssuer	O emissor padrão; "AUTORIDADE LOCAL".
DefaultNameClaimType	O tipo de declaração de nome padrão; Name.
DefaultRoleClaimType	O tipo de declaração de função padrão; Role.

Propriedades

Nome	Description
Actor	Obtém ou define a identidade da parte chamada que recebeu direitos de delegação.
AuthenticationType	Obtém o tipo de autenticação.
BootstrapContext	Obtém ou define o token que foi usado para criar essa identidade de declarações.
Claims	Obtém as declarações associadas a essa identidade de 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 dessa identidade de declaração.
Name	Obtém o nome dessa identidade de declaração.
NameClaimType	Obtém o tipo de declaração usado para determinar quais declarações fornecem o valor para a Name propriedade dessa identidade de declaração.
RoleClaimType	Obtém o tipo de declaração que será interpretado como uma função .NET entre as declarações nessa identidade de declaração.

Métodos

Nome	Description
AddClaim(Claim)	Adiciona uma única declaração a essa identidade de declarações.
AddClaims(IEnumerable<Claim>)	Adiciona uma lista de declarações a essa identidade de declarações.
Clone()	Retorna uma nova ClaimsIdentity cópia dessa identidade de declaração.
CreateClaim(BinaryReader)	Fornece um ponto de extensibilidade para tipos derivados criarem um personalizado Claim.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindAll(Predicate<Claim>)	Recupera todas as declarações correspondentes 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 que é correspondida pelo 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 os SerializationInfo dados necessários para serializar o objeto atual ClaimsIdentity .
GetType()	Obtém o Type da instância atual. (Herdado de Object)
HasClaim(Predicate<Claim>)	Determina se essa identidade de declaração tem uma declaração que é correspondida pelo predicado especificado.
HasClaim(String, String)	Determina se essa identidade de declaração tem uma declaração com o tipo de declaração e o valor especificados.
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
RemoveClaim(Claim)	Tenta remover uma declaração da identidade das 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 das declarações.
WriteTo(BinaryWriter, Byte[])	Serializa usando um BinaryWriter.
WriteTo(BinaryWriter)	Serializa usando um BinaryWriter.

Confira também

• Claim
• ClaimsPrincipal
• GenericIdentity
• WindowsIdentity
• FormsIdentity