SecurityTokenHandler.CreateSecurityTokenReference Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Po zastąpieniu w klasie pochodnej tworzy odwołanie do tokenu zabezpieczającego dla tokenów przetworzonych przez klasę. Ta metoda jest zwykle wywoływana przez usługę tokenu zabezpieczającego (STS).
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
Parametry
- token
- SecurityToken
Token, dla którego ma zostać utworzone odwołanie.
- attached
- Boolean
true
jeśli należy utworzyć dołączone odwołanie; false
jeśli należy utworzyć niedołączone odwołanie.
Zwraca
Klauzula identyfikatora klucza, która odwołuje się do określonego tokenu.
Przykłady
Poniższy kod pokazuje, jak zastąpić metodę CreateSecurityTokenReference , aby utworzyć klauzulę identyfikatora klucza na podstawie określonego tokenu. Kod jest pobierany z przykładu Custom Token
. Ten przykład zawiera klasy niestandardowe, które umożliwiają przetwarzanie prostych tokenów internetowych (SWT). Aby uzyskać informacje na temat tego przykładu i innych przykładów dostępnych dla programu WIF oraz miejsca ich pobierania, zobacz Przykładowy indeks kodu programu WIF.
public override SecurityKeyIdentifierClause CreateSecurityTokenReference(SecurityToken token, bool attached)
{
return token.CreateKeyIdentifierClause<LocalIdKeyIdentifierClause>();
}
Uwagi
Domyślnie ta metoda zgłasza NotImplementedException wyjątek.
Klasy pochodne zastępują tę metodę, aby zwrócić klauzulę identyfikatora klucza (SecurityKeyIdentifierClause), która może służyć do utworzenia <wsse:SecurityTokenReference>
elementu dla określonego tokenu.
Wywoływane z implementacji SecurityTokenService klasy .
Zazwyczaj nie trzeba używać elementu SecurityKeyIdentifierClause innego niż podczas tworzenia niestandardowej usługi tokenu zabezpieczającego. Gdy usługa tokenu zabezpieczającego zwraca token zabezpieczający, wystawiony token zabezpieczający zawiera odwołania do dołączonych i niedołączonych tokenów zabezpieczających. Dołączone odwołania odnoszą się do tokenów zabezpieczających, które znajdują się w nagłówku zabezpieczeń komunikatu PROTOKOŁU SOAP i niedołączone odwołania odwołują się do tokenów zabezpieczających, które nie są uwzględnione w nagłówku zabezpieczeń komunikatu PROTOKOŁU SOAP. Odwołania te zwykle potwierdzają autentyczność wystawionego tokenu zabezpieczającego.