SecurityTokenHandler.CreateSecurityTokenReference Methode
Definition
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.
Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, wird der Sicherheitstokenverweis für von dieser Klasse verarbeitete Token erstellt. Diese Methode wird in der Regel von einem Sicherheitstokendienst (Security Token Service, 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.SecurityKeyIdentifierClausePublic Overridable Function CreateSecurityTokenReference (token As SecurityToken, attached As Boolean) As SecurityKeyIdentifierClauseParameter
- 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 die CreateSecurityTokenReference Methode überschreiben, um eine Schlüsselbezeichnerklausel aus dem angegebenen Token zu erstellen. Der Code stammt aus dem Custom Token Beispiel. Dieses Beispiel enthält benutzerdefinierte Klassen, die die Verarbeitung einfacher Webtoken (SIMPLE Web Tokens, SWT) ermöglichen. Informationen zu diesem Beispiel und anderen Beispielen, die für WIF verfügbar sind und wo sie heruntergeladen werden sollen, finden Sie unter WIF Code Sample Index.
public override SecurityKeyIdentifierClause CreateSecurityTokenReference(SecurityToken token, bool attached)
{
return token.CreateKeyIdentifierClause<LocalIdKeyIdentifierClause>();
}
Hinweise
Standardmäßig löst diese Methode eine NotImplementedException Ausnahme aus.
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.
Von Implementierungen der SecurityTokenService Klasse aufgerufen.
In der Regel muss eine SecurityKeyIdentifierClause andere verwendet werden, als wenn ein benutzerdefinierter Sicherheitstokendienst erstellt wird. Wenn ein Sicherheitstokendienst ein Sicherheitstoken zurückgibt, enthält das ausgestellte Sicherheitstoken Verweise auf angefügte und nicht angefügte Sicherheitstoken. Angefügte Verweise beziehen sich auf Sicherheitstoken, die im Sicherheitsheader einer SOAP-Nachricht enthalten sind, und nicht angefügte Verweise verweisen auf Sicherheitstoken, die nicht im Sicherheitsheader einer SOAP-Nachricht enthalten sind. Diese Verweise bestätigen in der Regel die Authentizität des ausgestellten Sicherheitstokens.
