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 tokenu zabezpečení pro tokeny zpracovávané danou třídou. Tato metoda se obvykle volá službou 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 je-li vytvořen připojený odkaz; false pokud by se měl 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 z ukázky Custom Token . Tato ukázka poskytuje 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, které jsou k dispozici pro WIF a kde je stáhnout, najdete v tématu Vzorový index 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 k vrácení klauzule identifikátoru klíče (SecurityKeyIdentifierClause), kterou lze použít k vytvoření <wsse:SecurityTokenReference> elementu pro zadaný token.

Volána z implementací 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 tokenu zabezpečení vrátí token zabezpečení, vystavený 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í.