ClaimsIdentity Classe

Riferimento

Definizione

Spazio dei nomi:: System.Security.Claims

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

Assembly:: System.Security.Claims.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: ClaimsIdentity.cs

Source:: ClaimsIdentity.cs

Source:: ClaimsIdentity.cs

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un'identità basata sulle attestazioni.

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

Ereditarietà: Object
ClaimsIdentity

Derivato: System.Security.Principal.GenericIdentity

System.Security.Principal.WindowsIdentity

System.Web.Security.FormsIdentity

Attributi: ComVisibleAttribute SerializableAttribute

Implementazioni: IIdentity

Commenti

La ClaimsIdentity classe è un'implementazione concreta di un'identità basata sulle attestazioni, ovvero un'identità descritta da una raccolta di attestazioni. Un'attestazione è un'istruzione relativa a un'entità creata da un emittente che descrive una proprietà, un diritto o un'altra qualità dell'entità. Tale entità è detta oggetto dell'attestazione. Un'attestazione è rappresentata dalla Claim classe . Le attestazioni contenute in una ClaimsIdentity descrizione dell'entità rappresentata dall'identità corrispondente e possono essere usate per prendere decisioni di autorizzazione e autenticazione. Un modello di accesso basato sulle attestazioni presenta molti vantaggi rispetto ai modelli di accesso più tradizionali che si basano esclusivamente sui ruoli. Ad esempio, le attestazioni possono fornire informazioni molto più complete sull'identità che rappresentano e possono essere valutate per l'autorizzazione o l'autenticazione in modo molto più specifico.

A partire da .NET Framework 4.5, Windows Identity Foundation (WIF) e l'identità basata sulle attestazioni sono state completamente integrate in .NET Framework. Ciò significa che molte classi che rappresentano un'identità in .NET Framework derivano ora da ClaimsIdentity e descrivono le relative proprietà tramite una raccolta di attestazioni. Ciò è diverso dalle versioni precedenti di .NET Framework, in cui queste classi implementano direttamente l'interfaccia IIdentity . È possibile accedere alla raccolta di attestazioni che descrivono l'identità tramite la Claims proprietà . La ClaimsIdentity classe fornisce diversi metodi per trovare e modificare le attestazioni e supporta completamente le query integrate nel linguaggio (LINQ). Nel codice dell'applicazione gli ClaimsIdentity oggetti sono in genere accessibili tramite ClaimsPrincipal oggetti, ad esempio l'entità restituita da Thread.CurrentPrincipal.

Nota

Anche la ClaimsPrincipal classe ha una Claims proprietà . Nella maggior parte dei casi è necessario accedere alle attestazioni dell'utente tramite la ClaimsPrincipal.Claims raccolta anziché tramite la Claims raccolta. Sarà necessario accedere alle attestazioni di un individuo ClaimsIdentity solo nei casi in cui l'entità contiene più di una ClaimsIdentity e sarà necessario valutare o modificare un'identità specifica.

Importante

Per aggiungere o rimuovere attestazioni dalla Claims raccolta, un chiamante deve avere un trust completo.

Nel modello basato sulle attestazioni, la IIdentity.Name proprietà e il IPrincipal.IsInRole(String) metodo vengono implementati valutando le attestazioni contenute in un'identità. Le implementazioni di base nel modello basato sulle attestazioni vengono fornite dalla proprietà e dal ClaimsIdentity.Name ClaimsPrincipal.IsInRole metodo . Le NameClaimType proprietà e RoleClaimType consentono di specificare un tipo di attestazione da usare per valutare le attestazioni contenute nell'identità durante l'esecuzione di queste operazioni.

Gli scenari di delega sono supportati tramite le Actor proprietà e BootstrapContext .

Costruttori

