SecurityTokenHandler.CreateSecurityTokenReference Methode

Referenz

Definition

Namespace:: System.IdentityModel.Tokens

Assembly:: System.IdentityModel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt bei Überschreibung in einer abgeleiteten Klasse den Sicherheitstokenverweis für die von dieser Klasse verarbeiteten Token. Diese Methode wird in der Regel von einem Sicherheitstokendienst (STS) aufgerufen.

public:
 virtual System::IdentityModel::Tokens::SecurityKeyIdentifierClause ^ CreateSecurityTokenReference(System::IdentityModel::Tokens::SecurityToken ^ token, bool attached);

public virtual System.IdentityModel.Tokens.SecurityKeyIdentifierClause CreateSecurityTokenReference (System.IdentityModel.Tokens.SecurityToken token, bool attached);

abstract member CreateSecurityTokenReference : System.IdentityModel.Tokens.SecurityToken * bool -> System.IdentityModel.Tokens.SecurityKeyIdentifierClause
override this.CreateSecurityTokenReference : System.IdentityModel.Tokens.SecurityToken * bool -> System.IdentityModel.Tokens.SecurityKeyIdentifierClause

Public Overridable Function CreateSecurityTokenReference (token As SecurityToken, attached As Boolean) As SecurityKeyIdentifierClause

Parameter

token: SecurityToken

Das Token, für das der Verweis erstellt werden soll.

attached: Boolean

true, wenn ein angefügter Verweis erstellt werden soll; false, wenn ein nicht angefügter Verweis erstellt werden soll.

Gibt zurück

SecurityKeyIdentifierClause

Eine Schlüsselbezeichnerklausel, die auf das angegebene Token verweist.

Beispiele

Der folgende Code zeigt, wie Sie die CreateSecurityTokenReference -Methode überschreiben, um eine Schlüsselbezeichnerklausel aus dem angegebenen Token zu erstellen. Der Code wird aus dem Custom Token Beispiel entnommen. Dieses Beispiel stellt benutzerdefinierte Klassen bereit, die die Verarbeitung von Einfachen Webtoken (SWT) ermöglichen. Informationen zu diesem Beispiel und zu anderen für WIF verfügbaren Beispielen und zu ihren Downloadmöglichkeiten finden Sie unter WIF-Codebeispielindex.

public override SecurityKeyIdentifierClause CreateSecurityTokenReference(SecurityToken token, bool attached)
{
    return token.CreateKeyIdentifierClause<LocalIdKeyIdentifierClause>();           
}

Hinweise

Standardmäßig löst diese Methode eine Ausnahme aus NotImplementedException .

Abgeleitete Klassen überschreiben diese Methode, um eine Schlüsselbezeichnerklausel (SecurityKeyIdentifierClause) zurückzugeben, die zum Erstellen eines <wsse:SecurityTokenReference> Elements für das angegebene Token verwendet werden kann.

Wird von Implementierungen der SecurityTokenService -Klasse aufgerufen.

In der Regel muss ein SecurityKeyIdentifierClause nicht verwendet werden, außer beim Erstellen eines benutzerdefinierten Sicherheitstokendiensts. Wenn ein Sicherheitstokendienst ein Sicherheitstoken zurückgibt, enthält das ausgegebene Sicherheitstoken Verweise auf angefügte und nicht angefügte Sicherheitstoken. Die angefügten Verweise beziehen sich auf Sicherheitstoken, die im Sicherheitsheader einer SOAP-Nachricht enthalten sind, und nicht angehängte Verweise beziehen sich auf Sicherheitstoken, die nicht im Sicherheitsheader einer SOAP-Nachricht enthalten sind. Diese Verweise bestätigen in der Regel die Echtheit des ausgegebenen Sicherheitstokens.

Gilt für:

Share via