Claim Klasse

Definition

public ref class Claim

public class Claim

[System.Serializable]
public class Claim

type Claim = class

[<System.Serializable>]
type Claim = class

Public Class Claim

Vererbung

Object

Claim

Attribute

SerializableAttribute

Beispiele

Im folgenden Beispiel werden die Ansprüche extrahiert, die dem authentifizierten Benutzer zugeordnet sind, der eine HTTP-Anforderung ausführt, und schreibt sie in die HTTP-Antwort. Der aktuelle Benutzer wird aus dem HttpContext als a ClaimsPrincipal gelesen, und die Ansprüche werden daraus gelesen. Die Ansprüche werden dann in das HttpResponse -Objekt geschrieben.

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>");  
   }  

}  

Hinweise

Ein Anspruch ist eine Aussage eines Ausstellers über einen Antragsteller. Ansprüche stellen Attribute des Antragstellers dar, die im Kontext von Authentifizierungs- und Autorisierungsvorgängen nützlich sind. Subjekte und Aussteller sind Entitäten, die Teil eines Identitätsszenarios sind. Einige typische Beispiele für einen Antragsteller sind: ein Benutzer, eine Anwendung oder ein Dienst, ein Gerät oder ein Computer. Einige typische Beispiele für einen Aussteller sind das Betriebssystem, eine Anwendung, ein Dienst, ein Rollenanbieter, ein Identitätsanbieter oder ein Verbundanbieter. Ein Aussteller stellt Ansprüche durch Ausstellen von Sicherheitstoken bereit, in der Regel über einen Sicherheitstokendienst (Security Token Service, STS). (In WIF können Sie einen STS erstellen, indem Sie von der SecurityTokenService -Klasse abgeleitet werden.) Gelegentlich kann die Sammlung von Ansprüchen, die von einem Aussteller erhalten wurden, um Antragstellerattribute erweitert werden, die direkt an der Ressource gespeichert sind. Ein Anspruch kann ausgewertet werden, um die Zugriffsrechte auf Daten und andere gesicherte Ressourcen während des Autorisierungsprozesses zu bestimmen, und kann auch verwendet werden, um Authentifizierungsentscheidungen über einen Antragsteller zu treffen oder auszudrücken.

Ab .NET 4.5 wurden die Windows Identity Foundation -Klassen (WIF), die anspruchsbasierte Identität implementieren, vollständig in die .NET Framework integriert. Das Anspruchskonzept wird von der Claim -Klasse implementiert.

Im Folgenden werden wichtige Eigenschaften der Claim -Klasse beschrieben:

• Die Type Eigenschaft ist eine Zeichenfolge (in der Regel ein URI), die die semantischen Informationen zum Anspruch enthält. Sie gibt an, was der Wert des Anspruchs bedeutet. Ein Anspruch mit dem Anspruchstyp GivenName ("http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname") stellt beispielsweise den Vornamen eines Benutzers dar. Der Wert der Type -Eigenschaft kann einer der bekannten Anspruchstypen sein, die in der ClaimTypes -Klasse definiert sind, oder es kann sich um einen beliebigen URI handeln, der vom Aussteller definiert wird. Beispielsweise kann ein Anspruchstyp "urn:spendinglimit" ein Benutzerattribute darstellen, das im Geschäftskontext des Ausstellers sinnvoll ist.

• Die Value -Eigenschaft enthält den Wert des Anspruchs. Um Abhängigkeiten zu reduzieren und die Verwaltung zu vereinfachen, wird in WIF der Wert eines Anspruchs nur als Zeichenfolge dargestellt. Für komplexere Werttypen empfiehlt es sich, standardmäßige XML-Schematypen zu verwenden, um anzugeben, wie der Wert in eine Zeichenfolge serialisiert und deserialisiert werden soll.

• Die ValueType -Eigenschaft enthält eine Zeichenfolge, die die Typinformationen für den Wert identifiziert. Diese Eigenschaft sollte verwendet werden, um das Format des Werts zu verstehen und Informationen zur Deserialisierung bereitzustellen. Wenn Ihre Lösung komplexe Werttypen erfordert, empfiehlt es sich, standard XML-Schematypen in der ValueType Eigenschaft zu verwenden, um anzugeben, wie die Value Eigenschaft in eine Zeichenfolge serialisiert und deserialisiert werden soll.

• Die Subject -Eigenschaft ist ein ClaimsIdentity -Objekt, das den Betreff des Anspruchs darstellt. Der Antragsteller des Anspruchs ist die Entität (in der Regel der Benutzer, der zugriff auf eine Ressource anfordert), für die der Anspruch geltend gemacht wird. Enthält ClaimsIdentity unter seinen Eigenschaften eine Auflistung von Ansprüchen, die die Eigenschaften und Attribute des Antragstellers beschreiben, wie von einem oder mehreren Ausstellern nachgewiesen.

• Die Issuer -Eigenschaft enthält den Namen der Entität, die den Anspruch ausgestellt hat. Der Aussteller eines Anspruchs wird in WIF durch eine Zeichenfolge dargestellt, die einen Namen enthält, der aus einer Liste bekannter Aussteller stammt, die von der Ausstellernamenregistrierung verwaltet wird. Die Ausstellernamenregistrierung ist eine instance einer Klasse, die von der IssuerNameRegistry -Klasse abgeleitet ist. Die Ausstellernamenregistrierung ordnet einen mnemonischen Namen dem kryptografischen Material zu, das zum Überprüfen der Signaturen der vom entsprechenden Aussteller erstellten Token erforderlich ist. Beispielsweise verknüpft die ConfigurationBasedIssuerNameRegistry Klasse, die in .NET 4.5 sofort verfügbar ist, den mnemonischen Namen für jeden Aussteller mit dem entsprechenden X.509-Zertifikat. Die Liste der bekannten Aussteller wird in der Regel zur Startzeit von der Ausstellernamenregistrierung erstellt. Die von ConfigurationBasedIssuerNameRegistry verwendete Liste wird in der Anwendungskonfigurationsdatei angegeben.

• Die OriginalIssuer -Eigenschaft enthält den Namen der Entität, die den Anspruch ursprünglich ausgestellt hat. Diese Eigenschaft wurde entwickelt, um Szenarien zu erleichtern, in denen ein Anspruch mehrere Aussteller durchlaufen kann, bevor er vom Client an die RP-Anwendung übergeben wird. z. B. Verbundszenarien. Sie können die OriginalIssuer -Eigenschaft untersuchen, um die Entität zu ermitteln, die den Anspruch ursprünglich ausgestellt hat. Der Name stammt aus der Liste der bekannten Aussteller, die von der Ausstellernamenregistrierung verwaltet werden, wie im Fall der Issuer Eigenschaft.

Konstruktoren

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• ClaimsIdentity
• ClaimsPrincipal
• IssuerNameRegistry