ClaimsIdentity()	Inizializza una nuova istanza della classe ClaimsIdentity con una raccolta di attestazioni vuote.
ClaimsIdentity(BinaryReader)	Inizializza un'istanza di ClaimsIdentity con l'oggetto BinaryReader specificato.
ClaimsIdentity(ClaimsIdentity)	Inizializza una nuova istanza della classe ClaimsIdentity da un'istanza di ClaimsIdentity esistente.
ClaimsIdentity(IEnumerable<Claim>)	Inizializza una nuova istanza della classe ClaimsIdentity utilizzando una raccolta enumerata di oggetti Claim.
ClaimsIdentity(IEnumerable<Claim>, String)	Inizializza una nuova istanza della classe ClaimsIdentity con le attestazioni e il tipo di autenticazione specificati.
ClaimsIdentity(IEnumerable<Claim>, String, String, String)	Inizializza una nuova istanza della classe ClaimsIdentity con le attestazioni, il tipo di autenticazione, il tipo di attestazione del nome e il tipo di attestazione del ruolo specificati.
ClaimsIdentity(IIdentity)	Inizializza una nuova istanza della classe ClaimsIdentity utilizzando il nome e il tipo di autenticazione da IIdentity specificato.
ClaimsIdentity(IIdentity, IEnumerable<Claim>)	Inizializza una nuova istanza della classe ClaimsIdentity utilizzando le attestazioni specificate e IIdentity specificato.
ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String)	Inizializza una nuova istanza della classe ClaimsIdentity dall'oggetto IIdentity specificato utilizzando le attestazioni, il tipo di autenticazione, il tipo di attestazione del nome e il tipo di attestazione del ruolo specificati.
ClaimsIdentity(SerializationInfo)	Obsoleti. Inizializza una nuova istanza della classe ClaimsIdentity da un flusso serializzato creato usando ISerializable.
ClaimsIdentity(SerializationInfo, StreamingContext)	Obsoleti. Inizializza una nuova istanza della classe ClaimsIdentity da un flusso serializzato creato usando ISerializable.
ClaimsIdentity(String)	Inizializza una nuova istanza della classe ClaimsIdentity con una raccolta di attestazioni vuota e il tipo di autenticazione specificato.
ClaimsIdentity(String, String, String)	Inizializza una nuova istanza della classe ClaimsIdentity con il tipo di autenticazione, il tipo di attestazione del nome e il tipo di attestazione del ruolo specificati.

Campi

DefaultIssuer	Autorità emittente predefinita; "LOCAL AUTHORITY".
DefaultNameClaimType	Tipo di attestazione del nome predefinito; Name.
DefaultRoleClaimType	Tipo di attestazione del ruolo predefinito; Role.

Proprietà

Actor	Ottiene o imposta l'identità del chiamante a cui sono stati concessi i diritti di delega.
AuthenticationType	Ottiene il tipo di autenticazione.
BootstrapContext	Ottiene o imposta il token utilizzato per creare questa identità basata sulle attestazioni.
Claims	Ottiene le attestazioni associate a questa identità delle attestazioni.
CustomSerializationData	Contiene i dati aggiuntivi forniti da un tipo derivato. Generalmente impostato durante la chiamata a WriteTo(BinaryWriter, Byte[]).
IsAuthenticated	Ottiene un valore che indica se l'identità è stata autenticata.
Label	Ottiene o imposta l'etichetta per l'identità delle attestazioni.
Name	Ottiene il nome di questa identità delle attestazioni.
NameClaimType	Ottiene il tipo di attestazione utilizzato per determinare quali attestazioni forniscono il valore per la proprietà Name di tale identità delle attestazioni.
RoleClaimType	Ottiene il tipo di attestazione che verrà interpretato come ruolo di .NET tra le attestazioni in questa identità delle attestazioni.

Metodi

AddClaim(Claim)	Aggiunge un'attestazione singola all'identità di queste attestazioni.
AddClaims(IEnumerable<Claim>)	Aggiunge un elenco di attestazioni all'identità di queste attestazioni.
Clone()	Restituisce un nuovo oggetto ClaimsIdentity copiato da questa identità delle attestazioni.
CreateClaim(BinaryReader)	Fornisce un punto di estendibilità per i punti derivati per creare un oggetto Claim personalizzato.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindAll(Predicate<Claim>)	Recupera tutte le attestazioni che corrispondono al predicato specificato.
FindAll(String)	Recupera tutte le attestazioni con il tipo di attestazione specificato.
FindFirst(Predicate<Claim>)	Recupera la prima attestazione che corrisponde al predicato specificato.
FindFirst(String)	Recupera la prima attestazione con il tipo di attestazione specificato.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetObjectData(SerializationInfo, StreamingContext)	Popola l'oggetto SerializationInfo con i dati necessari per serializzare l'oggetto ClaimsIdentity corrente.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
HasClaim(Predicate<Claim>)	Determina se l'identità delle attestazioni possiede un'attestazione a cui corrisponde il predicato specificato.
HasClaim(String, String)	Determina se l'identità delle attestazioni ha un'attestazione con il tipo e il valore specificati.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
RemoveClaim(Claim)	Tenta di rimuovere un'attestazione dall'identità delle attestazioni.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TryRemoveClaim(Claim)	Tenta di rimuovere un'attestazione dall'identità delle attestazioni.
WriteTo(BinaryWriter)	Esegue la serializzazione usando BinaryWriter.
WriteTo(BinaryWriter, Byte[])	Esegue la serializzazione usando BinaryWriter.

Si applica a