MachineKeySection.ValidationKey プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
フォーム認証データとビューステート データの検証に使用されるキー、またはキーが生成されるプロセスを取得または設定します。
public:
property System::String ^ ValidationKey { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Configuration.WhiteSpaceTrimStringConverter))]
[System.Configuration.ConfigurationProperty("validationKey", DefaultValue="AutoGenerate,IsolateApps")]
[System.Configuration.StringValidator(MinLength=1)]
public string ValidationKey { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Configuration.WhiteSpaceTrimStringConverter))>]
[<System.Configuration.ConfigurationProperty("validationKey", DefaultValue="AutoGenerate,IsolateApps")>]
[<System.Configuration.StringValidator(MinLength=1)>]
member this.ValidationKey : string with get, set
Public Property ValidationKey As String
プロパティ値
キー値、またはキーが生成される方法を示す値。 既定値は "AutoGenerate,IsolateApps" です。
- 属性
例
次の例は、コードを使用してプロパティを設定する ValidationKey 方法を示しています。 この例は、クラスに対して提供されるより大きな例の MachineKeySection 一部です。
// Display ValidationKey property.
Console.WriteLine("ValidationKey: {0}",
configSection.ValidationKey);
' Display ValidationKey property.
Console.WriteLine("ValidationKey: {0}", _
configSection.ValidationKey)
注釈
このプロパティはValidationKey、メッセージ認証コード (MAC) を作成して、ビューステートが改ざんされているかどうかを判断するために ASP.NET を有効にする場合enableViewStateMAC``true
に使用されます。 この ValidationKey プロパティは、セッション状態変数がアプリケーション間で確実に分離されるように、アウトプロセスのアプリケーション固有のセッション ID を生成するためにも使用されます。
"AutoGenerate" オプションを使用して、ASP.NET がランダム キーを生成し、ローカル セキュリティ機関に格納することを指定します。 "AutoGenerate" オプションは既定値の一部です。
"AutoGenerateValidationKey" 値に "IsolateApps" 修飾子を追加すると、ASP.NET は、各アプリケーションを使用してアプリケーションごとに一意のAppDomainAppVirtualPath暗号化キーを生成します。 これが既定の設定です。
"AutoGenerateValidationKey" 値に "IsolateByAppId" 修飾子を追加すると、ASP.NET は、各アプリケーションを使用してアプリケーションごとに一意のAppDomainAppId暗号化キーを生成します。 2 つの異なるアプリケーションが仮想パスを共有する場合 (これらのアプリケーションが異なるポートで実行されている可能性があるため)、このフラグを使用して、それらを相互に区別できます。 "IsolateByAppId" フラグは、ASP.NET 4.5 でのみ認識されますが、設定にMachineKeySection.CompatibilityMode関係なく使用できます。
Web サーバー (Web ファーム) のネットワーク経由での構成をサポートする必要がある場合は、一貫性のある構成を確保するためにプロパティを ValidationKey 手動で設定します。 属性の値DecryptionKey
を手動で生成する方法については、「方法: ASP.NET 2.0 で MachineKey を構成する」を参照してください。
このプロパティは、通常、Web.config ファイルの machineKey 要素の属性で宣言によってvalidationKey
設定されます。