SessionSecurityToken.IsReferenceMode Property

Definition

Obtient ou définit une valeur indiquant si le jeton de sécurité de session fonctionne en mode de référence.Gets or sets a value that indicates whether the session security token is operating in reference mode.

public:
 property bool IsReferenceMode { bool get(); void set(bool value); };
public bool IsReferenceMode { get; set; }
member this.IsReferenceMode : bool with get, set
Public Property IsReferenceMode As Boolean

Property Value

Boolean

true si le jeton s'exécute en mode de session ; sinon, false.true if the token is operating in session mode; otherwise, false.

Remarks

En mode de référence, un artefact simple est produit au cours de la sérialisation et le matériel de jeton est stocké dans le cache de jeton associé au gestionnaire de jetons.In reference mode, a simple artifact is produced during serialization and the token material is stored in the token cache that is associated with the token handler. Le cache de jeton est une instance d’une classe qui dérive de SessionSecurityTokenCache.The token cache is an instance of a class that derives from SessionSecurityTokenCache. Pour les scénarios de batterie de serveurs Web, le cache de jeton doit fonctionner sur tous les nœuds de la batterie de serveurs.For Web Farm scenarios, the token cache must operate across all nodes in the farm.

Important

Pour fonctionner en mode de référence, Microsoft recommande de fournir un gestionnaire pour l’événement WSFederationAuthenticationModule.SessionSecurityTokenCreated dans le fichier global.asax.cs et de définir la propriété IsReferenceMode sur le jeton transmis dans la propriété SessionSecurityTokenCreatedEventArgs.SessionToken.To operate in reference mode, Microsoft recommends providing a handler for the WSFederationAuthenticationModule.SessionSecurityTokenCreated event in the global.asax.cs file and setting the IsReferenceMode property on the token passed in the SessionSecurityTokenCreatedEventArgs.SessionToken property. Cela permet de s’assurer que le jeton de session fonctionne en mode de référence pour chaque demande et qu’il est préférable de définir simplement la propriété SessionAuthenticationModule.IsReferenceMode sur le module d’authentification de session.This will ensure that the session token operates in reference mode for every request and is favored over merely setting the SessionAuthenticationModule.IsReferenceMode property on the Session Authentication Module.

Applies to

See also