ClaimsPrincipal Třída

Definice

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

Dědičnost

Object

ClaimsPrincipal

Odvozené

System.Security.Principal.GenericPrincipal

System.Security.Principal.WindowsPrincipal

System.Web.Security.RolePrincipal

Atributy

ComVisibleAttribute SerializableAttribute

Implementuje

IPrincipal

Příklady

Následující příklad extrahuje deklarace identity předložené uživatelem v požadavku HTTP a zapíše je do odpovědi HTTP. Aktuální uživatel se načte ze HttpContext souboru jako ClaimsPrincipal. Deklarace identity se z něj pak načtou a zapíšou se do odpovědi.

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

Poznámky

Počínaje rozhraním .NET Framework 4.5 jsou identita windows identity (WIF) a identita založená na deklarací identity plně integrována do rozhraní .NET Framework. To znamená, že mnoho tříd, které představují objekt zabezpečení v rozhraní .NET Framework, jsou nyní odvozeny z ClaimsPrincipal namísto pouhé implementace IPrincipal rozhraní. Kromě implementace IPrincipal rozhraní zpřístupňuje vlastnosti a metody, ClaimsPrincipal které jsou užitečné pro práci s deklaracemi identity.

ClaimsPrincipalzveřejňuje kolekci identit, z nichž každá je .ClaimsIdentity V běžném případě bude tato kolekce, ke které se přistupuje prostřednictvím Identities vlastnosti , obsahovat pouze jeden prvek.

Zavedení objektu ClaimsPrincipal v .NET 4.5 jako objektu zabezpečení, ze kterého je odvozena většina tříd objektů zabezpečení, vás nenutí nic měnit ve způsobu, jakým s identitou nakládáte. Otevírá ale více možností a nabízí více možností, jak provést jemnější řízení přístupu. Příklad:

• Samotný kód aplikace může pracovat přímo s deklaracemi identity obsaženými v aktuálním objektu zabezpečení, aby bylo možné provádět další úlohy ověřování, autorizace a přizpůsobení.

• K prostředkům můžete použít kanál zpracování deklarací identity, který dokáže zpracovávat žádosti o ověření a zásady autorizace ještě před tím, než spuštění dosáhne vašeho kódu. Můžete například nakonfigurovat webovou aplikaci nebo službu pomocí vlastního správce ověřování deklarací identity, instanci třídy, která je odvozena z ClaimsAuthenticationManager třídy . Když je to nakonfigurované, kanál zpracování požadavků vyvolá metodu Authenticate ve správci ověřování deklarací identity a předá jí ClaimsPrincipal objekt , který představuje kontext příchozího požadavku. Váš správce ověřování deklarací identity pak může provádět ověřování na základě hodnot příchozích deklarací identity. Může také filtrovat, transformovat nebo přidávat deklarace identity do příchozí sady deklarací identity. Dá se například použít k obohacení příchozí sady deklarací identity o nové deklarace identity vytvořené z místního zdroje dat, jako je místní profil uživatele.

• Webovou aplikaci můžete nakonfigurovat pomocí vlastního správce autorizace deklarací identity, instance třídy, která je odvozena z ClaimsAuthorizationManager třídy . Po nakonfigurování kanál zpracování požadavku zabalí příchozí ClaimsPrincipal do a vyvolá metodu CheckAccess ve AuthorizationContext správci autorizace deklarací identity. Správce autorizace deklarací identity pak může vynutit autorizaci na základě příchozích deklarací identity.

• Vložené kontroly přístupu kódu založené na deklaracích se dají provádět nakonfigurováním aplikace pomocí vlastního správce autorizace deklarací identity a použitím ClaimsPrincipalPermission třídy k provádění imperativních kontrol přístupu nebo ClaimsPrincipalPermissionAttribute pomocí třídy k provádění deklarativních kontrol přístupu. Kontroly přístupu kódu na základě deklarací identity se provádějí vloženě, mimo kanál zpracování a jsou tak dostupné všem aplikacím, pokud je nakonfigurovaný správce autorizace deklarací identity.

Instanci objektu ClaimsPrincipal zabezpečení přidruženého k požadavku nebo objektu zabezpečení, pod kterým se provádí vlákno, můžete získat v aplikaci předávající strany (RP) přetypováním Thread.CurrentPrincipal vlastnosti na ClaimsPrincipal. Deklarace identity přidružené k objektu ClaimsPrincipal jsou k dispozici prostřednictvím jeho Claims vlastnosti. Vlastnost Claims vrátí všechny deklarace identity obsažené v identitách přidružených k objektu zabezpečení. V neobvyklém případě, kdy ClaimsPrincipal objekt obsahuje více ClaimsIdentity instancí, můžete použít Identities vlastnost nebo získat přístup k primární identitě pomocí Identity vlastnosti . ClaimsPrincipal poskytuje několik metod, pomocí kterých lze tyto deklarace identity prohledávat, a plně podporuje linq (Language Integrated Query). Identity je možné přidat do objektu AddIdentities zabezpečení pomocí metod nebo AddIdentity .

Technologie WIF ve výchozím nastavení při výběru primární identity, která se má vrátit prostřednictvím vlastnosti, upřednostňuje objekty WindowsIdentityIdentity . Toto chování můžete změnit zadáním delegáta prostřednictvím PrimaryIdentitySelector vlastnosti pro provedení výběru. Vlastnost ClaimsPrincipalSelector poskytuje podobné funkce pro Current vlastnost.

V modelu založeném na deklarací identitě určuje, jestli je objekt zabezpečení v zadané roli, na základě deklarací identity, které prezentuje jeho podkladové identity. Metoda IsInRole v podstatě prozkoumá každou identitu přidruženou k objektu zabezpečení a určí, jestli má deklaraci identity se zadanou hodnotou role. Typ deklarace identity (reprezentovaný její Claim.Type vlastností) použitý k určení, které deklarace identity by se měly zkoumat během kontrol rolí, se u identity specifikuje prostřednictvím její ClaimsIdentity.RoleClaimType vlastnosti. Deklarace identity, které se zkoumají při kontrolách rolí, proto můžou mít jiný typ pro různé identity přidružené k objektu zabezpečení.

Konstruktory

Vlastnosti

Metody

Platí pro

Viz také

• Claim
• ClaimsIdentity
• ClaimsAuthenticationManager
• ClaimsAuthorizationManager