ClaimsPrincipal Classe

Definizione

public ref class ClaimsPrincipal : System::Security::Principal::IPrincipal

public class ClaimsPrincipal : System.Security.Principal.IPrincipal

[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class ClaimsPrincipal : System.Security.Principal.IPrincipal

type ClaimsPrincipal = class
    interface IPrincipal

[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type ClaimsPrincipal = class
    interface IPrincipal

Public Class ClaimsPrincipal
Implements IPrincipal

Ereditarietà

Object

ClaimsPrincipal

Derivato

System.Security.Principal.GenericPrincipal

System.Security.Principal.WindowsPrincipal

System.Web.Security.RolePrincipal

Attributi

ComVisibleAttribute SerializableAttribute

Implementazioni

IPrincipal

Esempio

Nell'esempio seguente vengono estratte le attestazioni presentate da un utente in una richiesta HTTP e le scrive nella risposta HTTP. L'utente corrente viene letto da HttpContext come .ClaimsPrincipal Le attestazioni vengono quindi lette da essa e quindi vengono scritte nella risposta.

if (HttpContext.Current.User is ClaimsPrincipal principal)
{
   foreach (Claim claim in principal.Claims)
   {
      Response.Write("CLAIM TYPE: " + claim.Type + "; CLAIM VALUE: " + claim.Value + "</br>");
   }
}

Commenti

A partire da .NET Framework 4.5, Windows Identity Foundation (WIF) e l'identità basata sulle attestazioni sono completamente integrati in .NET Framework. Ciò significa che molte classi che rappresentano un'entità di sicurezza in .NET Framework derivano ora da ClaimsPrincipal anziché semplicemente implementare l'interfaccia IPrincipal . Oltre a implementare l'interfaccia, ClaimsPrincipal espone proprietà e metodi utili per l'uso IPrincipal delle attestazioni.

ClaimsPrincipal espone una raccolta di identità, ognuna delle quali è un oggetto ClaimsIdentity. Nel caso comune, questa raccolta, accessibile tramite la Identities proprietà , avrà solo un singolo elemento.

L'introduzione di ClaimsPrincipal in .NET 4.5 come principale da cui derivano la maggior parte delle classi principale non impone di modificare nulla nel modo in cui si gestisce l'identità. Tuttavia, apre più possibilità e offre più possibilità di esercitare un controllo di accesso più corretto. Per esempio:

• Il codice dell'applicazione può funzionare direttamente con le attestazioni contenute nell'entità corrente per eseguire attività di autenticazione, autorizzazione e personalizzazione aggiuntive.

• È possibile far fronte alle risorse con una pipeline di elaborazione delle attestazioni, che può gestire le richieste di autenticazione e i criteri di autorizzazione anche prima che l'esecuzione raggiunga il codice. Ad esempio, è possibile configurare un'applicazione o un servizio basato sul Web con un gestore di autenticazione delle attestazioni personalizzato, un'istanza di una classe che deriva dalla ClaimsAuthenticationManager classe . In caso di configurazione, la pipeline di elaborazione delle richieste richiama il Authenticate metodo nel gestore di autenticazione delle attestazioni passandolo che ClaimsPrincipal rappresenta il contesto della richiesta in ingresso. Il gestore di autenticazione delle attestazioni può quindi eseguire l'autenticazione in base ai valori delle attestazioni in ingresso. Può anche filtrare, trasformare o aggiungere attestazioni al set di attestazioni in ingresso. Ad esempio, può essere usato per arricchire il set di attestazioni in ingresso con nuove attestazioni create da un'origine dati locale, ad esempio un profilo utente locale

• È possibile configurare un'applicazione basata sul Web con un gestore autorizzazioni attestazioni personalizzate, un'istanza di una classe che deriva dalla ClaimsAuthorizationManager classe . In caso di configurazione, la pipeline di elaborazione delle richieste crea un pacchetto in ingresso ClaimsPrincipal in un AuthorizationContext oggetto e richiama il CheckAccess metodo nel gestore di autorizzazioni delle attestazioni. Il gestore di autorizzazioni delle attestazioni può quindi applicare l'autorizzazione in base alle attestazioni in ingresso.

• I controlli di accesso al codice basati sulle attestazioni inline possono essere eseguiti configurando l'applicazione con un gestore di autorizzazioni delle attestazioni personalizzate e usando la ClaimsPrincipalPermission classe per eseguire controlli di accesso imperativi o ClaimsPrincipalPermissionAttribute per eseguire controlli di accesso dichiarativi. I controlli di accesso al codice basati sulle attestazioni vengono eseguiti inline, all'esterno della pipeline di elaborazione e quindi sono disponibili per tutte le applicazioni, purché sia configurato un gestore autorizzazioni attestazioni.

È possibile ottenere un'istanza ClaimsPrincipal per l'entità associata a una richiesta o l'entità in cui è in esecuzione un thread, in un'applicazione relying party (RP) eseguendo il cast della Thread.CurrentPrincipal proprietà su ClaimsPrincipal. Le attestazioni associate a un ClaimsPrincipal oggetto sono disponibili tramite la relativa Claims proprietà . La Claims proprietà restituisce tutte le attestazioni contenute nelle identità associate all'entità. Nel caso non comune in cui ClaimsPrincipal contiene più ClaimsIdentity istanze, è possibile usare la Identities proprietà oppure accedere all'identità primaria usando la Identity proprietà . ClaimsPrincipal fornisce diversi metodi tramite cui è possibile eseguire ricerche in queste attestazioni e supporta completamente LINQ (Language Integrated Query). Le identità possono essere aggiunte all'entità usando i AddIdentities metodi o AddIdentity .

Per impostazione predefinita, WIF assegna WindowsIdentity la priorità agli oggetti quando si seleziona l'identità primaria da restituire tramite la Identity proprietà . È possibile modificare questo comportamento specificando un delegato tramite la PrimaryIdentitySelector proprietà per eseguire la selezione. La ClaimsPrincipalSelector proprietà fornisce funzionalità simili per la Current proprietà .

Nel modello basato sull'attestazione, se un'entità si trova in un ruolo specificato è determinata dalle attestazioni presentate dalle identità sottostanti. Il IsInRole metodo esamina essenzialmente ogni identità associata all'entità per determinare se possiede un'attestazione con il valore di ruolo specificato. Tipo dell'attestazione (rappresentata dalla relativa Claim.Type proprietà) utilizzata per determinare quali attestazioni devono essere esaminate durante i controlli dei ruoli vengono specificate in un'identità tramite la relativa ClaimsIdentity.RoleClaimType proprietà. Pertanto, le attestazioni esaminate durante i controlli dei ruoli possono essere di un tipo diverso per identità diverse associate all'entità.

Vedi anche

• Claim
• ClaimsIdentity
• ClaimsAuthenticationManager
• ClaimsAuthorizationManager