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 メッセージのセキュリティ ヘッダーに含まれていないセキュリティ トークンを参照します。 これらの参照は、通常、発行されたセキュリティ トークンの信頼性を確認します。