ClaimsAuthenticationManager 類別

定義

命名空間:

System.Security.Claims

組件:

System.IdentityModel.dll

定義宣告驗證管理員的基底實作。 宣告驗證管理員在宣告處理提供處理管線中提供一個位置，用於在執行您的應用程式程式碼之前套用處理邏輯 (篩選、驗證、延伸) 至連入主體的宣告集合。

public ref class ClaimsAuthenticationManager : System::IdentityModel::Configuration::ICustomIdentityConfiguration

public class ClaimsAuthenticationManager : System.IdentityModel.Configuration.ICustomIdentityConfiguration

type ClaimsAuthenticationManager = class
    interface ICustomIdentityConfiguration

Public Class ClaimsAuthenticationManager
Implements ICustomIdentityConfiguration

繼承

Object

ClaimsAuthenticationManager

實作

ICustomIdentityConfiguration

範例

下列程式碼顯示簡單的宣告驗證管理員，會將角色宣告新增至傳入主體，而不需對傳入宣告執行任何檢查。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;

using System.Security.Claims;

namespace MyClaimsAuthenticationManager
{
    class SimpleClaimsAuthenticatonManager : ClaimsAuthenticationManager
    {
        public override ClaimsPrincipal Authenticate(string resourceName, ClaimsPrincipal incomingPrincipal)
        {
            if (incomingPrincipal != null && incomingPrincipal.Identity.IsAuthenticated == true)
            {
                ((ClaimsIdentity)incomingPrincipal.Identity).AddClaim(new Claim(ClaimTypes.Role, "User"));
            }
            return incomingPrincipal; 
        }
    }
}

下列 XML 顯示 <claimsAuthenticationManager> 專案。

<system.identityModel>  
  <identityConfiguration>  
    <claimsAuthenticationManager type="MyClaimsAuthenticationManager.SimpleClaimsAuthenticatonManager, MyClaimsAuthenticationManager" />  

    ...  

  </identityConfiguration>  
</system.identityModel>  

備註

宣告驗證管理員會在應用程式的宣告處理管線中提供擴充點，讓您可用來驗證、篩選、修改、傳入宣告或將新的宣告插入 RP 應用程式程式碼之前所 ClaimsPrincipal 呈現的宣告集。 如果您的 RP 應用程式需要自訂實作，您甚至可以傳回 的自訂實 ClaimsPrincipal 作。 類別所提供的 ClaimsAuthenticationManager 預設實作會傳回未修改中的 ClaimsPrincipal 宣告;不過，您可以衍生自這個類別，並覆寫 Authenticate 方法來修改 (中的 ClaimsPrincipal 宣告，或傳回自訂 ClaimsPrincipal) 。

建立自訂宣告驗證管理員的一個常見原因是，根據只有 或 已知或 的資訊來新增、移除或轉換宣告，可能是由 RP 應用程式更妥善維護。 例如，購物車應用程式中客戶購買的歷程記錄可能會保留在 RP 應用程式所維護的資料基底中，然後根據傳入主體中找到的名稱宣告值，新增至宣告驗證管理員所傳回的宣告主體。

您可以透過 claimsAuthenticationManager 元素，將應用程式設定為以程式設計方式使用 ClaimsAuthenticationManager IdentityConfiguration 類別，或透過 < claimsAuthenticationManager > 元素 (，這是identityConfiguration > 元素的 < 子項目) 。 您可以覆寫 LoadCustomConfiguration 方法，以提供自訂管理員可設定之元素之 <claimsAuthenticationManager> 自訂子專案的處理。 的基底實 ClaimsAuthenticationManager 作不會處理任何子專案。

將應用程式設定為使用宣告驗證管理員，可確保從要求管線Windows Identity Foundation (WIF) 叫用它。

建構函式

ClaimsAuthenticationManager()

初始化 ClaimsAuthenticationManager 類別的新執行個體。

方法

Authenticate(String, ClaimsPrincipal)	在衍生類別中覆寫時，傳回符合 RP 應用程式需求的 ClaimsPrincipal 物件。 預設實作不會修改連入的 ClaimsPrincipal。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
LoadCustomConfiguration(XmlNodeList)	在衍生類別中覆寫時，從 XML 載入自訂組態。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)