分享方式:


使用 TrustFrameworkPolicy 架構驗證自訂原則檔案

您可以在編輯或寫入自訂原則檔案時改善生產力,方法是在上傳檔案之前先驗證檔案。 您可以讓 Azure Active Directory B2C (Azure AD B2C) 在上傳 XML 原則檔案時驗證這些檔案,但大部分的錯誤都會導致上傳失敗。 因此,建議您在上傳自訂原則檔案之前先驗證這些檔案。 不正確原則檔案範例是格式不正確的 XML。

請務必使用良好的 XML 編輯器,例如 Visual Studio Code (VS Code)。 建議您使用 VS Code,因為它可讓您安裝 XML 延伸模組,例如 Red Hat 支援的 XML 語言。 良好的 XML 編輯器與額外的 XML 延伸模組可讓您使用色彩代碼內容、預先填入一般詞彙、讓 XML 元素編制索引,並可針對 XML 架構進行驗證。

為了驗證自訂原則檔案,我們提供自訂原則 XML 架構。 您可以使用連結 https://raw.githubusercontent.com/Azure-Samples/active-directory-b2c-custom-policy-starterpack/master/TrustFrameworkPolicy_0.3.0.0.xsd 下載架構,或使用相同的連結從編輯器參考架構。 您也可以使用適用于 VS Code 的 Azure AD B2C 擴充功能,快速流覽 Azure AD B2C 原則檔案,以及其他許多函式。 深入瞭解 適用于 VS Code 的 Azure AD B2C 擴充功能。

在本文中,您將學會如何:

  • 使用自訂原則 XML 架構來驗證原則檔案。
  • 使用適用于 VS Code 的 Azure AD B2C 擴充功能快速流覽原則檔案。

必要條件

注意

本文是 Azure Active Directory B2C 操作指南系列 中建立和執行您自己的自訂原則的一部分 。 建議您從第一篇文章開始此系列。

使用 TrustFrameworkPolicy 架構

TrustFrameworkPolicy 架構是自訂原則 XML 架構,可讓您驗證原則檔案:

  1. 在 VS Code 編輯器中安裝 Red Hat 支援的 XML 延伸模組

  2. 請遵循針對原則有效性 進行疑難排解中的 步驟,設定 VS Code 編輯器的檔案關聯。 這些指示也包含驗證原則檔案的程式。

使用 Azure AD B2C 擴充功能

Azure AD B2C 擴充功能可讓您輕鬆地瞭解原則檔案的組織。 例如,自訂原則總管可讓您查看所使用的自訂原則元素,並快速移至它們。

  1. 在 VS Code 編輯器中安裝 Azure AD B2C 擴充功能

  2. 請遵循 Azure AD B2C 擴充功能 提供的指引,瞭解如何使用 Azure AD B2C 擴充功能。

注意

社群已針對 Azure AD B2C 開發 VS Code 擴充功能,以協助身分識別開發人員。 Microsoft 不支援此延伸模組,而且會嚴格依目前提供。

下一步

接下來,瞭解: