Claim Klass

Definition

public ref class Claim

public class Claim

[System.Serializable]
public class Claim

type Claim = class

[<System.Serializable>]
type Claim = class

Public Class Claim

Arv

Object

Claim

Attribut

SerializableAttribute

Exempel

I följande exempel extraheras de anspråk som är associerade med den autentiserade användaren som utför en HTTP-begäran och skriver dem i HTTP-svaret. Den aktuella användaren läss från HttpContext som en ClaimsPrincipal och anspråken läss från den. Anspråken skrivs sedan till objektet HttpResponse .

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

}

Kommentarer

Ett anspråk är en instruktion om ett ämne av en utfärdare. Anspråk representerar attribut för ämnet som är användbara i samband med autentiserings- och auktoriseringsåtgärder. Ämnen och utfärdare är båda entiteter som ingår i ett identitetsscenario. Några vanliga exempel på ett ämne är: en användare, ett program eller en tjänst, en enhet eller en dator. Några vanliga exempel på en utfärdare är: operativsystemet, ett program, en tjänst, en rollprovider, en identitetsprovider eller en federationsprovider. En utfärdare levererar anspråk genom att utfärda säkerhetstoken, vanligtvis via en säkerhetstokentjänst (STS). Ibland kan insamlingen av anspråk som tas emot från en utfärdare utökas med ämnesattribut som lagras direkt på resursen. Ett anspråk kan utvärderas för att fastställa åtkomsträttigheter till data och andra skyddade resurser under auktoriseringsprocessen och kan också användas för att fatta eller uttrycka autentiseringsbeslut om ett ämne.

Från och med .NET Framework 4.5 har wif-klasserna (Windows Identity Foundation), som implementerar anspråksbaserad identitet, helt integrerats i .NET Framework. Anspråkskonceptet implementeras av Claim klassen.

Följande beskriver viktiga egenskaper för Claim klassen:

• Egenskapen Type är en sträng (vanligtvis en URI) som innehåller semantisk information om anspråket. Den anger vad värdet för anspråket innebär. Ett anspråk med anspråkstypen GivenName ("http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname") representerar till exempel en användares förnamn. Värdet för Type egenskapen kan vara en av de välkända anspråkstyper som definierats i ClaimTypes klassen, eller så kan det vara en godtycklig URI som definieras av utfärdaren. En anspråkstyp av "urn:spendinglimit" kan till exempel representera ett användarattribut som är meningsfullt i utfärdarens affärskontext.

• Egenskapen Value innehåller anspråkets värde. För att minska beroenden och förenkla administrationen representeras värdet för ett anspråk endast som en sträng i WIF. För mer komplexa värdetyper rekommenderar vi att du använder xml-standardschematyper för att ange hur värdet ska serialiseras till och deserialiseras från en sträng.

• Egenskapen ValueType innehåller en sträng som identifierar typinformationen för värdet. Den här egenskapen bör användas för att förstå värdets format och för att ge information om hur du deserialiserar det. Om lösningen kräver komplexa värdetyper rekommenderar vi att du använder xml-standardschematyper i ValueType egenskapen för att ange hur Value egenskapen ska serialiseras till och deserialiseras från en sträng.

• Egenskapen Subject är ett ClaimsIdentity objekt som representerar anspråkets ämne. Ämnet för anspråket är entiteten (vanligtvis den användare som begär åtkomst till en resurs) som anspråket hävdas om. Innehåller ClaimsIdentity bland dess egenskaper en samling anspråk som beskriver egenskaperna och attributen för ämnet som intygas av en eller flera utfärdare.

• Egenskapen Issuer innehåller namnet på den entitet som utfärdade anspråket. Utfärdaren av ett anspråk representeras i WIF av en sträng som innehåller ett namn som hämtats från en lista över välkända utfärdare som underhålls av utfärdarens namnregister. Utfärdarens namnregister är en instans av en klass som härleds från IssuerNameRegistry klassen. Utfärdarens namnregister associerar ett mnemonic-namn med det kryptografiska material som behövs för att verifiera signaturerna för token som produceras av motsvarande utfärdare. Till exempel associerar klassen ConfigurationBasedIssuerNameRegistry, som är tillgänglig i rutan med .NET 4.5, mnemonic-namnet för varje utfärdare med motsvarande X.509-certifikat. Listan över välkända utfärdare skapas vanligtvis vid start av utfärdarens namnregister. Listan som används av ConfigurationBasedIssuerNameRegistry anges i programkonfigurationsfilen.

• Egenskapen OriginalIssuer innehåller namnet på den entitet som ursprungligen utfärdade anspråket. Den här egenskapen är utformad för att underlätta scenarier där ett anspråk kan passera genom flera utfärdare innan det presenteras av klienten för RP-programmet. till exempel federationsscenarier. Du kan undersöka OriginalIssuer egenskapen för att fastställa den entitet som ursprungligen utfärdade anspråket. Namnet tas från listan över välkända utfärdare som underhålls av utfärdarens namnregister, som i fallet Issuer med egenskapen.

Se även

• ClaimsIdentity
• ClaimsPrincipal
• IssuerNameRegistry