MachineKeySection.DecryptionKey プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データの暗号化と暗号化解除に使用されるキー、またはキーが生成されるプロセスを取得または設定します。
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 要素を参照してください。