ClaimsIdentity Klass

Definition

Namnområde:
System.Security.Claims
Sammansättningar:
mscorlib.dll, System.Security.Claims.dll
Sammansättning:
mscorlib.dll
Sammansättning:
netstandard.dll

Representerar en anspråksbaserad identitet.

public ref class ClaimsIdentity : System::Security::Principal::IIdentity
public class ClaimsIdentity : System.Security.Principal.IIdentity
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class ClaimsIdentity : System.Security.Principal.IIdentity
type ClaimsIdentity = class
    interface IIdentity
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type ClaimsIdentity = class
    interface IIdentity
Public Class ClaimsIdentity
Implements IIdentity
Arv
Object
ClaimsIdentity
Härledda
Attribut
ComVisibleAttribute SerializableAttribute
Implementeringar
IIdentity

Kommentarer

Klassen ClaimsIdentity är en konkret implementering av en anspråksbaserad identitet, dvs. en identitet som beskrivs av en samling anspråk. Ett anspråk är en instruktion om en entitet som görs av en utfärdare som beskriver en egenskap, rättighet eller någon annan kvalitet på den entiteten. En sådan enhet sägs vara föremål för anspråket. Ett anspråk representeras av Claim klassen. Anspråken i en ClaimsIdentity beskriver den entitet som motsvarande identitet representerar och kan användas för att fatta auktoriserings- och autentiseringsbeslut. En anspråksbaserad åtkomstmodell har många fördelar jämfört med mer traditionella åtkomstmodeller som enbart förlitar sig på roller. Anspråk kan till exempel ge mycket mer detaljerad information om den identitet de representerar och kan utvärderas för auktorisering eller autentisering på ett mycket mer specifikt sätt.

Från och med .NET Framework 4.5 har Windows Identity Foundation (WIF) och anspråksbaserad identitet integrerats helt i .NET Framework. Det innebär att många klasser som representerar en identitet i .NET Framework nu härleds från ClaimsIdentity och beskriver deras egenskaper via en samling anspråk. Detta skiljer sig från tidigare versioner av .NET Framework, där dessa klasser implementerade gränssnittet IIdentity direkt. En samling anspråk som beskriver identiteten kan nås via egenskapen Claims . Klassen ClaimsIdentity innehåller flera metoder för att hitta och ändra anspråk och har fullt stöd för språkintegrerade frågor (LINQ). I programkod ClaimsIdentity används objekt vanligtvis via ClaimsPrincipal objekt, till exempel det huvudnamn som returneras av Thread.CurrentPrincipal.

Note

Klassen ClaimsPrincipal har även en Claims egenskap. I de flesta fall bör du komma åt användarens anspråk via ClaimsPrincipal.Claims samlingen i stället för genom Claims samlingen. Du behöver bara komma åt anspråken för en enskild person ClaimsIdentity i de fall där huvudkontot innehåller mer än en ClaimsIdentity och du behöver utvärdera eller ändra en specifik identitet.

Important

Om du vill lägga till eller ta bort anspråk från Claims samlingen måste en anropare ha fullt förtroende.

I den anspråksbaserade modellen IIdentity.Name implementeras egenskapen och IPrincipal.IsInRole(String) metoden genom att utvärdera anspråken som ingår i en identitet. Basimplementeringarna i den anspråksbaserade modellen tillhandahålls av ClaimsIdentity.Name egenskapen och ClaimsPrincipal.IsInRole metoden. Med NameClaimType egenskaperna och RoleClaimType kan du ange en anspråkstyp som ska användas för att utvärdera anspråken som ingår i identiteten när du utför dessa åtgärder.

Delegeringsscenarier stöds via Actor egenskaperna och BootstrapContext .

Konstruktorer

Name Description
ClaimsIdentity()

Initierar en ny instans av ClaimsIdentity klassen med en tom anspråkssamling.
ClaimsIdentity(BinaryReader)

Initierar en instans av ClaimsIdentity med angiven BinaryReader.
ClaimsIdentity(ClaimsIdentity)

Initierar en ny instans av ClaimsIdentity klassen från en befintlig ClaimsIdentity instans.
ClaimsIdentity(IEnumerable<Claim>, String, String, String)

Initierar en ny instans av ClaimsIdentity klassen med angivna anspråk, autentiseringstyp, namnanspråkstyp och rollanspråkstyp.
ClaimsIdentity(IEnumerable<Claim>, String)

