MachineKeySection.DecryptionKey Eigenschaft

Definition

Ruft den Schlüssel ab, mit dem Daten verschlüsselt und entschlüsselt werden, oder den Prozess, durch den der Schlüssel generiert wird, oder legt den Schlüssel bzw. den Prozess fest.

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

Eigenschaftswert

Ein Schlüsselwert oder ein Wert, der angibt, wie der Schlüssel generiert wird. Der Standardwert ist "AutoGenerate,IsolateApps".

Attribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die DecryptionKey -Eigenschaft mithilfe von Code festgelegt wird. Dieses Beispiel ist Teil eines größeren Beispiels, das für die MachineKeySection -Klasse bereitgestellt wird.

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

Hinweise

Die DecryptionKey -Eigenschaft wird für die Ver- und Entschlüsselung verwendet, z. B. bei der Windows Forms-Authentifizierung, und für den Ansichtszustand, wenn die Validation Eigenschaft auf "3DES" oder "AES" festgelegt ist.

Verwenden Sie die Option "AutoGenerate", um anzugeben, dass ASP.NET einen zufälligen Schlüssel generiert und in der lokalen Sicherheitsbehörde speichert. Die Option "AutoGenerate" ist Teil des Standardwerts.

Wenn Sie dem Wert "AutoGenerate" den Modifizierer "IsolateApps" ValidationKey hinzufügen, generiert ASP.NET einen eindeutigen verschlüsselten Schlüssel für jede Anwendung, indem sie den -Wert jeder AppDomainAppVirtualPathAnwendung verwendet. Dies ist die Standardeinstellung.

Wenn Sie dem Wert "AutoGenerate" den Modifizierer "IsolateByAppId" ValidationKey hinzufügen, generiert ASP.NET einen eindeutigen verschlüsselten Schlüssel für jede Anwendung, indem sie den -Wert jeder AppDomainAppIdAnwendung verwendet. Wenn zwei unterschiedliche Anwendungen einen virtuellen Pfad gemeinsam nutzen (möglicherweise, weil diese Anwendungen an unterschiedlichen Ports ausgeführt werden), kann dieses Flag verwendet werden, um sie weiter voneinander zu unterscheiden. Das Flag "IsolateByAppId" wird nur von ASP.NET 4.5 verstanden, kann aber unabhängig von der MachineKeySection.CompatibilityMode Einstellung verwendet werden.

Wenn Sie die Konfiguration über ein Netzwerk von Webservern (eine Webfarm) hinweg unterstützen müssen, legen Sie die DecryptionKey -Eigenschaft manuell fest, um eine konsistente Konfiguration sicherzustellen. Informationen zum manuellen Generieren von Werten für das DecryptionKey Attribut finden Sie unter Vorgehensweise: Konfigurieren von MachineKey in ASP.NET 2.0.

Diese Eigenschaft wird in der DecryptionKey Regel deklarativ im Attribut des machineKey-Elements der Web.config-Datei festgelegt. Weitere Informationen finden Sie im MachineKey-Element .

Gilt für:

Weitere Informationen