ClaimsPrincipal Klas

Definitie

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

Overname

Object

ClaimsPrincipal

Afgeleid

System.Security.Principal.GenericPrincipal

System.Security.Principal.WindowsPrincipal

System.Web.Security.RolePrincipal

Kenmerken

ComVisibleAttribute SerializableAttribute

Implementeringen

IPrincipal

Voorbeelden

In het volgende voorbeeld worden de claims geëxtraheerd die door een gebruiker in een HTTP-aanvraag worden gepresenteerd en naar het HTTP-antwoord geschreven. De huidige gebruiker wordt gelezen uit de HttpContext als een ClaimsPrincipal. De claims worden vervolgens gelezen en vervolgens naar het antwoord geschreven.

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

Opmerkingen

Vanaf .NET Framework 4.5 zijn Windows Identity Foundation (WIF) en op claims gebaseerde identiteit volledig geïntegreerd in .NET Framework. Dit betekent dat veel klassen die een principal in het .NET Framework vertegenwoordigen, nu zijn afgeleid van ClaimsPrincipal in plaats van simpelweg de interface IPrincipal te implementeren. Naast het implementeren van de IPrincipal interface, ClaimsPrincipal worden eigenschappen en methoden beschikbaar die nuttig zijn voor het werken met claims.

ClaimsPrincipal toont een verzameling identiteiten, die elk een ClaimsIdentity. In het algemene geval heeft deze verzameling, die toegankelijk is via de Identities eigenschap, slechts één element.

De introductie van ClaimsPrincipal in .NET 4.5 als de principal waaruit de meeste principal-klassen zijn afgeleid, dwingt u niet om iets te wijzigen op de manier waarop u met identiteit omgaat. Het opent echter meer mogelijkheden en biedt meer kansen om nauwkeuriger toegangsbeheer uit te oefenen. Voorbeeld:

• De toepassingscode zelf kan rechtstreeks met de claims in de huidige principal werken om extra verificatie-, autorisatie- en personalisatietaken uit te voeren.

• U kunt uw resources voorzien van een pijplijn voor claimverwerking, die kan omgaan met verificatieaanvragen en autorisatiebeleid, zelfs voordat de uitvoering uw code bereikt. U kunt bijvoorbeeld een webtoepassing of -service configureren met een aangepast claimverificatiebeheer, een exemplaar van een klasse die is afgeleid van de ClaimsAuthenticationManager klasse. Wanneer dit zo is geconfigureerd, roept de aanvraagverwerkingspijplijn de Authenticate methode aan op uw claimverificatiebeheerder die deze ClaimsPrincipal doorgeeft aan de context van de binnenkomende aanvraag. Uw claimverificatiemanager kan vervolgens verificatie uitvoeren op basis van de waarden van de binnenkomende claims. Het kan ook claims filteren, transformeren of toevoegen aan de binnenkomende claimset. Het kan bijvoorbeeld worden gebruikt om de binnenkomende claimset te verrijken met nieuwe claims die zijn gemaakt op basis van een lokale gegevensbron, zoals een lokaal gebruikersprofiel

• U kunt een webtoepassing configureren met een aangepaste claimautorisatiebeheerder, een exemplaar van een klasse die is afgeleid van de ClaimsAuthorizationManager klasse. Wanneer dit zo is geconfigureerd, verpakt de aanvraagverwerkingspijplijn de binnenkomende ClaimsPrincipal in een AuthorizationContext en roept de CheckAccess methode aan op uw claimautorisatiebeheerder. Uw claimautorisatiemanager kan vervolgens autorisatie afdwingen op basis van de binnenkomende claims.

• Inline op claims gebaseerde codetoegangscontroles kunnen worden uitgevoerd door uw toepassing te configureren met een aangepast claimautorisatiebeheer en de ClaimsPrincipalPermission klasse te gebruiken voor het uitvoeren van imperatieve toegangscontroles of het ClaimsPrincipalPermissionAttribute uitvoeren van declaratieve toegangscontroles. Op claims gebaseerde codetoegangscontroles worden inline uitgevoerd, buiten de verwerkingspijplijn, en zijn dus beschikbaar voor alle toepassingen zolang een claimautorisatiebeheer is geconfigureerd.

U kunt een ClaimsPrincipal exemplaar verkrijgen voor de principal die is gekoppeld aan een aanvraag of de principal waaronder een thread wordt uitgevoerd, in een relying party-toepassing (RP) door de Thread.CurrentPrincipal eigenschap naar te ClaimsPrincipalcasten. De claims die aan een ClaimsPrincipal object zijn gekoppeld, zijn beschikbaar via de Claims eigenschap. De Claims eigenschap retourneert alle claims die zijn opgenomen in de identiteiten die zijn gekoppeld aan de principal. In het ongebruikelijke geval waarin het ClaimsPrincipal meerdere ClaimsIdentity exemplaren bevat, kunt u de Identities eigenschap gebruiken of hebt u toegang tot de primaire identiteit met behulp van de Identity eigenschap. ClaimsPrincipal biedt verschillende methoden waarmee deze claims kunnen worden doorzocht en die volledig ondersteuning bieden voor Language Integrated Query (LINQ). Identiteiten kunnen aan de principal worden toegevoegd met behulp van de AddIdentities of AddIdentity methoden.

WIF geeft standaard prioriteit aan WindowsIdentity objecten wanneer u de primaire identiteit selecteert die u wilt retourneren via de Identity eigenschap. U kunt dit gedrag wijzigen door een gemachtigde via de PrimaryIdentitySelector eigenschap op te geven om de selectie uit te voeren. De ClaimsPrincipalSelector eigenschap biedt vergelijkbare functionaliteit voor de Current eigenschap.

In het claimmodel wordt bepaald of een principal zich in een opgegeven rol bevindt door de claims die worden gepresenteerd door de onderliggende identiteiten. De IsInRole methode onderzoekt in wezen elke identiteit die is gekoppeld aan de principal om te bepalen of deze een claim met de opgegeven rolwaarde bezit. Het type claim (vertegenwoordigd door de Claim.Type eigenschap) dat wordt gebruikt om te bepalen welke claims moeten worden onderzocht tijdens rolcontroles, wordt opgegeven op een identiteit via de ClaimsIdentity.RoleClaimType eigenschap ervan. De claims die tijdens de rolcontroles worden onderzocht, kunnen dus van een ander type zijn voor verschillende identiteiten die aan de principal zijn gekoppeld.

Zie ook

• Claim
• ClaimsIdentity
• ClaimsAuthenticationManager
• ClaimsAuthorizationManager