使用自訂宣告規則的時機
您可以在 Active Directory 同盟服務 (AD FS) 中使用宣告規則語言撰寫自訂宣告規則，這就是宣告發行引擎用來以程式設計方式產生、轉換、通過和篩選宣告的架構。 藉由使用自訂規則，您可以透過比標準規則範本更複雜的邏輯來建立規則。 當您想要執行下列作業時，請考慮使用自訂規則：
根據從結構化查詢語言 (SQL) 屬性存放區中擷取的值來傳送宣告。
根據從輕量型目錄存取通訊協定 (LDAP) 屬性存放區中擷取的值，使用自訂 LDAP 篩選器來傳送宣告。
根據從自訂屬性存放區中擷取的值來傳送宣告。
僅在有兩個或更多傳入宣告存在時傳送宣告。
僅在傳入宣告值符合複雜模式時傳送宣告。
在傳入宣告值有複雜的變更時傳送宣告。
建立僅用於後續規則的宣告，而不實際傳送宣告。
從多個連入宣告的內容建構傳出宣告。
如果傳出宣告的宣告值必須以傳入宣告的值為準，但還必須包含其他內容，您也可以使用自訂規則。
宣告規則語言以規則為準。 它有條件組件和執行組件。 您可以使用宣告規則語言語法來列舉、新增、刪除或修改宣告，以符合組織的需求。 如需這些元件運作方式的詳細資訊，請參閱宣告規則語言的角色。
下列各節提供宣告規則的基本介紹。 此外也提供關於如何使用自訂宣告規則的詳細資料。
關於宣告規則
宣告規則表示商務邏輯的執行個體，將會收取傳入宣告，對其套用條件 (若 x 則 y)，然後根據條件參數產生傳出宣告。
重要
- 在 AD FS 管理嵌入式管理單元中，只能使用宣告規則範本建立宣告規則
- 宣告規則會從宣告提供者 (例如 Active Directory 或其他同盟服務) 直接處理傳入宣告，或是在宣告提供者信任上從接受轉換規則的輸出處理傳入宣告。
- 宣告規則的處理方式，是由宣告發行引擎依時間先後順序按照指定的規則集處理。 藉由設定規則優先順序，您可以進一步精簡或篩選由特定規則集內的上一個規則所產生的宣告。
- 宣告規則範本一律會要求您指定傳入宣告類型。 不過，您可以使用單一規則和同一宣告類型處理多個宣告值。
如需宣告規則和宣告規則集的詳細資訊，請參閱宣告規則的角色。 如需如何處理規則的詳細資訊，請參閱宣告引擎的角色。 如需如何處理宣告規則集的詳細資訊，請參閱宣告管線的角色。
如何建立此規則
首先，您撰寫作業所需的語法以建立此規則，方法是使用宣告規則語言，然後，在 AD FS 嵌入式管理單元中的宣告提供者信任或信賴憑證者信任的屬性上，將結果貼到「使用自訂規則傳送宣告」範本所提供的文字方塊中。
此規則範本提供以下選項：
指定宣告規則名稱
使用 AD FS 宣告規則語言，輸入一或多個選擇性的條件和發佈陳述式
如需使用此範本建立自訂規則的詳細資訊，請參閱 AD FS 部署指南中的建立規則以使用自訂規則傳送宣告。
若要進一步了解宣告規則語言的運作方式，請檢視已存在於嵌入式管理單元中之其他規則的宣告規則語言語法，只要該規則之屬性中的 [檢視規則語言] 索引標籤即可。 使用本節的資訊和此索引標籤上的語法資訊，可深入了解如何建構您自己的自訂規則。
如需如何使用宣告規則語言的詳細資訊，請參閱宣告規則語言的角色。
使用宣告規則語言
範例：如何根據使用者的名稱屬性值結合名字和姓氏
下列規則語法會結合會從給定屬性存放區中的屬性值結合名字和姓氏。 原則引擎會組成每個條件之相符項目的笛卡兒乘積。 例如，名字 {"Frank", "Alan"} 和姓氏 {"Miller", "Shen"} 的輸出是 {"Frank Miller", "Frank Shen", "Alan Miller", "Alan Shen"}：
c1:[type == "http://exampleschema/firstname" ]
&& c2:[type == "http://exampleschema/lastname",]
=> issue(type = "http://exampleschema/name", value = c1.value + " " + c2.value);
範例：如何根據使用者是否有直接報告發出管理員宣告
下列規則只會在使用者有直接報告時發出管理員宣告：
c:[type == "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name"] => add(store = "SQL Store", types = ("http://schemas.xmlsoap.org/claims/Reports"), query = "SELECT Reports FROM dbo.DirectReports WHERE UserName = {0}", param = c.value );
count([type == "http://schemas.xmlsoap.org/claims/Reports"] ) > 0 => issue(= "http://schemas.xmlsoap.org/claims/ismanager", value = "true");
範例：如何根據 LDAP 屬性發出 PPID 宣告
下列規則會根據 LDAP 屬性存放區中使用者的 windowsaccountname 和 originalissuer 屬性，發出私有的個人識別碼 (PPID) 宣告：
c:[Type == "https://schemas.microsoft.com/ws/2008/06/identity/claims/windowsaccountname"]
=> issue(store = "_OpaqueIdStore", types = ("http://schemas.xmlsoap.org/ws/2005/05/identity/claims/privatepersonalidentifier"), query = "{0};{1};{2}", param = "ppid", param = c.Value, param = c.OriginalIssuer);
可用來唯一識別此查詢之使用者的常用屬性包括：
使用者 SID
windowsaccountname
samaccountname