SecurityTokenHandler.CreateSecurityTokenReference(SecurityToken, Boolean) Method

Definition

En cas de substitution dans une classe dérivée, crée la référence de jeton de sécurité pour les jetons traités par cette classe.When overridden in a derived class, creates the security token reference for tokens processed by that class. Cette méthode est généralement appelée par un service d'émission de jeton de sécurité (STS).This method is typically called by a security token service (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

Parameters

token
SecurityToken

Jeton pour lequel la référence doit être créée.The token for which the reference is to be created.

attached
Boolean

true si une référence jointe doit être créée ; false si une référence non jointe doit être créée.true if an attached reference should be created; false if an unattached reference should be created.

Returns

SecurityKeyIdentifierClause

Clause d'identificateur de clé qui référence le jeton spécifié.A key identifier clause that references the specified token.

Examples

Le code suivant montre comment substituer la méthode CreateSecurityTokenReference pour créer une clause d’identificateur de clé à partir du jeton spécifié.The following code shows how to override the CreateSecurityTokenReference method to create a key identifier clause from the specified token. Le code est extrait de l’exemple Custom Token.The code is taken from the Custom Token sample. Cet exemple fournit des classes personnalisées qui permettent le traitement de jetons Web simples (SWT).This sample provides custom classes that enable processing of Simple Web Tokens (SWT). Pour plus d’informations sur cet exemple et d’autres exemples disponibles pour WIF et l’emplacement de leur téléchargement, consultez exemple d’index de code WIF.For information about this sample and other samples available for WIF and where to download them, see WIF Code Sample Index.

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

Remarks

Par défaut, cette méthode lève une exception NotImplementedException.By default this method throws a NotImplementedException exception.

Les classes dérivées substituent cette méthode pour retourner une clause d’identificateur de clé (SecurityKeyIdentifierClause) qui peut être utilisée pour créer un élément <wsse:SecurityTokenReference> pour le jeton spécifié.Derived classes override this method to return a key identifier clause (SecurityKeyIdentifierClause) that can be used to create a <wsse:SecurityTokenReference> element for the specified token.

Appelé à partir des implémentations de la classe SecurityTokenService.Called from implementations of the SecurityTokenService class.

En règle générale, il n’est pas nécessaire d’utiliser un SecurityKeyIdentifierClause, sauf lorsqu’un service d’un jeton de sécurité personnalisé est créé.Typically, a SecurityKeyIdentifierClause does not need to be used, other than when a custom security token service is created. Lorsqu'un service d'émission du jeton de sécurité retourne un jeton de sécurité, le jeton de sécurité émis contient des références à des jetons de sécurité attachés et détachés.When a security token service returns a security token, the issued security token contains references to attached and unattached security tokens. Les références attachées renvoient aux jetons de sécurité qui sont contenus dans l'en-tête de sécurité d'un message SOAP et les références détachées renvoient à des jetons de sécurité qui ne sont pas inclus dans l'en-tête de sécurité d'un message SOAP.Attached references refer to security tokens that are contained within the security header of a SOAP message and unattached references reference security tokens that are not included within the security header of a SOAP message. En général, ces références déclarent l'authenticité du jeton de sécurité émis.These references typically affirm the authenticity of the issued security token.

Applies to