SecurityTokenHandler.CreateSecurityTokenReference Metoda

Definice

Obor názvů:

System.IdentityModel.Tokens

Sestavení:

System.IdentityModel.dll

Při přepsání v odvozené třídě vytvoří odkaz na tokeny zabezpečení pro tokeny zpracovávané danou třídou. Tuto metodu obvykle volá služba tokenů zabezpečení (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, pro který se má vytvořit odkaz.

attached

Boolean

true pokud by měl být vytvořen připojený odkaz; false pokud se má vytvořit nepřipojený odkaz.

Návraty

SecurityKeyIdentifierClause

Klauzule identifikátoru klíče, která odkazuje na zadaný token.

Příklady

Následující kód ukazuje, jak přepsat metodu CreateSecurityTokenReference pro vytvoření klauzule identifikátoru klíče ze zadaného tokenu. Kód je převzat ze Custom Token vzorku. Tato ukázka obsahuje vlastní třídy, které umožňují zpracování jednoduchých webových tokenů (SWT). Informace o této ukázce a dalších ukázkách dostupných pro WIF a o tom, kde je stáhnout, najdete v tématu Index vzorového kódu WIF.

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

Poznámky

Ve výchozím nastavení tato metoda vyvolá NotImplementedException výjimku.

Odvozené třídy přepíší tuto metodu tak, že vrátí klauzuli identifikátoru klíče (SecurityKeyIdentifierClause), která se dá použít k vytvoření elementu <wsse:SecurityTokenReference> pro zadaný token.

Volána z implementace SecurityTokenService třídy .

Obvykle není nutné použít jinou SecurityKeyIdentifierClause službu než při vytvoření vlastní služby tokenů zabezpečení. Když služba tokenů zabezpečení vrátí token zabezpečení, vydaný token zabezpečení obsahuje odkazy na připojené a nepřipojené tokeny zabezpečení. Připojené odkazy odkazují na tokeny zabezpečení obsažené v hlavičce zabezpečení zprávy SOAP a nepřipojené odkazy odkazují na tokeny zabezpečení, které nejsou zahrnuty v hlavičce zabezpečení zprávy SOAP. Tyto odkazy obvykle potvrzují pravost vydaného tokenu zabezpečení.