ClaimsIdentity Třída

Definice

Obor názvů:

System.Security.Claims

Sestavení:

netstandard.dll, System.Security.Claims.dll

Zdroj:

ClaimsIdentity.cs

Představuje identitu založenou na deklarací identity.

public ref class ClaimsIdentity : System::Security::Principal::IIdentity

public class ClaimsIdentity : System.Security.Principal.IIdentity

type ClaimsIdentity = class
    interface IIdentity

Public Class ClaimsIdentity
Implements IIdentity

Dědičnost

Object

ClaimsIdentity

Odvozené

System.Security.Principal.GenericIdentity

System.Security.Principal.WindowsIdentity

Implementuje

IIdentity

Poznámky

Třída ClaimsIdentity je konkrétní implementace identity založené na deklarací identity, tj. identita popsaná kolekcí deklarací identity. Deklarace identity je prohlášení o entitě vytvořené vystavitelem, který popisuje vlastnost, právo nebo jinou kvalitu této entity. Taková entita je údajně předmětem žádosti. Deklarace identity je reprezentována Claim třídou. Deklarace identity obsažené v ClaimsIdentity popisu entity, kterou odpovídající identita představuje, a lze ji použít k rozhodování o autorizaci a ověřování. Model přístupu na základě deklarací má mnoho výhod oproti tradičním modelům přístupu, které se spoléhají výhradně na role. Deklarace identity mohou například poskytovat mnohem bohatší informace o identitě, kterou představují, a je možné je vyhodnotit pro autorizaci nebo ověřování mnohem konkrétnějším způsobem.

Počínaje rozhraním .NET Framework 4.5 byla plně integrovaná identita windows Identity Foundation (WIF) a identita založená na deklaracích identit do rozhraní .NET Framework. To znamená, že mnoho tříd, které představují identitu v rozhraní .NET Framework nyní odvozeny od ClaimsIdentity a popisují jejich vlastnosti prostřednictvím kolekce deklarací identity. To se liší od předchozích verzí rozhraní .NET Framework, v němž tyto třídy implementují IIdentity rozhraní přímo. K kolekci deklarací identity, které popisují identitu, je možné získat přístup prostřednictvím Claims vlastnosti. Třída ClaimsIdentity poskytuje několik metod pro vyhledání a úpravu deklarací identity a plně podporuje integrované dotazy jazyka (LINQ). V kódu ClaimsIdentity aplikace jsou objekty obvykle přístupné prostřednictvím ClaimsPrincipal objektů, například objekty vrácené objekty Thread.CurrentPrincipal.

Poznámka:

Třída ClaimsPrincipal má Claims také vlastnost. Ve většině případů byste měli přistupovat k deklaracím identity uživatele prostřednictvím ClaimsPrincipal.Claims kolekce, nikoli prostřednictvím Claims kolekce. K deklaracím identity jednotlivce ClaimsIdentity budete muset přistupovat pouze v případech, kdy objekt zabezpečení obsahuje více než jednu ClaimsIdentity a potřebujete vyhodnotit nebo upravit konkrétní identitu.

Důležité

Pokud chcete přidat nebo odebrat deklarace identity z Claims kolekce, volající musí mít úplný vztah důvěryhodnosti.

V modelu IIdentity.Name založeném na deklarací identity se vlastnost a IPrincipal.IsInRole(String) metoda implementují vyhodnocením deklarací identit. Základní implementace v modelu založeném na deklaracích jsou poskytovány ClaimsIdentity.Name vlastností a metodou ClaimsPrincipal.IsInRole . RoleClaimType Vlastnosti NameClaimType umožňují určit typ deklarace identity, který by se měl použít k vyhodnocení deklarací identity obsažené identitou při provádění těchto operací.

Scénáře delegování jsou podporovány prostřednictvím Actor vlastností a BootstrapContext možností.

Konstruktory

