MachineKeySection.DecryptionKey プロパティ

定義

データの暗号化と暗号化解除に使用されるキー、またはキーが生成されるプロセスを取得または設定します。

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

プロパティ値

キー値、またはキーの生成方法を示す値。 既定値は "AutoGenerate,IsolateApps" です。

属性

次の例では、コードを使用して DecryptionKey プロパティを設定する方法を示します。 この例は、 MachineKeySection クラスに提供されるより大きな例の一部です。

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

注釈

DecryptionKey プロパティは、Windows フォーム認証などの暗号化と復号化、および Validation プロパティが "3DES" または "AES" に設定されている場合のビューステートに使用されます。

"AutoGenerate" オプションを使用して、ASP.NET がランダム キーを生成し、ローカル セキュリティ機関に格納するように指定します。 "AutoGenerate" オプションは既定値の一部です。

"AutoGenerate" ValidationKey 値に "IsolateApps" 修飾子を追加すると、ASP.NET は各アプリケーションの AppDomainAppVirtualPathを使用して、アプリケーションごとに一意の暗号化キーを生成します。 これは、既定の設定です。

"AutoGenerate" ValidationKey 値に "IsolateByAppId" 修飾子を追加すると、ASP.NET は各アプリケーションの AppDomainAppIdを使用して、アプリケーションごとに一意の暗号化キーを生成します。 2 つの異なるアプリケーションが仮想パスを共有している場合 (たとえば、それらのアプリケーションが異なるポートで実行されているため)、このフラグを使用して相互に区別することができます。 "IsolateByAppId" フラグは、ASP.NET 4.5 でのみ認識されますが、 MachineKeySection.CompatibilityMode 設定に関係なく使用できます。

Web サーバー (Web ファーム) のネットワーク全体の構成をサポートする必要がある場合は、 DecryptionKey プロパティを手動で設定して、一貫性のある構成を確保します。 DecryptionKey属性の値を手動で生成する方法については、「方法: ASP.NET 2.0 で MachineKey を構成する」を参照してください。

このプロパティは、通常、Web.config ファイルの machineKey 要素のDecryptionKey属性で宣言によって設定されます。 詳細については、 machineKey 要素を参照してください。

適用対象

こちらもご覧ください