ClaimsIdentity Classe

Definição

Espaço de Nomes:: System.Security.Claims

Assemblagens:: mscorlib.dll, System.Security.Claims.dll

Assemblagens:: netstandard.dll, System.Security.Claims.dll

Assemblagem:: System.Security.Claims.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Origem:: ClaimsIdentity.cs

Origem:: ClaimsIdentity.cs

Origem:: ClaimsIdentity.cs

Origem:: ClaimsIdentity.cs

Origem:: ClaimsIdentity.cs

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa uma identidade baseada em reivindicaçõ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: Object
ClaimsIdentity

Derivado: System.Security.Principal.GenericIdentity

System.Security.Principal.WindowsIdentity

System.Web.Security.FormsIdentity

Atributos: ComVisibleAttribute SerializableAttribute

Implementações: IIdentity

Observações

A ClaimsIdentity classe é uma implementação concreta de uma identidade baseada em reivindicações; ou seja, uma identidade descrita por um conjunto de reivindicações. Uma reivindicação é uma declaração sobre uma entidade feita por um emissor que descreve uma propriedade, direito ou alguma outra qualidade dessa entidade. Diz-se que tal entidade é objeto da reivindicação. Uma reivindicação é representada pela Claim classe. As reivindicações contidas em a 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 sinistros tem muitas vantagens em relação aos modelos de acesso mais tradicionais, que dependem exclusivamente de funções. Por exemplo, as reclamações podem fornecer informações muito mais ricas sobre a identidade que representam e podem ser avaliadas para autorização ou autenticação de forma muito mais específica.

A partir do .NET Framework 4.5, o Windows Identity Foundation (WIF) e a identidade baseada em reclamações foram totalmente integrados no .NET Framework. Isto significa que muitas classes que representam uma identidade no .NET Framework derivam agora de ClaimsIdentity e descrevem as suas propriedades através de um conjunto de reivindicações. Isto é diferente das versões anteriores do .NET Framework, nas quais estas classes implementavam diretamente a interface IIdentity. A coleção de reivindicações que descrevem a identidade pode ser acedida através da Claims propriedade. A ClaimsIdentity classe fornece vários métodos para encontrar e modificar reivindicações e suporta totalmente as consultas integradas por linguagem (LINQ). No código de aplicação, ClaimsIdentity os objetos são tipicamente acedidos através de ClaimsPrincipal objetos; por exemplo, o principal devolvido por Thread.CurrentPrincipal.

Note

A ClaimsPrincipal classe também tem uma Claims propriedade. Na maioria dos casos, deve aceder às reivindicações do utilizador através da ClaimsPrincipal.Claims coleção em vez da própria Claims coleção. Terá de aceder às reivindicações de um indivíduo ClaimsIdentity apenas nos casos em que o principal contiver mais do que um ClaimsIdentity e precisar de avaliar ou modificar uma identidade específica.

Importante

Para adicionar ou remover reclamações da Claims coleção, o interlocutor deve ter total confiança.

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

Os cenários de delegação são suportados através das Actor propriedades e.BootstrapContext

Construtores

