ClaimsPrincipal Klass

Definition

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

Arv

Object

ClaimsPrincipal

Härledda

System.Security.Principal.GenericPrincipal

System.Security.Principal.WindowsPrincipal

System.Web.Security.RolePrincipal

Attribut

ComVisibleAttribute SerializableAttribute

Implementeringar

IPrincipal

Exempel

I följande exempel extraheras anspråken som presenteras av en användare i en HTTP-begäran och skriver dem till HTTP-svaret. Den aktuella användaren läse från HttpContext som en ClaimsPrincipal. Anspråken läse sedan från den och skrivs sedan till svaret.

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

Kommentarer

Från och med .NET Framework 4.5 är Windows Identity Foundation (WIF) och anspråksbaserad identitet helt integrerade i .NET Framework. Det innebär att många klasser som representerar ett huvudnamn i .NET Framework nu härleds från ClaimsPrincipal i stället för att bara implementera gränssnittet IPrincipal. Förutom att implementera IPrincipal gränssnittet ClaimsPrincipal exponeras egenskaper och metoder som är användbara för att arbeta med anspråk.

ClaimsPrincipal exponerar en samling identiteter, som var och en är en ClaimsIdentity. I det vanliga fallet har den här samlingen, som nås via Identities egenskapen, bara ett enda element.

Introduktionen av ClaimsPrincipal i .NET 4.5 som huvudnamn som de flesta huvudklasser härleder från tvingar dig inte att ändra något på det sätt som du hanterar identitet. Det öppnar dock upp fler möjligheter och ger fler chanser att utöva finare åtkomstkontroll. Ett exempel:

• Själva programkoden kan fungera direkt med anspråken i det aktuella huvudkontot för att driva extra autentiserings-, auktoriserings- och anpassningsuppgifter.

• Du kan fronta dina resurser med en pipeline för anspråksbearbetning som kan hantera autentiseringsbegäranden och auktoriseringsprincip redan innan körningen når koden. Du kan till exempel konfigurera ett webbaserat program eller en tjänst med en autentiseringshanterare för anpassade anspråk, en instans av en klass som härleds från ClaimsAuthenticationManager klassen. När den är konfigurerad anropar Authenticate pipelinen för bearbetning av begäran metoden på din anspråksautentiseringshanterare som skickar den en ClaimsPrincipal som representerar kontexten för den inkommande begäran. Din anspråksautentiseringshanterare kan sedan utföra autentisering baserat på värdena för inkommande anspråk. Den kan också filtrera, transformera eller lägga till anspråk i den inkommande anspråksuppsättningen. Den kan till exempel användas för att utöka den inkommande anspråksuppsättningen med nya anspråk som skapats från en lokal datakälla, till exempel en lokal användarprofil

• Du kan konfigurera ett webbaserat program med en ansvarig för anpassad anspråksauktorisering, en instans av en klass som härleds från ClaimsAuthorizationManager klassen. När den är konfigurerad paketerar pipelinen för bearbetning av begäran den inkommande ClaimsPrincipal i en AuthorizationContext och anropar CheckAccess metoden på din anspråksauktoriseringshanterare. Din anspråksauktoriseringshanterare kan sedan framtvinga auktorisering baserat på inkommande anspråk.

• Infogade anspråksbaserade kodåtkomstkontroller kan utföras genom att konfigurera ditt program med en ansvarig för anpassad anspråksauktorisering och använda antingen ClaimsPrincipalPermission klassen för att utföra imperativa åtkomstkontroller eller ClaimsPrincipalPermissionAttribute för att utföra deklarativa åtkomstkontroller. Anspråksbaserade kodåtkomstkontroller utförs infogade, utanför bearbetningspipelinen och är därför tillgängliga för alla program så länge en hanterare för anspråksauktorisering har konfigurerats.

Du kan hämta en ClaimsPrincipal instans för det huvudnamn som är associerat med en begäran, eller det huvudnamn under vilket en tråd körs, i ett förlitande partprogram (RP) genom att casta Thread.CurrentPrincipal egenskapen till ClaimsPrincipal. Anspråken som är associerade med ett ClaimsPrincipal objekt är tillgängliga via dess Claims egenskap. Egenskapen Claims returnerar alla anspråk som ingår i de identiteter som är associerade med huvudkontot. I det ovanliga fallet där innehåller ClaimsPrincipal flera ClaimsIdentity instanser kan du använda Identities egenskapen eller så kan du komma åt den primära identiteten Identity med hjälp av egenskapen . ClaimsPrincipal innehåller flera metoder med vilka dessa anspråk kan sökas igenom och har fullt stöd för LINQ (Language Integrated Query). Identiteter kan läggas till i huvudkontot med hjälp AddIdentities av metoderna eller AddIdentity .

Som standard prioriterar WIF objekt när du väljer den primära identitet som ska returneras WindowsIdentity via Identity egenskapen. Du kan ändra det här beteendet genom att ange ett ombud via PrimaryIdentitySelector egenskapen för att utföra valet. Egenskapen ClaimsPrincipalSelector innehåller liknande funktioner för egenskapen Current .

I den anspråksbaserade modellen bestäms huruvida ett huvudnamn finns i en angiven roll av de anspråk som presenteras av dess underliggande identiteter. Metoden IsInRole undersöker i huvudsak varje identitet som är associerad med huvudnamnet för att avgöra om den har ett anspråk med det angivna rollvärdet. Den typ av anspråk (representeras av dess Claim.Type egenskap) som används för att avgöra vilka anspråk som ska undersökas under rollkontroller anges på en identitet via dess ClaimsIdentity.RoleClaimType egenskap. Därför kan de anspråk som granskas under rollkontroller vara av en annan typ för olika identiteter som är associerade med huvudnamnet.

Se även

• Claim
• ClaimsIdentity
• ClaimsAuthenticationManager
• ClaimsAuthorizationManager