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 du 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 lorsqu’il enableViewStateMAC s’agit true de 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 spécifiques à l’application hors processus pour s’assurer 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 des données de AppDomainAppVirtualPathchaque application. 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 AppDomainAppIdchaque application. Si deux applications distinctes partagent un chemin d’accès virtuel (peut-être parce que ces applications s’exécutent sur différents ports), cet indicateur peut être utilisé pour les distinguer davantage des uns des autres. L’indicateur « IsolateByAppId » est compris uniquement par ASP.NET 4.5, mais il peut être utilisé indépendamment du 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 génération manuelle de valeurs pour l’attributDecryptionKey, consultez Guide pratique pour configurer MachineKey dans 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.