Udostępnij za pośrednictwem

MachineKeySection.DecryptionKey Właściwość

Definicja

Przestrzeń nazw:
System.Web.Configuration
Zestaw:
System.Web.dll

Pobiera lub ustawia klucz używany do szyfrowania i odszyfrowywania danych lub procesu, za pomocą którego jest generowany klucz.

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

Wartość właściwości

String

Wartość klucza lub wartość wskazująca sposób generowania klucza. Wartość domyślna to "AutoGenerate,IsolateApps".

Atrybuty
TypeConverterAttribute ConfigurationPropertyAttribute StringValidatorAttribute

Przykłady

W poniższym przykładzie pokazano, jak ustawić DecryptionKey właściwość przy użyciu kodu. Ten przykład jest częścią większego przykładu udostępnionego MachineKeySection dla klasy .

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

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

Uwagi

Właściwość DecryptionKey jest używana do szyfrowania i odszyfrowywania, na przykład w uwierzytelnianiu formularzy systemu Windows, oraz do wyświetlania stanu, gdy Validation właściwość jest ustawiona na wartość "3DES" lub "AES".

Użyj opcji "AutoGenerate", aby określić, że ASP.NET generuje losowy klucz i przechowuje go w lokalnym urzędzie zabezpieczeń. Opcja "AutoGenerate" jest częścią wartości domyślnej.

Jeśli dodasz modyfikator "IsolateApps" do wartości "AutoGenerate" ValidationKey , ASP.NET generuje unikatowy zaszyfrowany klucz dla każdej aplikacji przy użyciu każdej aplikacji AppDomainAppVirtualPath. Jest to ustawienie domyślne.

Jeśli dodasz modyfikator "IsolateByAppId" do wartości "AutoGenerate" ValidationKey , ASP.NET generuje unikatowy zaszyfrowany klucz dla każdej aplikacji przy użyciu każdej aplikacji AppDomainAppId. Jeśli dwie odrębne aplikacje współużytkują ścieżkę wirtualną (na przykład dlatego, że te aplikacje są uruchomione na różnych portach), tej flagi można użyć do dalszego odróżnienia ich od siebie. Flaga "IsolateByAppId" jest rozumiana tylko przez ASP.NET 4.5, ale może być używana niezależnie od MachineKeySection.CompatibilityMode ustawienia.

Jeśli musisz obsługiwać konfigurację w sieci serwerów sieci Web (farma sieci Web), ustaw DecryptionKey właściwość ręcznie, aby zapewnić spójną konfigurację. Aby uzyskać informacje na temat ręcznego generowania wartości dla atrybutu DecryptionKey , zobacz How To: Configure MachineKey in ASP.NET 2.0 (Jak skonfigurować klucz maszyny w programie ASP.NET 2.0).

Ta właściwość jest zwykle ustawiana deklaratywnie w DecryptionKey atrybucie elementu machineKey pliku Web.config. Aby uzyskać więcej informacji, zobacz element machineKey .

Dotyczy

Zobacz też