Name	Description
ClaimsIdentity()	Inicializa uma nova instância da ClaimsIdentity classe com uma coleção de reivindicações vazia.
ClaimsIdentity(BinaryReader, StringComparison)	Inicializa uma instância de ClaimsIdentity com o especificado BinaryReader.
ClaimsIdentity(BinaryReader)	Inicializa uma instância de ClaimsIdentity com o especificado BinaryReader.
ClaimsIdentity(ClaimsIdentity, StringComparison)	Inicializa uma nova instância da ClaimsIdentity classe a partir de uma instância existente ClaimsIdentity .
ClaimsIdentity(ClaimsIdentity)	Inicializa uma nova instância da ClaimsIdentity classe a partir de uma instância existente ClaimsIdentity .
ClaimsIdentity(IEnumerable<Claim>, String, String, String)	Inicializa uma nova instância da ClaimsIdentity classe com as reivindicações especificadas, tipo de autenticação, tipo de claim de nome e tipo de claim de papel.
ClaimsIdentity(IEnumerable<Claim>, String)	Inicializa uma nova instância da ClaimsIdentity classe com as reivindicações e o tipo de autenticação 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 ClaimsIdentity classe.
ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String)	Inicializa uma nova instância da ClaimsIdentity classe a partir da especificada IIdentity usando as reivindicações especificadas, tipo de autenticação, tipo de claim de nome e tipo de claim de papel.
ClaimsIdentity(IIdentity, IEnumerable<Claim>)	Inicializa uma nova instância da ClaimsIdentity classe usando as reivindicações especificadas e o .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 ClaimsIdentity classe a partir de um fluxo serializado criado usando ISerializable.
ClaimsIdentity(SerializationInfo)	Obsoleto. Inicializa uma nova instância da ClaimsIdentity classe a partir de um fluxo serializado criado usando ISerializable.
ClaimsIdentity(String, String, String)	Inicializa uma nova instância da ClaimsIdentity classe com o tipo de autenticação especificado, o tipo de claim de nome e o tipo de claim de papel.
ClaimsIdentity(String)	Inicializa uma nova instância da ClaimsIdentity classe com uma coleção de reivindicações vazia e o tipo de autenticação especificado.

Campos

Name	Description
DefaultIssuer	O emissor padrão; "AUTORIDADE LOCAL".
DefaultNameClaimType	O tipo padrão de reivindicação do nome; Name.
DefaultRoleClaimType	O tipo padrão de reivindicação de papel; Role.

Propriedades

Name	Description
Actor	Obtém ou define a identidade da parte chamante que recebeu direitos de delegação.
AuthenticationType	Recebe o tipo de autenticação.
BootstrapContext	Obtém ou define o token que foi usado para criar a identidade desta reivindicação.
Claims	Obtém as reivindicações associadas à identidade desta reivindicação.
CustomSerializationData	Contém quaisquer dados adicionais fornecidos por um tipo derivado. Normalmente definido ao chamar WriteTo(BinaryWriter, Byte[]).
IsAuthenticated	Recebe um valor que indica se a identidade foi autenticada.
Label	Obtém ou define o rótulo para a identidade desta alegação.
Name	Obtém o nome da identidade que reclama.
NameClaimType	Obtém o tipo de reivindicação que é usado para determinar quais as reivindicações que fornecem o valor da Name propriedade da identidade dessa reivindicação.
RoleClaimType	Obtém o tipo de reivindicação que será interpretado como um papel .NET entre as reivindicações na identidade dessa reivindicação.

Métodos

Name	Description
AddClaim(Claim)	Acrescenta uma única reivindicação à identidade desta reivindicação.
AddClaims(IEnumerable<Claim>)	Adiciona uma lista de reivindicações à identidade desta reivindicação.
Clone()	Devolve uma nova ClaimsIdentity cópia desta identidade reivindicada.
CreateClaim(BinaryReader)	Fornece um ponto de extensibilidade para tipos derivados criarem um .Claim
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindAll(Predicate<Claim>)	Recupera todas as reivindicações que são correspondidas pelo predicado especificado.
FindAll(String)	Recupera todas as reivindicações que tenham o tipo de reivindicação especificado.
FindFirst(Predicate<Claim>)	Recupera a primeira afirmação que é correspondida pelo predicado especificado.
FindFirst(String)	Recupera a primeira reivindicação com o tipo especificado.
GetHashCode()	Serve como função de hash predefinida. (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 a identidade desta reivindicação tem uma reivindicação que é correspondida ao predicado especificado.
HasClaim(String, String)	Determina se a identidade desta reivindicação tem uma reivindicação com o tipo e valor especificados.
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
RemoveClaim(Claim)	Tenta remover uma reivindicação da identidade da reclamação.
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)
TryRemoveClaim(Claim)	Tenta remover uma reivindicação da identidade da reclamação.
WriteTo(BinaryWriter, Byte[])	Serializa usando um BinaryWriter.
WriteTo(BinaryWriter)	Serializa usando um BinaryWriter.

Aplica-se a

Ver também

Comentários

Esta página foi útil?