MachineKeySessionSecurityTokenHandler 類別

定義

public ref class MachineKeySessionSecurityTokenHandler : System::IdentityModel::Tokens::SessionSecurityTokenHandler

public class MachineKeySessionSecurityTokenHandler : System.IdentityModel.Tokens.SessionSecurityTokenHandler

type MachineKeySessionSecurityTokenHandler = class
    inherit SessionSecurityTokenHandler

Public Class MachineKeySessionSecurityTokenHandler
Inherits SessionSecurityTokenHandler

繼承

Object

SecurityTokenHandler

SessionSecurityTokenHandler

MachineKeySessionSecurityTokenHandler

範例

下列 XML 示範如何使用組態中的 ASP.NET <machineKey> 元素來明確指定簽署和加密密鑰。 元素 <machineKey> 是在組態檔中的 <system.web> 專案下指定。

<machineKey compatibilityMode="Framework45" decryptionKey="CC510D … 8925E6" validationKey="BEAC8 … 6A4B1DE" />  

下列 XML 示範如何將 MachineKeySessionSecurityTokenHandler 新增到權杖處理常式集合。 預設值 SessionSecurityTokenHandler 會先從集合中移除。 令牌處理程式是在 securityTokenHandlers> 元素下<設定。

<securityTokenHandlers>  
  <remove type="System.IdentityModel.Tokens.SessionSecurityTokenHandler, System.IdentityModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
  <add type="System.IdentityModel.Services.Tokens.MachineKeySessionSecurityTokenHandler, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />  
</securityTokenHandlers>  

備註

根據預設，類別 SessionSecurityTokenHandler 會使用 ProtectedDataCookieTransform 使用數據保護 API (DPAPI) 的 類別來保護會話令牌。 DPAPI 透過使用者或電腦認證來提供保護，並將金鑰資料儲存在使用者設定檔中。 這表示無法在不同的計算機上驗證或解密已簽署和加密的會話令牌。

相較之下，類別 MachineKeySessionSecurityTokenHandler 會使用 MachineKeyTransform 類別，該類別會使用組態檔中 元素中指定的 <machineKey> 密碼編譯數據來保護會話 Cookie 數據。 這表示可以在多部計算機上使用相同的密鑰 (和會話令牌) 。 當應用程式部署在 Web 伺服器陣列中時，這特別重要。 如需如何使用 Windows Identity Foundation 來保護部署在 Web 伺服器陣列中的應用程式的詳細資訊，請參閱 WIF 和 Web 伺服器數位。

設定應用程式以使用 MachineKeySessionSecurityTokenHandler，做法為將它加入到權杖處理常式集合。 如果已有這類處理常式，您必須先從權杖處理常式集合中移除 SessionSecurityTokenHandler (或任何衍生自 SessionSecurityTokenHandler 類別的處理常式)。 這是因為 MachineKeySessionSecurityTokenHandler 衍生自 SessionSecurityTokenHandler ，而且令牌處理程式集合不能包含任何指定類型的多個處理程式。

建構函式

屬性

方法

適用於

另請參閱

• SessionSecurityTokenHandler
• WIF 和 Web 伺服陣列