SecurityTokenHandler.CreateSecurityTokenReference Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.IdentityModel.Tokens

Zestaw:: System.IdentityModel.dll

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

SecurityKeyIdentifierClause

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.

Dotyczy