SecurityTokenHandler.CreateSecurityTokenReference Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.SecurityKeyIdentifierClausePublic Overridable Function CreateSecurityTokenReference (token As SecurityToken, attached As Boolean) As SecurityKeyIdentifierClauseParamè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.
