匯出 (0) 列印
全部展開
本文章是由人工翻譯。 將指標移到文章內的文字上方即可查看原文。
譯文
原文

machineKey 項目 (ASP.NET 設定結構描述)

[本文件僅供預覽,在更新的版本中可能會有所變更。空白標題會以預留位置表示。]

設定演算法和金鑰以用於表單驗證資料及檢視狀態資料的加密、解密和驗證,並用於跨處理序 (Out-Of-Process) 工作階段狀態識別。

<machineKey 
  validationKey="AutoGenerate,IsolateApps" [String]
  decryptionKey="AutoGenerate,IsolateApps" [String]
  validation="HMACSHA256" [SHA1 | MD5 | 3DES | AES | HMACSHA256 | 
    HMACSHA384 | HMACSHA512 | alg:algorithm_name]
  decryption="Auto" [Auto | DES | 3DES | AES | alg:algorithm_name]
/>

下列章節會說明屬性、子項目和父項目。

屬性

屬性

描述

decryption

選擇性 String 屬性。

指定用於加密和解密表單驗證資料的演算法。

這個屬性可能會具有下列其中一個值:

  • Auto 指定該 ASP.NET 自動判斷要使用的加密演算法。 這是這個屬性的預設值。

  • AES 指定 ASP.NET 使用AES (Rijndael) 演算法來加密和解密資料。 AES 是預設演算法,用於此屬性的值為 Auto 時。 這個演算法符合聯邦資訊處理標準 (FIPS)。

  • DES 指定 ASP.NET 使用資料加密標準 (DES) 演算法來加密和解密資料。 包含這個演算法僅是為了配合舊版,只有在需要與 ASP.NET 早期版本相容時才應該使用它。

  • 3DES 指定 ASP.NET 使用 TripleDES 演算法 (3DES) 加密和解密資料。 包含這個演算法僅是為了配合舊版,只有在需要與 ASP.NET 早期版本相容時才應該使用它。

  • alg: algorithm_name指定 ASP.NET 使用自訂演算法加密及解密資料。 必須在衍生自 SymmetricAlgorithm 的類別中定義的加密演算法。 ASP.NET 會呼叫 SymmetricAlgorithm.Create 方法並傳入這裡所指定的演算法名稱。

decryptionKey

必要的 String 屬性。

指定用於加密和解密資料的金鑰,或是產生金鑰的程序。 當檢視狀態已加密時,這個屬性會用於表單驗證加密和解密,以及檢視狀態加密和解密。

這個屬性可能會具有下列其中一個值:

  • AutoGenerate, IsolateApps 指定自動產生索引鍵。 此為預設值。 AutoGenerate 修飾詞指定 ASP.NET 產生隨機金鑰,並將它儲存在本機安全性授權 (LSA) 中。 IsolateApps 修飾詞指定 ASP.NET 使用每個應用程式的應用程式 ID 為每個應用程式產生唯一的金鑰。

  • 機碼值指定手動指派的金鑰。 您必須手動地將 decryptionKey 值設定為十六進位字元的字串,以確保整個 Web 伺服陣列中的所有伺服器都有一致的組態。 金鑰在 DES 加密中的長度應為 64 位元 (16 個十六進位字元),在 3DES 中的長度應為 192 位元 (48 個十六進位字元)。 若為AES,索引鍵可以是 128 位元 (32 個字元)、 192 位元 (48 個字元),或是 256 個位元 (64 個字元)長。 最長的金鑰會提供最大的安全性。隨機金鑰可以使用 RNGCryptoServiceProvider類別手動產生。 如需詳細資訊,請參閱How To:在 ASP.NET 2.0 中設定 MachineKey

如需詳細資訊,請參閱 DecryptionKey

validation

必要的 MachineKeyValidation 屬性。

指定用來驗證資料的雜湊演算法。

預設會以 Base-64 編碼字串形式傳輸檢視狀態。 雖然編碼資料看起來難以理解,但 base 64 編碼並不安全,因為它很容易解碼。 如果您將機密資料儲存在檢視狀態中,除了驗證外,可以指定 ASP.NET 加密檢視狀態資料。 您可以為 Web 應用程式的所有頁面或選取的頁面指定檢視狀態加密。 如需此選項的資訊,請參閱ViewStateEncryptionModeRegisterRequiresViewStateEncryption().

如果您想使用檢視狀態加密,請將此屬性設為AES. 在這種情況下,decryptionKey 的值將用於加密檢視狀態資料,而且 ASP.NET 將使用HMACSHA1雜湊演算法進行資料驗證。

