Freigeben über


SecurityTokenHandler.CreateSecurityTokenReference Methode

Definition

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

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: