MachineKeySection.ValidationKey プロパティ

定義

名前空間:

System.Web.Configuration

アセンブリ:

System.Web.dll

フォーム認証データとビューステート データの検証に使用されるキー、またはキーが生成されるプロセスを取得または設定します。

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

プロパティ値

String

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

属性

TypeConverterAttribute ConfigurationPropertyAttribute StringValidatorAttribute

例

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

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

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

注釈

プロパティはValidationKey、 がtrueメッセージ認証コード (MAC) を作成し、ビューステートが改ざんされているかどうかを判断するための ASP.NET を有効にする場合enableViewStateMACに使用されます。 プロパティ ValidationKey は、プロセス外のアプリケーション固有のセッション ID を生成して、セッション状態変数がアプリケーション間で確実に分離されるようにするためにも使用されます。

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

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

"AutoGenerate" ValidationKey 値に "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。