MachineKeySection.ValidationKey Propriété

Définition

Espace de noms:

System.Web.Configuration

Assembly:

System.Web.dll

Obtient ou définit la clé utilisée pour valider l'authentification par formulaire et les données d'état d'affichage, ou le processus par lequel la clé est générée.

public:
 property System::String ^ ValidationKey { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.TypeConverter(typeof(System.Configuration.WhiteSpaceTrimStringConverter))]
[System.Configuration.ConfigurationProperty("validationKey", DefaultValue="AutoGenerate,IsolateApps")]
[System.Configuration.StringValidator(MinLength=1)]
public string ValidationKey { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Configuration.WhiteSpaceTrimStringConverter))>]
[<System.Configuration.ConfigurationProperty("validationKey", DefaultValue="AutoGenerate,IsolateApps")>]
[<System.Configuration.StringValidator(MinLength=1)>]
member this.ValidationKey : string with get, set

Public Property ValidationKey As String

Valeur de propriété

String

Valeur de clé ou valeur qui indique comment la clé est générée. La valeur par défaut est « AutoGenerate,IsolateApps ».

Attributs

TypeConverterAttribute ConfigurationPropertyAttribute StringValidatorAttribute

Exemples

L’exemple suivant montre comment définir la propriété à l’aide ValidationKey de code. Cet exemple fait partie d’un exemple plus grand fourni pour la MachineKeySection classe .

// Display ValidationKey property.
Console.WriteLine("ValidationKey: {0}",
  configSection.ValidationKey);

' Display ValidationKey property.
Console.WriteLine("ValidationKey: {0}", _
 configSection.ValidationKey)

Remarques

La ValidationKey propriété est utilisée quand enableViewStateMAC est true pour créer un code d’authentification de message (MAC) pour permettre à ASP.NET de déterminer si l’état d’affichage a été falsifié. La ValidationKey propriété est également utilisée pour générer des ID de session hors processus spécifiques à l’application afin de garantir que les variables d’état de session sont isolées entre les applications.

Utilisez l’option « AutoGenerate » pour spécifier que ASP.NET génère une clé aléatoire et la stocke dans l’autorité de sécurité locale. L’option « AutoGenerate » fait partie de la valeur par défaut.

Si vous ajoutez le modificateur « IsolateApps » à la valeur « AutoGenerate », ValidationKey ASP.NET génère une clé chiffrée unique pour chaque application à l’aide de AppDomainAppVirtualPath. Il s'agit du paramètre par défaut.

Si vous ajoutez le modificateur « IsolateByAppId » à la valeur « AutoGenerate », ValidationKey ASP.NET génère une clé chiffrée unique pour chaque application à l’aide de AppDomainAppId. Si deux applications distinctes partagent un chemin d’accès virtuel (peut-être parce que ces applications s’exécutent sur des ports différents), cet indicateur peut être utilisé pour les distinguer davantage les unes des autres. L’indicateur « IsolateByAppId » est compris uniquement par ASP.NET 4.5, mais il peut être utilisé quel que soit le MachineKeySection.CompatibilityMode paramètre.

Si vous devez prendre en charge la configuration sur un réseau de serveurs Web (une batterie de serveurs Web), définissez la ValidationKey propriété manuellement pour garantir une configuration cohérente. Pour plus d’informations sur la façon de générer manuellement des valeurs pour l’attribut DecryptionKey , consultez How To : Configure MachineKey in ASP.NET 2.0.

Cette propriété est généralement définie de manière déclarative dans l’attribut validationKey de l’élément machineKey du fichier Web.config.