Name	Description
ClaimsIdentity()	Inicializuje novou instanci třídy s prázdnou ClaimsIdentity kolekcí deklarací identity.
ClaimsIdentity(BinaryReader, StringComparison)	Inicializuje instanci ClaimsIdentity se zadaným BinaryReader.
ClaimsIdentity(BinaryReader)	Inicializuje instanci ClaimsIdentity se zadaným BinaryReader.
ClaimsIdentity(ClaimsIdentity, StringComparison)	Inicializuje novou instanci ClaimsIdentity třídy z existující ClaimsIdentity instance.
ClaimsIdentity(ClaimsIdentity)	Inicializuje novou instanci ClaimsIdentity třídy z existující ClaimsIdentity instance.
ClaimsIdentity(IEnumerable<Claim>, String, String, String)	Inicializuje novou instanci ClaimsIdentity třídy se zadanými deklaracemi identity, typem ověřování, typem deklarace identity názvu a typem deklarace role.
ClaimsIdentity(IEnumerable<Claim>, String)	Inicializuje novou instanci ClaimsIdentity třídy se zadanými deklaracemi identity a typem ověřování.
ClaimsIdentity(IEnumerable<Claim>)	Inicializuje novou instanci ClaimsIdentity třídy pomocí výčtu Claim kolekce objektů.
ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String, StringComparison)	Inicializuje novou instanci ClaimsIdentity třídy.
ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String)	Inicializuje novou instanci ClaimsIdentity třídy ze zadané IIdentity pomocí zadaných deklarací identity, typu ověřování, typu deklarace názvu a typu deklarace role.
ClaimsIdentity(IIdentity, IEnumerable<Claim>)	Inicializuje novou instanci ClaimsIdentity třídy pomocí zadaných deklarací identity a zadané IIdentity.
ClaimsIdentity(IIdentity)	Inicializuje novou instanci ClaimsIdentity třídy pomocí názvu a typu ověřování ze zadaného IIdentity.
ClaimsIdentity(SerializationInfo, StreamingContext)	Zastaralé. Inicializuje novou instanci třídy ze serializovaného datového ClaimsIdentity proudu vytvořeného pomocí ISerializable.
ClaimsIdentity(SerializationInfo)	Zastaralé. Inicializuje novou instanci třídy ze serializovaného datového ClaimsIdentity proudu vytvořeného pomocí ISerializable.
ClaimsIdentity(String, String, String)	Inicializuje novou instanci ClaimsIdentity třídy se zadaným typem ověřování, typem deklarace identity názvu a typem deklarace role.
ClaimsIdentity(String)	Inicializuje novou instanci třídy s prázdnou ClaimsIdentity kolekcí deklarací identity a zadaným typem ověřování.

Pole

Name	Description
DefaultIssuer	Výchozí vystavitel; "MÍSTNÍ ORGÁN".
DefaultNameClaimType	Výchozí typ deklarace identity názvu; Name.
DefaultRoleClaimType	Výchozí typ deklarace identity role; Role.

Vlastnosti

Name	Description
Actor	Získá nebo nastaví identitu volající strany, která byla udělena práva delegování.
AuthenticationType	Získá typ ověřování.
BootstrapContext	Získá nebo nastaví token, který byl použit k vytvoření této identity deklarací identity.
Claims	Získá deklarace identity přidružené k této identitě deklarací identity.
CustomSerializationData	Obsahuje všechna další data poskytovaná odvozeným typem. Obvykle se nastavuje při volání WriteTo(BinaryWriter, Byte[]).
IsAuthenticated	Získá hodnotu, která označuje, zda byla identita ověřena.
Label	Získá nebo nastaví popisek pro tuto identitu deklarací identity.
Name	Získá název této identity deklarací identity.
NameClaimType	Získá typ deklarace, který se používá k určení, které deklarace identity poskytují hodnotu pro Name vlastnost této identity deklarací identity.
RoleClaimType	Získá typ deklarace identity, který bude interpretován jako role .NET mezi deklaracemi v této identitě deklarací identity.

Metody

Name	Description
AddClaim(Claim)	Přidá k této identitě deklarací identity jednu deklaraci identity.
AddClaims(IEnumerable<Claim>)	Přidá do této identity deklarace identity seznam deklarací identity.
Clone()	Vrátí novou ClaimsIdentity zkopírovanou z této identity deklarací identity.
CreateClaim(BinaryReader)	Poskytuje bod rozšiřitelnosti pro odvozené typy vytvořit vlastní Claim.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
FindAll(Predicate<Claim>)	Načte všechny deklarace identity, které odpovídají zadanému predikátu.
FindAll(String)	Načte všechny deklarace identity, které mají zadaný typ deklarace identity.
FindFirst(Predicate<Claim>)	Načte první deklaraci identity, která se shoduje se zadaným predikátem.
FindFirst(String)	Načte první deklaraci identity se zadaným typem deklarace identity.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	Naplní SerializationInfo data potřebná k serializaci aktuálního ClaimsIdentity objektu.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
HasClaim(Predicate<Claim>)	Určuje, jestli má tato identita deklarací identity deklaraci identity, která se shoduje se zadaným predikátem.
HasClaim(String, String)	Určuje, jestli má tato identita deklarací identity deklaraci identity se zadaným typem a hodnotou deklarace identity.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
RemoveClaim(Claim)	Pokusí se odebrat deklaraci identity z identity deklarací identity.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TryRemoveClaim(Claim)	Pokusí se odebrat deklaraci identity z identity deklarací identity.
WriteTo(BinaryWriter, Byte[])	Serializuje pomocí BinaryWriter.
WriteTo(BinaryWriter)	Serializuje pomocí BinaryWriter.

Viz také

• Claim
• ClaimsPrincipal
• GenericIdentity
• WindowsIdentity
• FormsIdentity