Partager via


SecurityTokenHandler.CreateSecurityTokenReference Méthode

Définition

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. Cette méthode est généralement appelée par un service d'émission de jeton de sécurité (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

Paramètres

token
SecurityToken

Jeton pour lequel la référence doit être créée.

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.

Retours

Clause d'identificateur de clé qui référence le jeton spécifié.

Exemples

Le code suivant montre comment remplacer la CreateSecurityTokenReference méthode pour créer une clause d’identificateur de clé à partir du jeton spécifié. Le code est extrait de l’exemple Custom Token . Cet exemple fournit des classes personnalisées qui permettent le traitement des jetons web simples (SWT). Pour plus d’informations sur cet exemple et d’autres exemples disponibles pour WIF et où les télécharger, consultez Index d’exemple de code WIF.

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

Remarques

Par défaut, cette méthode lève une NotImplementedException exception.

Les classes dérivées remplacent cette méthode pour retourner une clause d’identificateur de clé (SecurityKeyIdentifierClause) qui peut être utilisée pour créer un <wsse:SecurityTokenReference> élément pour le jeton spécifié.

Appelé à partir des implémentations de la SecurityTokenService classe .

En règle générale, un SecurityKeyIdentifierClause n’a pas besoin d’être utilisé, autre que lorsqu’un service de jeton de sécurité personnalisé est créé. 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. 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. En général, ces références déclarent l'authenticité du jeton de sécurité émis.

S’applique à