SecurityTokenHandler.CreateSecurityTokenReference 方法

定義

命名空間:

System.IdentityModel.Tokens

組件:

System.IdentityModel.dll

在衍生類別中覆寫時，建立該類別所處理之權杖的安全性權杖參考。 這個方法通常是由安全性權杖服務 (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

參數

token

SecurityToken

要為其建立參考的權杖。

attached

Boolean

如果應建立附加的參考，則為 true，如果應建立為未附加的參考，則為 false。

傳回

SecurityKeyIdentifierClause

參考所指定語彙基元的索引鍵識別項子句。

範例

下列程式代碼示範如何覆寫 CreateSecurityTokenReference 方法，以從指定的令牌建立密鑰標識子句。 程式代碼取自 Custom Token 範例。 此範例提供自定義類別，可讓您處理簡單 Web 令牌 (SWT) 。 如需此範例和其他可供 WIF 下載範例的資訊，請參閱 WIF 程式代碼範例索引。

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

備註

根據預設，這個方法會擲回例外狀況 NotImplementedException 。

衍生類別會覆寫這個方法，以傳回索引鍵標識子子句 (SecurityKeyIdentifierClause) ，可用來為指定的標記建立 <wsse:SecurityTokenReference> 元素。

從類別的實作呼叫 SecurityTokenService 。

一般而言， SecurityKeyIdentifierClause 不需要使用 ，而不是建立自定義安全性令牌服務時。 當安全性權杖服務傳回安全性權杖時，所發出的安全性權杖會包含已附加及未附加之安全性權杖的參考。 附加的參考會參考包含在 SOAP 訊息之安全性標頭中的安全性權杖，而未附加的參考則會參考未包含在 SOAP 訊息之安全性標頭中的安全性權杖。 這些參考通常會證明這些發出之安全性權杖的真實性。