這個屬性可能會具有下列其中一個值。

  • AES 當加密檢視狀態時,指定 ASP.NET 使用AES (Rijndael) 加密演算法來加密和解密資料。 如果為validation屬性指定此選項,會使用HMACSHA1演算法進行驗證。

  • MD5 會指定 ASP.NET 使用訊息摘要 5 (MD5) 雜湊演算法驗證資料。 包含這個演算法僅是為了配合舊版,只有在需要與 ASP.NET 早期版本相容時才應該使用它。

  • SHA1 會指定 ASP.NET 使用 HMACSHA1 雜湊演算法來驗證資料。 只有在需要將這個屬性設定為 AES 以支援檢視狀態加密時,才應該使用這個演算法。 否則,使用 HMACSHA256, HMACSHA384HMACSHA512

  • 3DES 指定 ASP.NET 在檢視狀態加密時使用TripleDES(3DES) 演算法來加密和解密資料。 如果為validation屬性指定此選項,會使用HMACSHA1演算法進行驗證。 包含這個演算法僅是為了配合舊版,只有在需要與 ASP.NET 早期版本相容時才應該使用它。

  • HMACSHA256 會指定 ASP.NET 使用 HMACSHA256 雜湊演算法來驗證資料。 此為預設值。 這個演算法符合美國聯邦資訊處理標準 (FIPS)。

  • HMACSHA384 會指定 ASP.NET 使用 HMACSHA384 雜湊演算法來驗證資料。 這個選項可供所需安全性比 HMACSHA256 演算法提供之安全性更強大的應用程式使用。 這個演算法符合聯邦資訊處理標準 (FIPS)。

  • HMACSHA512 會指定 ASP.NET 使用 HMACSHA512 雜湊演算法來驗證資料。 這個選項可供所需安全性比 HMACSHA384 演算法提供之安全性更強大的應用程式使用。 這個演算法符合聯邦資訊處理標準 (FIPS)。

  • alg: algorithm_name  指定 ASP.NET 使用自訂演算法。 前置詞 "alg:" 後面會跟隨衍生自 KeyedHashAlgorithm 之類別的名稱。 ASP.NET 會呼叫 Create() 方法並傳入這裡所指定的演算法名稱。

validationKey

必要的 String 屬性。

指定用來驗證資料的金鑰,或是產生金鑰的處理序。 validationKey 值也可用來產生跨處理序和應用程式特定的工作階段 ID,以確保工作階段狀態變數會在工作階段之間隔離。

這個屬性可能會具有下列其中一個值:

  • AutoGenerate, IsolateApps 指定自動產生索引鍵。 此為預設值。 AutoGenerate 修飾詞指定 ASP.NET 產生隨機金鑰,並將它儲存在本機安全性授權 (LSA) 中。 IsolateApps 修飾詞指定 ASP.NET 使用每個應用程式的應用程式 ID 為每個應用程式產生唯一的金鑰。

  • 機碼值指定手動指派的金鑰。 您必須手動地將 validationKey 值設定為十六進位字元的字串,以確保整個 Web 伺服陣列中的所有伺服器都有一致的組態。 金鑰的長度取決於所使用的雜湊演算法:

    • AES 需要 256 位元金鑰 (64 個十六進位字元)。

    • MD5 需要 128 位元金鑰 (32 個十六進位字元)。

    • SHA1 需要 160 位元金鑰 (40 個十六進位字元)。

    • 3DES 要求 192 位元的金鑰 (48 個十六進位字元)。

    • HMACSHA256 需要 256 位元金鑰 (64 個十六進位字元)。

    • HMACSHA384 需要 384 位元金鑰 (96 個十六進位字元)。

    • HMACSHA512 需要 512 位元金鑰 (128 個十六進位字元)。

    可以透過使用 RNGCryptoServiceProvider類別手動產生隨機金鑰。 如需詳細資訊,請參閱How To:在 ASP.NET 2.0 中設定 MachineKey 本主題不會列出 HMACSHA256HMACSHA384HMACSHA512 演算法。 不過,流程也適用於這些演算法,只要您指定正確的索引鍵長度即可。

如需詳細資訊,請參閱 ValidationKey

子項目

無。

父項目

項目

描述

configuration

指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中需要的根項目 (Root Element)。

system.web

指定組態檔中 ASP.NET 組態設定的根項目,並包含會設定 ASP.NET Web 應用程式以及控制這些應用程式之行為的組態項目。

下列程式碼範例示範如何將 validationKeydecryptionKey 屬性都設定為 AutoGenerate isolateApps 值的指定可為伺服器上的每個應用程式產生唯一金鑰。

<machineKey 
    validationKey="AutoGenerate,IsolateApps" 
    decryptionKey="AutoGenerate,IsolateApps" 
/>

下列程式碼範例示範如何設定 validationKey 屬性和 decryptionKey 屬性,以手動產生隨機值。 validationKey 屬性在 HMACSHA256 雜湊演算法下設定為 256 位元長的金鑰,而 decryptionKey 屬性也在 AES 加密演算法下設定為可能最長的 256 位元金鑰。 這些都只能當做範例,不可實際在您的應用程式中使用。

<machineKey 
    validationKey="32E35872597989D14CC1D5D9F5B1E94238D0EE32CF10AA2D2059533DF6035F4F" 
    decryptionKey="B179091DBB2389B996A526DE8BCD7ACFDBCAB04EF1D085481C61496F693DF5F4" 
/>
Microsoft 正展開一份線上問卷調查,了解您對於 MSDN 網站的看法。 如果您選擇參加,您離開 MSDN 網站時即會顯示線上問卷調查。

您是否想要參加?
顯示:
© 2015 Microsoft