Initierar en ny instans av ClaimsIdentity klassen med angivna anspråk och autentiseringstyp.
ClaimsIdentity(IEnumerable<Claim>)

Initierar en ny instans av klassen med hjälp av ClaimsIdentityClaim en uppräknad samling objekt.
ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String)

Initierar en ny instans av ClaimsIdentity klassen från den angivna IIdentity med angivna anspråk, autentiseringstyp, namnanspråkstyp och rollanspråkstyp.
ClaimsIdentity(IIdentity, IEnumerable<Claim>)

Initierar en ny instans av ClaimsIdentity klassen med de angivna anspråken och den angivna IIdentity.
ClaimsIdentity(IIdentity)

Initierar en ny instans av ClaimsIdentity klassen med namnet och autentiseringstypen från den angivna IIdentity.
ClaimsIdentity(SerializationInfo, StreamingContext)

Initierar en ny instans av ClaimsIdentity klassen från en serialiserad ström som skapats med hjälp ISerializableav .
ClaimsIdentity(SerializationInfo)

Initierar en ny instans av ClaimsIdentity klassen från en serialiserad ström som skapats med hjälp ISerializableav .
ClaimsIdentity(String, String, String)

Initierar en ny instans av ClaimsIdentity klassen med den angivna autentiseringstypen, namnanspråkstypen och rollanspråkstypen.
ClaimsIdentity(String)

Initierar en ny instans av ClaimsIdentity klassen med en tom anspråkssamling och den angivna autentiseringstypen.

Fält

Name Description
DefaultIssuer

Standardutfärdaren; "LOKAL MYNDIGHET".
DefaultNameClaimType

Standardnamnets anspråkstyp. Name.
DefaultRoleClaimType

Standardtypen för rollanspråk. Role.

Egenskaper

Name Description
Actor

Hämtar eller anger identiteten för den anropande part som har beviljats delegeringsrättigheter.
AuthenticationType

Hämtar autentiseringstypen.
BootstrapContext

Hämtar eller anger den token som användes för att skapa den här anspråksidentiteten.
Claims

Hämtar anspråk som är associerade med den här anspråksidentiteten.
CustomSerializationData

Innehåller ytterligare data som tillhandahålls av en härledd typ. Anges vanligtvis när du anropar WriteTo(BinaryWriter, Byte[]).
IsAuthenticated

Hämtar ett värde som anger om identiteten har autentiserats.
Label

Hämtar eller anger etiketten för den här anspråksidentiteten.
Name

Hämtar namnet på den här anspråksidentiteten.
NameClaimType

Hämtar anspråkstypen som används för att avgöra vilka anspråk som anger värdet för egenskapen för den Name här anspråksidentiteten.
RoleClaimType

Hämtar anspråkstypen som ska tolkas som en .NET roll bland anspråken i den här anspråksidentiteten.

Metoder

Name Description
AddClaim(Claim)

Lägger till ett enda anspråk i den här anspråksidentiteten.
AddClaims(IEnumerable<Claim>)

Lägger till en lista över anspråk i den här anspråksidentiteten.
Clone()

Returnerar en ny ClaimsIdentity kopierad från den här anspråksidentiteten.
CreateClaim(BinaryReader)

Tillhandahåller en utökningspunkt för härledda typer för att skapa en anpassad Claim.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
FindAll(Predicate<Claim>)

Hämtar alla anspråk som matchas av det angivna predikatet.
FindAll(String)

Hämtar alla anspråk som har den angivna anspråkstypen.
FindFirst(Predicate<Claim>)

Hämtar det första anspråket som matchas av det angivna predikatet.
FindFirst(String)

Hämtar det första anspråket med den angivna anspråkstypen.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetObjectData(SerializationInfo, StreamingContext)

Fyller i SerializationInfo med data som behövs för att serialisera det aktuella ClaimsIdentity objektet.
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
HasClaim(Predicate<Claim>)

Avgör om anspråksidentiteten har ett anspråk som matchas av det angivna predikatet.
HasClaim(String, String)

Avgör om anspråksidentiteten har ett anspråk med angiven anspråkstyp och värde.
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
RemoveClaim(Claim)

Försöker ta bort ett anspråk från anspråksidentiteten.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)
TryRemoveClaim(Claim)

Försöker ta bort ett anspråk från anspråksidentiteten.
WriteTo(BinaryWriter, Byte[])

Serialiserar med hjälp av en BinaryWriter.
WriteTo(BinaryWriter)

Serialiserar med hjälp av en BinaryWriter.

Gäller för

Se även