MachineKeySection.DecryptionKey Propriété

Définition

Obtient ou définit la clé utilisée pour chiffrer et déchiffrer les données, ou le processus par lequel la clé est générée.

public:
 property System::String ^ DecryptionKey { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Configuration.WhiteSpaceTrimStringConverter))]
[System.Configuration.ConfigurationProperty("decryptionKey", DefaultValue="AutoGenerate,IsolateApps")]
[System.Configuration.StringValidator(MinLength=1)]
public string DecryptionKey { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Configuration.WhiteSpaceTrimStringConverter))>]
[<System.Configuration.ConfigurationProperty("decryptionKey", DefaultValue="AutoGenerate,IsolateApps")>]
[<System.Configuration.StringValidator(MinLength=1)>]
member this.DecryptionKey : string with get, set
Public Property DecryptionKey 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

Exemples

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

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

Remarques

La DecryptionKey propriété est utilisée pour le chiffrement et le déchiffrement, comme dans l’authentification Windows Forms, et pour l’état d’affichage lorsque la Validation propriété est définie sur « 3DES » ou « AES ».

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 DecryptionKey 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 DecryptionKey de l’élément machineKey du fichier Web.config. Pour plus d’informations, consultez l’élément MachineKey .

S’applique à

Voir aussi