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 サンプルから取得します。 このサンプルでは、Simple Web Tokens (SWT) の処理を有効にするカスタム クラスを提供します。 WIF で使用できるこのサンプルとその他のサンプルの詳細については、 WIF コード サンプル インデックスを参照してください。

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

注釈

既定では、このメソッドは NotImplementedException 例外をスローします。

派生クラスは、このメソッドをオーバーライドして、指定したトークンの<wsse:SecurityTokenReference>要素を作成するために使用できるキー識別子句 (SecurityKeyIdentifierClause) を返します。

SecurityTokenService クラスの実装から呼び出されます。

通常、カスタム セキュリティ トークン サービスが作成される場合を除き、 SecurityKeyIdentifierClause を使用する必要はありません。 セキュリティ トークン サービスがセキュリティ トークンを返すと、発行されたセキュリティ トークンには、アタッチされたセキュリティ トークンとアタッチされていないセキュリティ トークンへの参照が含まれます。 添付参照は、SOAP メッセージのセキュリティ ヘッダー内に含まれるセキュリティ トークンを参照し、接続されていない参照は、SOAP メッセージのセキュリティ ヘッダーに含まれていないセキュリティ トークンを参照します。 これらの参照は、通常、発行されたセキュリティ トークンの信頼性を確認します。

適用対象